openTypeExtension-Ressourcentyp (offene Erweiterungen)

  • Artikel

Namespace: microsoft.graph

Stellt offene Erweiterungen (auch als Offene Typerweiterungen und früher als Office 365-Datenerweiterungen bezeichnet) dar, eine Erweiterbarkeitsoption , die eine einfache Möglichkeit bietet, einer Ressource in Microsoft Graph direkt nicht typisierte Eigenschaften hinzuzufügen.

Jede geöffnete Erweiterung, die einer Ressource hinzugefügt wird, wird in der Navigationseigenschaft Erweiterungen angezeigt. Jede Erweiterung verfügt über eine extensionName-Eigenschaft , die die einzige vordefinierte, schreibbare Eigenschaft für alle Erweiterungen ist, zusammen mit Ihren benutzerdefinierten Daten. 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 die Microsoft-Domäne (com.microsoft oder com.onmicrosoft) nicht in einem Erweiterungsnamen.

Wird vom abstrakten Typ der Erweiterung abgeleitet.

Die folgenden Ressourcen unterstützen eine offene Erweiterung:

Hinweis: * Aufgrund einer vorhandenen Diensteinschränkung können Stellvertretungen in freigegebenen Postfachkalendern keine ereignisse erstellen, die an die Erweiterung angefügt werden. 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 geöffnete Erweiterung für eine Outlook-Ressource (Ereignis, Nachricht oder persönlicher Kontakt) wird in einer benannten MAPI-Eigenschaft 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 erschöpft ist, können Sie keine benannten Eigenschaften mehr 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 definierten Eigenschaften oder Strukturen, sodass Sie mehrere Werte in einer einzelnen Erweiterung speichern können.
  • Vermeiden Sie es, Erweiterungen auf eine variable Weise zu benennen (z. B. basierend auf der Benutzereingabe usw.). Jedes Mal, wenn eine geöffnete Erweiterung mit einem neuen Namen erstellt wird, der noch nicht im Postfach eines Benutzers verwendet wurde, wird eine neue MAPI-benannte Eigenschaft erstellt. Wenn Sie die Erweiterung entfernen, 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 Szenarios, bei denen benutzerdefinierte Daten gespeichert und aufgerufen werden sollen. Wenn Sie jedoch auf benutzerdefinierte Daten für Outlook-MAPI-Eigenschaften zugreifen müssen, die noch nicht über die Microsoft Graph-API-Metadaten verfügbar gemacht wurden, können Sie erweiterte Eigenschaften und die zugehörige REST-API verwenden. Unter https://graph.microsoft.com/v1.0/$metadata können Sie überprüfen, welche Eigenschaften die Metadaten verfügbar machen.

Methoden

Methode Rückgabetyp Beschreibung
Create openTypeExtension(in einer vorhandenen Ressourceninstanz) oder ein neuer todoTask-, todoTaskList-Kontakt, ein Ereignis, eine Nachricht, ein Beitrag, ein todoTask oder ein todoTaskList-Objekt, das 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. Optional.
id String Eine vollqualifizierte ID, die den Erweiterungstyp mit dem extensionName-Element verkettet. Schreibgeschützt.

Die ID muss während des Erstellungsvorgangs mithilfe einer der folgenden Methoden definiert werden:
  • Definieren Sie die Id-Eigenschaft explizit im Anforderungstext.
  • Definieren Sie eine extensionName-Eigenschaft im Anforderungstext, und Microsoft Graph weist der id-Eigenschaft automatisch denselben Wert zu.
    • In nachfolgenden Updates können Sie den ExtensionName-Eigenschaftswert in einen wert ändern, der sich vom ID-Wert unterscheidet.
    • Bei nachfolgenden Aktualisierungen wird die extensionName-Eigenschaft automatisch aus der geöffneten Erweiterung gelöscht, wenn nur die id-Eigenschaft im Anforderungstext angegeben wird.

Beziehungen

Keine

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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

Verwandte Inhalte