Exportieren und Importieren von Elementen mit EWS in Exchange

  • Artikel

Hier erhalten Sie Informationen über das Exportieren und Importieren von Terminen, E-Mails, Kontakten Aufgaben und anderen Postfachelementen mithilfe der verwalteten EWS-API oder mit EWS in Exchange.

Exchange ist eine äußerst wichtige Quelle zahlreicher Informationen: E-Mails, Kontakte, Aufgaben und Kalender sind Kernelemente der Geschäftstätigkeit einer Organisation. Mit EWS können Sie wichtige Elementtypen anhand von drei verschiedenen Vorgehensweisen exportieren und importieren:

  • Austauschen von Elementtypen: Wir empfehlen diese Vorgehensweise zum Importieren und Exportieren von Elementen in bzw. aus anderen Systemen und Dateien.

  • Funktion auf Elementebene (nur EWS). Wir empfehlen diese Option zum Exportieren oder Kopieren von einem Exchange-Server oder -Postfach und zum Importieren in ein anderes.

  • MIME-Streams in Form gängiger Standarddateiformate wie iCalendar und vCard. Da der Eigenschaftensatz begrenzt ist und die MIME-Konvertierung kostspielig ist, empfehlen wir den Ansatz nur für das Importieren oder Exportieren einer kleinen Datenmenge.

Wichtig

[!WICHTIG] EWS ist nicht für die Sicherung und Wiederherstellung von Postfächern vorgesehen. Verwenden Sie zum Sichern und Wiederherstellen von Datenbanken die Sicherungs- und Wiederherstellungs-API. Siehe auch Sicherung, Wiederherstellung und Notfallwiederherstellung auf TechNet.

Tabelle 1. Exportieren und Importieren von Kontakt-, E-Mail- und Kalenderelementen

Aufgabe EWS Managed API-Methode EWS-Vorgang Hinweise
Exportieren einer Kopie eines Kontakt-, E-Mail-, Aufgaben- oder Kalenderelements mit einem angegebenen Eigenschaftensatz.
Contact.Bind
EmailMessage.Bind
Appointment.Bind
Task.Bind
GetItem
Diese Option wird empfohlen, wenn Sie Postfachelemente in ein anderes Nicht-Exchange-System oder eine Datei exportieren (einschließlich vCard- und iCal-Typen).
Da Sie die Kontrolle über den exportierten Eigenschaftensatz haben und die Leistung für den Exchange-Server besser ist, ist dies im Allgemeinen die beste Option.

Abhängig von dem für ein Postfachelement festgelegten Eigenschaftensatz und abhängig davon, ob Ihre Anwendung alle der nicht schematisierten Eigenschaftenbezeichner erkennt (erweiterte Eigenschaften), die eventuell für ein Element festgelegt sind, wird mit dieser Option möglicherweise keine originalgetreue Kopie erstellt.

Diese Methoden und dieser Vorgang stellen den schematisierten Eigenschaftensatz für ein Element sowie die angeforderten erweiterten Eigenschaften bereit.
Die Bind-Methode oder der GetItem-Vorgang kann nur dann einen originalgetreuen Export von Elementen bereitstellen, wenn Sie die erweiterten Eigenschaften eines Elements kennen.
Sie können alle bekannten erweiterten Eigenschaften anfordern, um die volle Vertrauenswürdigkeit zu aktivieren.

TIPP: Sie können die Ablaufverfolgungsfunktion in der verwalteten EWS-API verwenden, um eine XML-Darstellung der exportierten Elemente zu erhalten. Weitere Informationen finden Sie unter Exportieren eines Elements in ein benutzerdefiniertes Format.
Importieren einer Kopie eines Kontakt-, E-Mail-, Aufgaben- oder Kalenderelements mit einem angegebenen Eigenschaftensatz.
Contact.Save
EmailMessage.Save
Appointment.Save
Task.Save
CreateItem
Wir empfehlen diese Option zum Importieren von Postfachelementen in Exchange.
Sie müssen für einige Elementtypen möglicherweise spezielle Eigenschaften festlegen, um den Status des importierten Elements beizubehalten.
Da einige der Eigenschaften nur von Exchange und nicht von den Clients festgelegt werden, ist ein Import mit vollständiger Originaltreue nicht immer möglich.

Sie können zum Beispiel keine Besprechung mit Teilnehmern in ein Postfach importieren, da Exchange die Beziehungen zwischen dem Organisator und den Teilnehmern festlegt.
Diese Beziehung kann nur von Organisatoren, die die Besprechungsanforderung senden, und von Teilnehmern, die die sie empfangen und darauf antworten, hergestellt werden.

Appointment-Objekte in Exchange können über komplexe Beziehungen und Einstellungen verfügen.
Termine mit Teilnehmern (Besprechungen) haben Einstellungen, die eine Verknüpfung mit dem Besprechungsorganisator und den Besprechungsteilnehmern herstellen.
Diese Einstellungen werden beim Exportieren und Importieren von Terminen nicht beibehalten.
Die programmatische Wiederherstellung der Beziehungen zwischen Organisator und Teilnehmer direkt in den Terminen wird nicht unterstützt.
Eine Möglichkeit zum Wiederherstellen dieser Beziehungen ist, eine Nachbearbeitung nach dem Importieren durchzuführen und den Organisator dann zu veranlassen, die Besprechungen neu zu senden, sowie die Teilnehmer zu bitten, die Besprechungen erneut zu akzeptieren.
Sie können den Exchange-Identitätswechsel verwenden, um die Aufrufe für den Organisator und die Teilnehmer durchzuführen.
Sie müssen die UID-Eigenschaft des Appointment-Objekts vor dem Importieren ändern, damit Besprechungen nicht fälschlich anderen Besprechungen in einem Postfach zugeordnet werden.
Exportieren einer Kopie eines Kontakt-, E-Mail-, Aufgaben- oder Kalenderelements mit vollständiger Originaltreue
Nicht zutreffend
 ExportItems
