Persistent Anwendungseinstellungen in EWS in Exchange
Erfahren Sie mehr über die verschiedenen Optionen, die Ihre verwaltete EWS-API oder EWS-Anwendung verwenden kann, um persistente benutzerdefinierte Anwendungseinstellungen in Exchange zu erstellen.
Die einfachste Möglichkeit, benutzerdefinierte Clientkonfigurationen für ein Postfach oder Ordner und Elemente in einem Postfach synchron zu halten, besteht darin, Anwendungseinstellungen auf einem Exchange-Server zu speichern. Sie können sicherstellen, dass diese Einstellungen für ein Postfach beibehalten werden, indem Sie eine der folgenden Optionen verwenden:
Benutzerkonfigurationsobjekte
Erweiterte Eigenschaften
Benutzerdefinierte Elemente
Welche Optionen habe ich zum Erstellen persistenter Anwendungseinstellungen?
Benutzerkonfigurationsobjekte sind die beste Option zum Speichern von Konfigurationseinstellungen für Ihre EWS-Clientanwendungen. Sie können auch Erweiterungseigenschaften oder benutzerdefinierte Elemente oder eine Kombination aus allen drei Elementen verwenden. Wählen Sie Ihre Option basierend auf dem Umfang Ihrer Einstellungen und davon, ob Ihre Einstellungen für andere Anwendungen verfügbar sein müssen.
Tabelle 1. Empfohlene Optionen zum Erstellen persistenter Anwendungseinstellungen basierend auf dem Bereich
| Festlegen des Bereichs | Verwendung | Zugriff von |
|---|---|---|
| Element |
Eine erweiterte Eigenschaft für ein vorhandenes Element. |
Eine beliebige EWS-Anwendung. Nur EWS-Clients, die den Eigenschaftenbezeichner kennen, können auf eine erweiterte Eigenschaft zugreifen. |
| Ordner |
Ein Benutzerkonfigurationsobjekt im Zielordner. Dies ist eine gute Möglichkeit, Ansichtseinstellungen für einen Ordner zu speichern. |
Eine beliebige EWS-Anwendung. |
| Postfach |
Ein Benutzerkonfigurationsobjekt im Standardordner msgrootfolder. |
Eine beliebige EWS-Anwendung. |
Benutzerkonfigurationsobjekte
Benutzerkonfigurationsobjekte sind spezielle Elemente, die Ordnern in einem Postfach zugeordnet sind. Benutzerkonfigurationsobjekte, auch als Ordner zugeordnete Elemente bezeichnet, sind in der Regel die beste Option zum Beibehalten von Anwendungseinstellungen, insbesondere wenn die Konfigurationsinformationen einem Ordner oder einem Postfach zugeordnet sind. Sie werden in der Regel nicht für Endbenutzer angezeigt. Da sie Datenströme und Datenwörterbücher nativ speichern können, eignen sie sich ideal zum Speichern von Konfigurationsinformationen. Die beste Möglichkeit, Benutzerkonfigurationsobjekte zu verwenden, besteht darin, eine Reihe von Konfigurationen in einem XML-Dokument zu speichern und diese Informationen dann in einer der Eigenschaften des Benutzerkonfigurationsdatenstroms zu speichern.
Auf Benutzerkonfigurationsobjekte wird anders zugegriffen als auf die anderen Elementtypen, die in einem Postfach gespeichert sind. Sie können die Folder.FindItems EWS Managed API-Methode oder den EWS-Vorgang FindItem verwenden, um alle Elemente zu finden. Sie müssen jedoch die Option Zugeordnete Suchdurchläufe verwenden, um Benutzerkonfigurationsobjekte zu finden. Der Zugeordnete Suchdurchlauf gibt an, dass die Suchergebnisse nur Benutzerkonfigurationsobjekte enthalten sollen. EWS enthält eine Reihe von Vorgängen, die spezifisch für Benutzerkonfigurationsobjekte sind.
Tabelle 1. EWS-Vorgänge und EWS Managed API-Methoden zum Arbeiten mit Benutzerkonfigurationsobjekten
| Gewünschte Aktion | Zu verwendender EWS-Vorgang | Verwenden dieser verwalteten EWS-API-Methode |
|---|---|---|
| Erstellen eines Benutzerkonfigurationsobjekts |
CreateUserConfiguration-Vorgang |
UserConfiguration.Save |
| Abrufen eines Benutzerkonfigurationsobjekts |
GetUserConfiguration-Vorgang |
UserConfiguration.Bind UserConfiguration.Load |
| Aktualisieren eines Benutzerkonfigurationsobjekts |
UpdateUserConfiguration-Vorgang |
UserConfiguration.Update |
| Löschen eines Benutzerkonfigurationsobjekts |
DeleteUserConfiguration-Vorgang |
UserConfiguration.Delete |
Hinweis
Mit EWS erstellte Benutzerkonfigurationsobjekte verfügen über ein ItemClass-Präfix , das mit "IPM. Konfiguration.". Die ItemClass eines Benutzerkonfigurationsobjekts ist das Präfix des Benutzerkonfigurationsobjekts und der Name des Benutzerkonfigurationsobjekts. Sie können die Item.ItemClass EWS Managed API-Eigenschaft oder das ItemClass EWS-Element verwenden, um nach von Ihnen definierten Benutzerkonfigurationsobjekten zu suchen.
Erweiterte Eigenschaften
Verwenden Sie erweiterte Eigenschaften , wenn Sie Konfigurationsinformationen für Elemente speichern möchten. EWS gibt im Gegensatz zur MAPI keinen Eigenschaftenbehälter für Elemente zurück. Dies bedeutet, dass ein EWS-Client den bezeichner der erweiterten Eigenschaft kennen muss, um die erweiterte Eigenschaft zu finden und darauf zuzugreifen. Wenn Sie Konfigurationsinformationen für andere Elemente als Benutzerkonfigurationsobjekte speichern müssen, kann die Verwendung erweiterter Eigenschaften zum Erstellen benutzerdefinierter Eigenschaften die Lösung für Sie sein. Erweiterte Eigenschaften ermöglichen ihnen den Zugriff auf und das Speichern von Informationen zu Eigenschaften, die nicht Teil des Standardeigenschaftensatzes für ein Element sind.
Wichtig
Das Exchange-Datenbankschema weist eine begrenzte Anzahl von Eigenschaften auf. Die maximale Anzahl von Eigenschaftsbezeichnern für eine Exchange-Datenbank beträgt 32.767. Wenn Sie erweiterte Eigenschaften verwenden, um viele Einstellungen zu speichern, empfehlen wir, dass Sie eine einzelne erweiterte Eigenschaft verwenden, um diese Einstellungen zu speichern, damit Sie dieses Maximum nicht überschreiten.
Sie können die Item.Update EWS Managed API-Methode oder den EWS-Vorgang UpdateItem verwenden, um erweiterte Eigenschaften für Benutzerkonfigurationsobjekte festzulegen.
Benutzerdefinierte Elemente
Benutzerdefinierte Elemente können auch zum Speichern von Informationen verwendet werden. Die vorhandenen Elementeigenschaften können so umfunktioniert werden, dass sie Konfigurationsinformationen enthalten. Alternativ können Sie erweiterte Eigenschaften verwenden, um ihre eigenen Eigenschaften für Ihre Anwendung zu definieren. Die Verwendung benutzerdefinierter Elemente zum Speichern der Konfiguration bietet die folgenden Vorteile:
Sie funktionieren für alle Versionen von Exchange, die EWS unterstützen.
Wenn Sie keine erweiterten Eigenschaften für das Element verwenden, wird das Budget der Exchange-Eigenschaften nicht in Rechnung gestellt.
Wo sollte ich meine Anwendungseinstellungen speichern?
Postfachordner und die darin enthaltenen Elemente befinden sich im Stammnachrichtenordner. Dieser Ordner wird durch den Wert WellKnownFolderName.msgfolderroot in der verwalteten EWS-API identifiziert. In MAPI-Begriffen entspricht dies der IPM-Unterstruktur eines Postfachs. Benutzerkonfigurationsobjekte werden häufig verwendet, um benutzeroberflächenbasierte Einstellungen zu erstellen, sodass eine Anwendung Ansichtseinstellungen basierend auf dem Ordner rendern kann, auf den ein Benutzer zugreift. Ordnerbasierte Ansichtseinstellungen werden in der Regel für ein Benutzerkonfigurationsobjekt festgelegt, das dem Ordner zugeordnet ist. Manchmal möchten Sie ihre Einstellungen jedoch global für Ihre Anwendung festlegen. In diesem Fall können Sie Ihre Einstellungen im Stammnachrichtenordner speichern.
Die meisten Benutzer sind sich dessen nicht bewusst und greifen in der Regel nicht auf den Stammpostfachordner zu. Dieser Ordner wird durch den WellKnownFolderName.root-Wert in der verwalteten EWS-API identifiziert. In MAPI-Begriffen entspricht dies der Nicht-IPM-Unterstruktur eines Postfachs. Informationen, auf die Endbenutzer nicht direkt zugreifen, werden im Stammpostfachordner gespeichert. Möglicherweise möchten Sie Ihre Anwendungseinstellung in diesem Ordner speichern, da Clientanwendungen in der Regel nicht darauf zugreifen.
Versionsunterschiede
Benutzerkonfigurationsobjekte sind auf Exchange Online, Exchange Online als Teil von Office 365 und Versionen von Exchange ab Exchange 2010 verfügbar.