openTypeExtension-Ressourcentyp (offene Erweiterungen)

Artikel
07/02/2022
2 Minuten Lesedauer

Namespace: microsoft.graph

Stellt offene Erweiterungen (früher bekannt als Office 365-Datenerweiterungen) dar, eine Erweiterungsoption, die eine einfache Möglichkeit bietet, nicht typisierte Eigenschaften direkt zu einer Ressource in Microsoft Graph hinzuzufügen.

Jede geöffnete Erweiterung, die einer Ressource hinzugefügt wird, wird in der Navigationseigenschaft Erweiterungen angezeigt. Jede Erweiterung weist eine extensionName-Eigenschaft auf, die die einzige vordefinierte, schreibbare Eigenschaft für alle Erweiterungen zusammen mit ihren benutzerdefinierten Daten ist. Um sicherzustellen, dass Erweiterungsnamen eindeutig sind, können Sie eine umgekehrtes DNS-Format (Domain Name System) verwenden, das von Ihrer eigenen Domäne, z. B. com.contoso.ContactInfo, abhängig ist. Verwenden Sie nicht die Microsoft-Domäne (com.microsoft oder com.onmicrosoft) in einem Erweiterungsnamen.

Wird vom abstrakten Typ der Erweiterung abgeleitet.

Offene Erweiterungen werden von den folgenden Ressourcen unterstützt.

user
Gruppe

contact
device
Ereignis für Benutzer- und Gruppenkalender
message
organization
post
todoTask
todoTaskList

Hinweis: * Aufgrund einer bestehenden Dienstbeschränkung können Stellvertretungen keine offenen, an Erweiterungen angehängten Ereignisse in freigegebenen Postfachkalendern erstellen. Versuche, dies zu tun, führen zu einer ErrorAccessDenied Antwort.

Weitere Informationen zur Erweiterbarkeit von Microsoft Graph, einschließlich Beschränkungen für offene Erweiterungen, finden Sie unter Hinzufügen benutzerdefinierter Eigenschaften zu Ressourcen mithilfe von Erweiterungen und Hinzufügen benutzerdefinierter Daten zu Benutzern mithilfe offener Erweiterungen.

Outlook-spezifische Aspekte

Jede auf einer Outlook-Ressource (Ereignis, Nachricht oder persönlicher Kontakt) vorhandene offene Erweiterung ist in einer Eigenschaft namens MAPI gespeichert. Wenn Sie offene Erweiterungen für Outlook erstellen, bedenken Sie, dass mit MAPI benannte Eigenschaften eine endliche Ressource im Postfach eines Benutzers darstellen. Wenn das Kontingent für benannte Eigenschaften eines Benutzers aufgebraucht ist, können nicht Sie keine weiteren benannten Eigenschaften für diesen Benutzer erstellen. Dies kann zu unerwartetem Verhalten von Clients führen, die für ihre Funktionalität auf benannte Eigenschaften angewiesen sind.

Wenden Sie die folgenden Richtlinien an, wenn Sie offene Erweiterungen in Outlook-Ressourcen erstellen:

Erstellen Sie die minimal erforderliche Anzahl von Erweiterungen. Die meisten Anwendungen sollten nicht mehr als eine Erweiterung erfordern. Erweiterungen verfügen über keine fest definierten Eigenschaften oder Strukturen, somit können Sie in einer einzelnen Erweiterung mehrere Werte speichern.
Vermeiden Sie es, Erweiterungen auf eine variable Weise zu benennen (z. B. basierend auf der Benutzereingabe usw.). Jedes Mal, wenn eine offene Erweiterung mit einem neuen Namen erstellt wird, der zuvor noch nicht im Postfach des Benutzers verwendet wurde, wird eine neue Eigenschaft namens MAPI erstellt. Durch das Entfernen der Erweiterung wird die benannte Eigenschaft nicht entfernt.

Sollen offene Erweiterungen (für Outlook-Ressourcen) oder erweiterte Eigenschaften verwendet werden?

Offene Erweiterungen sind die empfohlene Lösung für die meisten Szenarien, die das Speichern und den Zugriff auf benutzerdefinierte Daten beinhalten. Wenn Sie jedoch auf benutzerdefinierte Daten für Outlook MAPI-Eigenschaften zugreifen müssen, die nicht bereits über dieMicrosoft Graph API-Metadaten verfügbar sind, können Sieerweiterte Eigenschaften und deren REST-API verwenden. Unterhttps://graph.microsoft.com/v1.0/$metadata können Sie überprüfen, welche Eigenschaften die Metadaten offenlegen.

Methoden

Methode	Rückgabetyp	Beschreibung
Create	openTypeExtension(in einer vorhandenen Ressourceninstanz) oder eine neue todoTask, todotasklist contact, event, message, post, todoTask oder todoTaskList, die ein openTypeExtension-Objekt enthält.	Dient zum Erstellen eines openTypeExtension-Objekts in einer vorhandenen oder neuen Ressourceninstanz.
Get	openTypeExtension	Dient zum Lesen der Eigenschaften und der Beziehungen des openTypeExtension-Objekts.
Update	openTypeExtension	Dient zum Aktualisieren des openTypeExtension-Objekts.
Delete	Keine	Dient zum Löschen des openTypeExtension-Objekts.

Eigenschaften

Eigenschaft	Typ	Beschreibung
extensionName	String	Ein eindeutiger Textbezeichner für eine OpenType-Datenerweiterung. Erforderlich.
id	String	Eine vollqualifizierte ID, die den Erweiterungstyp mit dem extensionName-Element verkettet. Schreibgeschützt.

Beziehungen

Keine

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "extensionName": "string",
  "id": "string (identifier)"
}