Zugriff auf Öffentliche Ordner mit EWS in Exchange
Erfahren Sie, wie Sie EWS und die EWS Managed API zum Zugriff auf öffentliche Ordner und Weiterleiten von Anforderungen für öffentliche Ordner in Exchange verwenden können.
Öffentliche Ordner dienen als freigegebene Repositories für Elemente, auf die Benutzer in Ihrer Organisation zugreifen können. Mit Office 365, Exchange Online und lokalen Versionen von Exchange ab Exchange 2013 wird eine neue Architektur für öffentliche Ordner eingeführt. Öffentliche Ordner in Exchange verwenden ein spezielles Postfachdesign (anstelle einer Öffentliche Ordner-Datenbank), um die Hierarchie und Inhalte von öffentlichen Ordnern zu speichern. Die Berechtigungen für öffentliche Ordner werden über die rollenbasierte Zugriffssteuerung (RBAC) verwaltet.
Clientzugriffstechnologien, wie Exchange-Webdienste (EWS) und die EWS Managed API ermöglichen den programmgesteuerten Zugriff auf die Öffentliche Ordner-Hierarchie und die Elemente in einer Öffentliche Ordner-Datenbank. Dieser Artikel enthält Informationen darüber, wie Sie mit EWS und der EWS Managed API auf öffentliche Ordner und Daten in öffentlichen Ordnern zugreifen können.
EWS-Vorgänge und EWS Managed API-Methoden für den Zugriff auf öffentliche Ordner
Die meisten der wichtigen EWS-Vorgänge unterstützen den Zugriff auf öffentliche Ordner. Sie können die in der folgenden Tabelle aufgeführten Ordner- und Datei-Vorgänge sowie EWS Managed API-Methoden zum Arbeiten mit öffentlichen Ordnern verwenden.
Weitere Informationen über EWS Managed API-Methoden finden Sie unter EWS Managed API-Namespaces.
| EWS-Vorgang | EWS Managed API-Methode |
|---|---|
|
CreateFolder-Vorgang |
Folder.Save() |
|
UpdateFolder-Vorgang |
Folder.Update() |
|
DeleteFolder-Vorgang |
Folder.Delete() |
|
MoveFolder-Vorgang1 |
Folder.Move() |
|
CopyFolder-Vorgang2 |
Folder.Copy() |
|
GetFolder-Vorgang |
Folder.Bind() |
|
EmptyFolder-Vorgang3 |
Folder.Empty-Methode |
|
FindFolder-Vorgang |
ExchangeService.FindFolders() Folder.FindFolders() |
|
CreateItem-Vorgang |
Item.Save() |
|
MoveItem-Vorgang |
Item.Move() |
|
CopyItem-Vorgang |
Item.Copy() |
|
UpdateItem-Vorgang |
Item.Update() |
|
DeleteItem-Operation |
Item.Delete() |
|
FindItem-Vorgang4 |
ExchangeService.FindItems() Folder.FindItems() |
|
GetItem-Vorgang |
Item.Bind() |
|
ConvertId-Vorgang5 |
ExchangeService.ConvertId() ExchangeService.ConvertIds() |
1Das Verschieben von Ordnern zwischen öffentlichen und privaten Ordnern wird ab Exchange 2013 nicht mehr unterstützt.
2Dieser Vorgang gilt nur für öffentliche Ordner in Exchange Server 2007 und Exchange Server 2010.
3Dieser Vorgang gilt nur für öffentliche Ordner in Exchange 2010.
4Die indizierte Volltextsuche innerhalb eines einzelnen öffentlichen Ordners mithilfe der Suchoption QueryString wird erst ab Exchange 2013 unterstützt.
5Der Vorgang ConvertId konvertiert IDs von öffentlichen Ordnern nicht ordnungsgemäß von einer EWS-ID in eine Speicher-ID. Zur Problemumgehung können Sie die zurückgegebene Kennung manuell anpassen.
Die folgenden Vorgänge werden für öffentliche Ordner ab Exchange 2013 nicht oder nur teilweise unterstützt:
CopyFolder (nicht unterstützt). Sie können die Funktionalität des CopyFolder-Vorgangs mit CreateFolder in Verbindung mit dem CopyItems-Vorgang abbilden.
EmptyFolder (nicht unterstützt). Sie können die Funktionalität des EmptyFolder-Vorgangs mit FindItem in Verbindung mit dem DeleteItem-Vorgang abbilden.
MoveFolder (teilweise unterstützt). Sie können Ordner nicht zwischen privaten und öffentlichen Ordner verschieben. Sie können Ordner zwischen privaten und öffentlichen Ordnern in Exchange 2007 und Exchange 2010 verschieben. Sie können Ordner zwischen öffentlichen Ordner in allen Versionen von Exchange verschieben.
Folgende Funktionen für öffentliche Ordner werden mit EWS und der EWS Managed API nicht unterstützt:
Verwendung von SyncFolderHierarchy. Verwenden Sie die Vorgänge FindFolder, GetFolder, FindItem und GetItem , um Elemente und Ordner in einem Postfach für öffentliche Ordner zu synchronisieren.
Tiefensuche in einer Öffentliche Ordner-Hierarchie. Verwenden Sie rekursive FindFolder-Vorgangsaufrufe zum Durchlaufen einer Öffentliche Ordner-Hierarchie.
Erstellen einer Öffentliche Ordner-Hierarchie mit dem CreateFolderPath-Vorgang. Verwenden Sie bei einem Postfach für öffentliche Ordner als Ziel den CreateFolder-Vorgang für jede Ordnerebene in einer bestimmten Ordnerhierarchie.
Speichern von Kopien gesendeter E-Mails mit dem CreateItem-Vorgang. Verwenden Sie stattdessen den MoveItem-Vorgang zum Verschieben einer Nachricht in einen öffentlichen Ordner.
Anwendungszenarien für EWS und die EWS Managed API mit öffentlichen Ordnern
Öffentliche Ordner ermöglichen viele wichtige Szenarien für Benutzer von Exchange-Postfächern. Sie können Ihre Benutzer mit EWS und der EWS Managed API unterstützen, indem Sie benutzerdefinierte Lösungen für den Zugriff auf und die Verwendung von öffentlichen Ordnern und deren Inhalten implementieren.
Programmgesteuertes Zugreifen auf E-Mail-Nachrichten, die an Verteilerlisten gesendet wurden
Benutzer von Exchange-Postfächern können öffentliche Ordner zum Speichern von E-Mail-Nachrichten an Verteilerlisten nutzen. So kann der Verteilerlistenverlauf bequem hinterlegt werden. Der Zugriff auf gespeicherte E-Mails an Verteilerlisten ist in EWS mit dem FindItem-Vorgang oder in der EWS Managed API mit den Methoden ExchangeService.FindItems() und Folder.FindItems() möglich.
Freigeben von wichtigen E-Mail-Nachrichten und anderen Postfachelementen
Benutzer von Postfächern können öffentliche Ordner als freigegebenes Repository für Postfachelemente verwenden. Verschiedene Benutzer innerhalb einer Organisation können wichtige E-Mail-Nachrichten oder Kontakte mit öffentlichen Ordnern teilen. Über EWS kann auf diese freigegebenen Postfachelemente zugegriffen werden. Sie können E-Mail-Nachrichten, Kontakte und andere Postfachelemente in EWS mit dem MoveItem Operation und in der EWS Managed API mit der Item.Move() -Methode in einen öffentlichen Ordner verschieben oder daraus entfernen.
Öffentliche Diskussionen mit Bereitstellungselementen
Öffentliche Ordner sind ein praktischer Container für Bereitstellungselemente. Mit Bereitstellungselementen können Gesprächsverläufe ohne das Versenden von E-Mail-Nachrichten zwischen den Benutzern geführt werden. Benutzer können mit öffentlichen Ordnern und Bereitstellungselementen Gesprächsverläufe zwischen verschiedenen Postfachbenutzern innerhalb einer Organisation hosten und verwalten. Dadurch können Postfachbenutzer auf dem freigegebenen Gesprächsverlauf mit Bereitstellungselementen zugreifen, selbst wenn sie nicht Teilnehmer der Konversation sind. Sie können in EWS mit dem CreateItem Operation und in der EWS Managed API mit der Item.Save() -Methode Bereitstellungselemente erstellen und auf im öffentlichen Ordner gespeicherte Elemente antworten.
Weiterleiten von Anforderungen für Öffentliche Ordner
Der Inhalte öffentlicher Ordner kann auf mehreren Postfachservern gespeichert werden. Die Öffentliche Ordner-Hierarchie kann in einem Postfach gespeichert werden, während der Inhalt des öffentlichen Ordners in einem anderen Postfach abgelegt ist. Dabei muss es sich außerdem nicht um den Postfachserver des Benutzers handeln, der die Informationen anfordert. In einem solchen Fall ist es besonders wichtig, zum Erhalt zutreffender Informationen zu öffentlichen Ordnern die optionalen Kopfzeilen X-AnchorMailbox und X-PublicFolderMailbox zur Ordneranforderung hinzuzufügen.
Der Wert für X-AnchorMailbox und X-PublicFolderMailbox kann sich unterscheiden, je nachdem, ob Sie eine Anforderung im Zusammenhang mit der Ordnerhierarchie oder dem Ordnerinhalt ausführen. In der folgenden Tabelle wird angegeben, welche Prozedur für die einzelnen EWS Managed API-Methoden oder EWS-Vorgänge zu befolgen ist.
EWS Managed API-Methoden und EWS-Vorgänge zum Weiterleiten von Anforderungen für öffentliche Ordner
| Beim Aufrufen dieser Methoden | Beim Aufrufen dieser Vorgänge | Verwenden Sie dieses Verfahren |
|---|---|---|
|
Folder.FindFolders Folder.Delete Folder.Update Folder.Move |
CreateFolder FindFolder DeleteFolder UpdateFolder MoveFolder |
Weiterleiten von Anforderungen für Öffentliche Ordner-Hierarchien |
|
Item.Bind Item.Update Item.Copy Item.Move Item.Delete Folder.Bind Folder.FindItems |
CreateItem GetItem UpdateItem CopyItem MoveItem DeleteItem GetFolder FindItem |
Weiterleiten von Anforderungen für Inhalte öffentlicher Ordner |
Versionsunterschiede
In Exchange 2007 und Exchange 2010 funktioniert der ConvertId-Vorgang bei der Konvertierung von IDs öffentlicher Ordner von EWS-IDs in Speicher-IDs ordnungsgemäß.