Ordner und Elemente in EWS in Exchange
Erfahren Sie mehr über Ordner und Postfachelemente und deren Darstellung durch die verwaltet EWS-API oder den EWS-Client.
Ordner sind das Organisationselement eines Exchange-Postfachs. Ordner enthalten Postfachelemente, wie z. B. E-Mail-Nachrichten, Kontakte, Termine, Besprechungen und Aufgaben, und sie können auch andere Ordner beinhalten. Exchange beinhaltet verschiedene Arten von Ordnern, wobei sich die Ordnertypen jedoch ähneln. Der Hauptunterschied zwischen ihnen besteht darin, welche Art von Element sie enthalten.
Die Elemente weisen jedoch eindeutige Typen auf. Jeder Typ hat einen anderen Satz von Eigenschaften oder ein Schema, das ihn definiert. In diesem Artikel werden die Typen von Ordnern und Elementen erläutert, die zur Verfügung stehen, und wie sie sich unterscheiden.
Ordner
Ordner werden von der gleichen Basisklasse oder dem gleichen Basistyp abgeleitet: der Folder-Klasse in der verwalteten EWS-API oder dem Ordner-Typ in EWS. In der folgenden Abbildung sind die verwalteten EWS-API-Klassen und die EWS-Typen dargestellt.
Abbildung 1: Verwaltete EWS-API-Ordnerklassen und EWS-Ordnertypen
Der Hauptunterschied zwischen den Ordnerklassen und Ordnertypen besteht darin, dass Sie nur einen bestimmten Elementtyp in den einzelnen Ordnertypen erstellen können. Ein weitere Unterschied liegt darin, wie der Client die Informationen in einem Ordner anzeigt. So können Sie in Exchange zum Beispiel Termine im Kalenderordner erstellen. Sie können andere Elementtypen in den Kalenderordner verschieben, nachdem Sie sie erstellt haben, sie werden in Outlook jedoch nicht angezeigt. Outlook zeigt im Kalenderordner nur Kalenderelemente wie Termine oder Besprechungen an, auch wenn andere Elementtypen im Ordner vorhanden sind.
Tabelle 1. Verwaltete EWS-API-Ordnerklassen und EWS-Ordnertypen
| Verwaltete EWS-API-Klasse | EWS-Typ | FolderClass-Wert | Contains | Hinweise |
|---|---|---|---|---|
| Folder |
Ordner |
IPF.Note |
E-Mail-Nachrichten oder -Ordner |
Dies ist die allgemeine Ordnerklasse oder der allgemeine Typ für die folgenden WellKnownFolderName-Ordner der verwalteten EWS-API und der DistinguishedFolderId-Ordner von EWS:
|
| CalendarFolder |
CalendarFolder |
IPF.Appointment |
Termine und Besprechungen |
Wenn ein Benutzer auf eine Besprechungsanfrage antwortet, wird der Termin nur dem WellKnownFolderName.Calendar der verwalteten EWS-API oder dem DistinguishedFolderId.CalendarFolder von EWS hinzugefügt. Diese sind die einzigen Ordner, die die automatische Interaktion mit Besprechungsanfragen und -antworten unterstützen. Diese Ordnerklasse oder dieser Ordnertyp unterstützt die Verwendung von Kalenderansichten, um Termine und Besprechungen basierend auf einem Start- und Enddatum zurückzugeben. Hierzu werden die Folder.FindItem-Methode und die CalendarView-Klasse der verwalteten EWS-API oder der FindItem-Vorgang und das CalendarView-Element von EWS verwendet. |
| ContactsFolder |
ContactsFolder |
IPF.Contact |
Kontakte und Verteilerlisten |
Keine. |
| SearchFolder |
SearchFolder |
IPF.Note |
Inhalte werden durch eine Einschränkung oder einen Filter bestimmt. Suchordner enthalten keine Unterordner. |
Die Elemente, die den Suchkriterien entsprechen, sind nicht tatsächlich im Suchordner enthalten. Sie befinden sich stattdessen an anderer Stelle im Posteingang. Um sicherzustellen, dass Suchordner in Outlook verfügbar sind, erstellen Sie sie im Ordner „Finder". |
| TasksFolder |
TasksFolder |
IPF.Task |
Enthält zu erledigende Arbeitselemente. |
Keine. |
Ordnerstruktur
Ordner bieten eine Postfachstruktur. Dazu gehören die IPM-Unterstruktur, die in EWS als oberste Ebene des Informationsspeichers bezeichnet wird, wo die meisten Benutzer mit ihrem Postfach interagieren, und Systemordner, die den meisten Benutzern nie angezeigt werden und die sich in EWS in der Nicht-IPM-Unterstruktur oder Stamm befinden. Die folgende Abbildung zeigt die Ordnerstruktur für einen Benutzer und gibt an, welche Ordner Elemente des Benutzers enthalten und welche Systemordner sind.
Abbildung 2: Element- und Systemordner in einem Postfach
Bekannte Ordner
Einige der Ordner im Postfach sind spezielle Ordner. Diese entsprechen bekannten Ordnern in der verwalteten EWS-API oder definierten Ordnern in EWS. Für einige dieser Ordner gelten Einschränkungen hinsichtlich der Ordnernamen, wo sie sich in der Ordnerstruktur befinden, und ob sie gelöscht werden können. Andere allgemeine (nicht spezielle) Ordner haben nicht die gleichen Einschränkungen. Es ist wichtig, dass Sie die folgenden bekannten oder definierten Ordner kennen, da es sich hierbei um die Stammsystem-, Benutzer- und Suchordner handelt, die für die meisten Implementierungen gelten.
Tabelle 2. Primäre bekannte und definierte Ordner
| Anzeigename | WellKnownFolderName-Werte der verwalteten EWS-API | DistinguishedFolderId-Wete von EWS | Beschreibung |
|---|---|---|---|
| Stamm (Nicht-IPM-Unterstruktur) |
WellKnownFolderName.Root |
DistinguishedFolderId.root |
Enthält den Stammordner eines Postfachs, der auch als „Nicht-IPM-Unterstruktur" bezeichnet wird. Dieser Ordner hat kein übergeordnetes Element, und Sie können ihn nicht verschieben, kopieren, umbenennen oder löschen. Jeder Nachrichtenspeicher enthält nur einen Stammordner. |
| Oberste Ebene des Informationsspeichers (IPM-Unterstruktur) |
WellKnownFolderName.MsgFolderRoot |
DistinguishedFolderId.msgfolderroot |
Enthält den Posteingang und andere Benutzerordner. |
| Finder (Suchordner) |
WellKnownFolderName.SearchFolders |
DistinguishedFolderId.searchfolders. |
Enthält die in Outlook sichtbaren Suchordner. |
Eine vollständige Liste der WellKnownFolderName-Eigenschaftenwerte der verwalteten EWS-API finden Sie in der WellKnownFolderName-Enumeration. Eine vollständige Liste der DistinguishedFolderId-Werte in EWS finden Sie unter DistinguishedFolderId.
Ordnereigenschaften
In der verwalteten EWS-API werden alle Ordnereigenschaften von der Folder-Basisklasse abgeleitet. And in EWS, all folders use the folder elements that are available on the Ordner type. Most of the folder-related properties and elements are straightforward (parent folder ID, display name, and so on), but a few require a little more explanation.
Die folgenden Bedingungen gelten für die Folder.FolderClass-Eigenschaft der verwalteten EWS-API oder das FolderClass-Element in EWS:
Wenn festgelegt, muss der Wert der Eigenschaft oder des Elements mit der abgeleiteten Klassen oder dem Typ des Ordners übereinstimmen. So kann die FolderClass -Eigenschaft oder das Element nicht angeben, dass es sich bei dem Ordner um einen Kontaktordner handelt, während die Klasse oder der Typ des Ordners angibt, dass es sich um einen Kalenderordner handelt.
Sie können entweder Ordner erstellen, die einen bestimmten Typ haben, ohne die FolderClass -Eigenschaft oder das Element festzulegen, oder Sie können einen allgemeinen Ordnertyp erstellen und die FolderClass -Eigenschaft oder das Element festlegen. Mit beiden Optionen erzielen Sie das gleiche Ergebnis.
Nachdem Sie den FolderClass-Wert durch Erstellen eines bestimmten Ordnertyps oder durch Festlegen der FolderClass-Eigenschaft oder des Elements selbst festgelegt haben, können Sie ihn nicht mehr ändern. Beispielsweise können Sie eine IPF nicht ändern. Notieren Sie den Ordner für einen IPF. Kontaktordner. Sie können ihn jedoch in einen IPF ändern. Note.Contoso-Ordner.
Jeder FolderClass -Wert, der nicht eines der vordefinierten Präfixe verwendet, wird als ein IPF.Note-Ordner behandelt. So wird ein FolderClass -Wert der IAmAFolderClass als ein IPF.Note-Ordner behandelt.
Der Ordnerklassenwert ist erweiterbar. Dies bedeutet, dass die in Tabelle 1 aufgeführten FolderClass -Standardwerte als Präfixe behandelt werden und Sie benutzerdefinierte Werte hinzufügen können. Sie können beispielsweise einen Ordner mit dem FolderClass -Wert IPF.Contact.Contoso erstellen, und dieser wird dann als Kontaktordner behandelt.
Sie können festlegen, welche Berechtigungen der Client für die Ordner hat, zum Beispiel Löschen, Lesen und Ändern, indem Sie die Folder.EffectiveRights-Eigenschaft der verwalteten EWS-API oder das EffectiveRights-Element in EWS verwenden.
Öffentliche Ordner
Öffentliche Ordner ermöglichen den gemeinsamen Zugriff und stellen ein einfaches und effektives Mittel zum Erfassen, Organisieren und Freigeben von Informationen für andere Personen in der Arbeitsgruppe oder Organisation dar. Sie können öffentliche Ordner auch zum Archivieren von Verteilergruppeninhalt verwenden. Ausführliche Informationen über öffentliche Ordner finden Sie unter Zugriff auf Öffentliche Ordner mit EWS in Exchange.
Ausgeblendete Ordner
Alle Ordner, die Exchange im Stamm des Postfachs erstellt, sind ausgeblendet. Sie können die verwaltete EWS-API oder EWS verwenden, um weitere Ordner auf der obersten Ebene des Informationsspeichers auszublenden. Weitere Informationen zu ausgeblendeten Ordnern finden Sie unter Arbeiten mit ausgeblendeten Ordnern mit EWS in Exchange.
Suchordner
Suchordner sind genau wie reguläre Ordner, mit der Ausnahme, dass sie über eine Eigenschaft oder ein Element verfügen, das den Suchfilter definiert. Sie können Suchordner in einem beliebigen Ordner in einem Exchange-Postfach erstellen und auf die gleiche Weise erstellen, wie Sie andere Ordner erstellen. Damit jedoch ein Suchordner in Outlook, Outlook Web App oder Outlook Live angezeigt wird, müssen sich SearchFolder-Objekte, die Sie mit der verwalteten EWS-API erstellen, im Ordner WellKnownFolderName.SearchFolders befinden, und SearchFolder-Typen, die Sie mit EWS erstellen, müssen sich im Ordner DistinguishedFolderId.SearchFolders befinden. Wenn der Suchordner an einem anderen Speicherort erstellt wird, ist er weiterhin verfügbar, und Sie können ihn in benutzerdefinierten Clientanwendungen anzeigen.
Elemente
EWS in Exchange verwendet Items, die E-Mail-Nachrichten, Termine, Besprechungen, Kontakte, Verteilerlisten, Aufgaben, Posts und andere Elemente in einer Mailbox darstellen. Items haben entweder eine starke Typisierung, was bedeutet, dass ihnen eine spezifische Klasse oder ein Schema zugewiesen ist, oder eine nicht starke Typisierung, wobei sie dann als generische Items bezeichnet werden. Generische Items sind Item-Objekte in der verwalteten EWS-API und Item-Typen in EWS. Häufige Items wie E-Mail-Nachrichten, Kontakte, Verteilerlisten, Posts und Aufgaben haben eine starke Typisierung, und Sie können bestimmte Schemaeigenschaften oder -elemente dafür festlegen.
Tabelle 3. Stark typisierten Elemente
| Verwalteter EWS-API-Elementtyp | EWS-Item-Element |
|---|---|
| Appointment |
CalendarItem |
| Contact |
Contact |
| ContactGroup |
DistributionList |
| EmailMessage |
Message |
| PostItem |
PostItem |
| Task |
Task |
Stark typisierte Items der verwalteten EWS-API werden von der Item-Basisklasse abgeleitet. Sie arbeiten jedoch im Allgemeinen mit einem der in Tabelle 3 aufgeführten abgeleiteten Typen, und nicht mit der Item -Klasse direkt. Wenn Sie die ItemCollection-Klasse verwenden, arbeiten Sie jedoch möglicherweise direkt mit Instanzen der Item -Klasse. In diesem Fall sollten Sie Logik implementieren, die den Typ des Elements im Store festlegt, den die Instanz in der Item -Klasse darstellt. Um mit diesem Item arbeiten zu können, müssen Sie eine Bindung zu dem Item herstellen, indem Sie eine Instanz der Klasse verwenden, die das Item darstellt.
Items in Ordnern
Bei einigen Ordnern gelten Einschränkungen für die Typen von Items, die sie beinhalten können. Hierbei handelt es sich Einschränkungen, die die Exchange-Postfachdatenbank auf Ordner anwendet, nicht um Einschränkungen der Clientansicht.
Tabelle 4. Item-Einschränkungen für Ordner
| Verwaltete EWS-API-Ordnerklasse | EWS-Ordnertyp | Einschränkung |
|---|---|---|
| Base Folder-Klasse |
Ordner |
Sie können nur neue EWS Managed API EmailMessage-Objekte und PostItem-Objekte oder EWS-Nachrichtentypen oder PostItem-Typen in den generischen Ordnern erstellen. Sie können andere Elementtypen in generische Ordner verschieben, aber der Client zeigt sie möglicherweise nicht an. |
| CalendarFolder |
CalendarFolder |
Sie können nur neue Appointment-Objekte der verwalteten EWS-API und CalendarItem-Typen in EWS im Kalenderordner erstellen. Sie können andere Item-Typen in den Kalenderordner verschieben, wobei der Client diese möglicherweise jedoch nicht anzeigen kann. |
| ContactsFolder |
ContactsFolder |
Sie können nur neue Contact-Objekte und ContactGroupObjekte der verwalteten EWS-API oder Contact-Typen oder DistributionList-Typen in EWS im Kontaktordner erstellen. Sie können andere Item-Typen in den Kontaktordner verschieben, wobei der Client diese möglicherweise jedoch nicht anzeigen kann. |
| SearchFolder |
SearchFolder |
Keine Einschränkungen. Elemente befinden sich nicht tatsächlich im Ordner "Suche". sie befinden sich an einer anderen Stelle im Postfach. |
| TasksFolder |
TasksFolder |
Sie können nur neue Task-Objekte der verwalteten EWS-API oder Task-Typen in EWS im Aufgabenordner erstellen. Sie können andere Item-Typen in den Aufgabenordner verschieben, wobei der Client diese möglicherweise jedoch nicht anzeigen kann. |
Aktualisieren von früheren Produktversionen
Ordner haben sich in früheren und in den aktuellen Produktversionen kaum geändert. Beachten Sie jedoch, dass frühere Versionen von Exchange verwaltete Ordner verwenden, um die Messaging-Datensatzverwaltung (MRM) durchzuführen. Exchange Online, Exchange Online als Teil von Office 365 und Exchange-Versionen ab Exchange 2013 verwenden Aufbewahrungsrichtlinien für MRM. Sie können verwaltete Ordner für die Verwendung von Aufbewahrungsrichtlinien aktualisieren.
Items wurden in früheren und aktuellen Produktversionen nicht geändert.
Inhalt dieses Abschnitts
Arbeiten mit ausgeblendeten Ordnern mithilfe von EWS in Exchange
Arbeiten mit Exchange-Postfachelementen mithilfe von EWS in Exchange
Exportieren und Importieren von Elementen mithilfe von EWS in Exchange
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für