Dies ist die beste Option zum Exportieren von Postfachelementen, die Sie wieder in ein Exchange-Postfach importieren möchten.
Mit dieser Option können Sie Elemente auch zwischen Postfächern kopieren.

Der ExportItems-Vorgang stellt einen opaken Stream bereit, mit dem Sie Informationen zwischen Postfächern verschieben können.
Sie können ExportItems mit dem GetItem-Vorgang verwenden, um einen Index zum Suchen der Elemente in einem anderem System zu erstellen.
Sie können den Exportstream nicht ändern.
Weitere Informationen finden Sie unter Exportieren von Elementen mit vollständiger Originaltreue.
Importieren einer Kopie eines Kontakt-, E-Mail-, Aufgaben- oder Kalenderelements mit vollständiger Originaltreue
Nicht zutreffend
 UploadItems
Dies ist die einziege Option zum Importieren von Elementen, die vom ExportItems -Vorgang exportiert wurden.
Exportieren einer Kopie eines Kontakt-, E-Mail- oder Kalenderelements als MIME-Stream für einen allgemeinen Dateityp
Contact.Bind
EmailMessage.Bind
Appointment.Bind
GetItem
Sie können die MimeContent-Eigenschaft verwenden, um die MIME-Streamdarstellung eines Elements zu erhalten.

Hierdurch wird eine grundlegende Teilmenge aller Eigenschaften eines Elements bereitgestellt.
Die bewährte Vorgehensweise ist, den MIME-Stream nur für einmalige Vorgänge zu verwenden.
Verlassen Sie sich beim häufigen Importieren/Exportieren von Elementen oder einer großen Menge von Elementen nicht auf MIME, da Exchange für MIME eine Inhaltskonvertierung durchführt, und dies kann die Leistung beeinträchtigen.

Der Contact-MIME-Stream ist eine vCard-Datei (.vcf).
Abhängig von den für einen Kontakt festgelegten Eigenschaften wird hierdurch möglicherweise keine vollständig originalgetreue Kopie erstellt.
Beachten Sie, dass Sie mit dem vCard-MIME-Stream keinen Kontakt importieren können.
Weitere Informationen finden Sie unter Exportieren von Kontakten in eine vCard-Datei.

Der EmailMessage-MIME-Stream ist eine EML-Datei.
Das EML-Format wird von Outlook und anderen E-Mail-Clients erkannt.
Sie können mit dem MIME-Stream auch eine MHT-Datei erstellen, die von vielen Browsern verwendet werden kann.
EWS stellt keinen MSG-Dateistream zum Exportieren einer E-Mail in das MSG-Dateiformat bereit.
Sie haben die Möglichkeit, eine MSG-Datei zu exportieren, indem Sie entweder eine MSG-Datei konstruieren, und zwar anhand der Ergebnisse einer EmailMessage.Bind-Methode oder eines GetItem -Vorgangsaufrufs, oder indem Sie eine Drittanbieter-API verwenden, die EWS aufruft und die MSG-Datei aus den Ergebnissen konstruiert.
Weitere Informationen erhalten Sie unter Exportieren einer E-Mail als EML-Datei.

Der Appointment-MIME-Stream ist eine iCal-Datei (.ics).
Das ICS-Format wird von Outlook und anderen E-Mail-Clients erkannt.
Dies ist jedoch keine geeignete Option zum Exportieren von Besprechungen, da die Teilnehmerinformationen nicht im MIME-Stream bereitgestellt werden.
Anlagen und andere Eigenschaften werden möglicherweise nicht in den MIME-Stream einbezogen.
Sie sollten das iCal-Format entweder aus dem Termin-Objekt oder aus dem XML erstellen, der vom GetItem-Vorgang zurückgegeben wird.
Auf diese Weise können Sie mehr der Exchange-Eigenschaften mit erweiterten Eigenschaften („X-"-Eigenschaften) in der iCal-Datei erfassen.
Sie können außerdem einen Termin im XML-Format exportieren.
Rufen Sie den GetItem-Vorgang auf, und speichern Sie das XML in Ihrem System.
Sie können auch die Ablaufverfolgung in der verwalteten EWS-API verwenden, um XML zu erfassen und in einer XML-Datenbank zu speichern.
Weitere Informationen erhalten Sie unter Exportieren von Terminen als iCal-Dateien.
Importieren einer Kopie eines E-Mail- oder Kalenderelements als MIME-Stream für einen allgemeinen Dateityp
EmailMessage.Save
Appointment.Save
CreateItem
Sie können eine EML- oder ICS-Datei anhand der MimeContent-Eigenschaft eines EmailMessage- oder Appointment-Objekts importieren.
Sie müssen die erweiterte Eigenschaft PidTagMessageFlags (0x0E07) festlegen, wenn die E-Mail kein Entwurf ist.

Diese Vorgehensweise kann nicht zum Importieren von Besprechungen verwendet werden.

Alternativen zum Exportieren und Importieren von Elementen mit EWS

Es stehen weitere Optionen zum Verfügbarmachen und Importieren von Elementen in und aus einem Exchange-Postfach zur Verfügung. Im Folgenden finden Sie einige Ideen, die Sie beim Entwerfen Ihrer Import- und Exportstrategie berücksichtigen sollten:

Inhalt dieses Abschnitts

Siehe auch