openTypeExtension-Ressourcentyp (offene Erweiterungen)

Namespace: microsoft.graph

Stellt offene Erweiterungen dar (auch bekannt als offene Typerweiterungen und früher bekannt als Office 365-Datenerweiterungen), eine Erweiterungsoption, 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 , bei der es sich um die einzige vordefinierte, beschreibbare Eigenschaft für alle Erweiterungen zusammen mit Ihren benutzerdefinierten Daten handelt. 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.

Die folgenden Ressourcen unterstützen die offene Erweiterung:

Hinweis: * Aufgrund einer bestehenden Diensteinschränkung können Stellvertretungen keine an die offene Erweiterung angefügten Ereignisse in Kalendern freigegebener Postfächer 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 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 haben keine definierten Eigenschaften oder Strukturen, sodass Sie mehrere Werte in einer einzigen 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. 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 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 Metadaten der Microsoft Graph-API verfügbar gemacht werden, können Sie erweiterte Eigenschaften und die zugehörige REST-API verwenden. Sie können überprüfen, welche Eigenschaften die Metadaten unter https://graph.microsoft.com/v1.0/$metadataverfügbar machen.

Methoden

Methode Rückgabetyp Beschreibung
Create openTypeExtension (in einer vorhandenen Ressourcen-instance) oder ein neuer todoTask, todoTaskList, Kontakt, Ereignis, Nachricht, Hinweis oder Beitrag, der 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 auf eine der folgenden Arten definiert werden:
  • Definieren Sie explizit die id-Eigenschaft im Anforderungstext.
  • Definieren Sie eine extensionName-Eigenschaft im Anforderungstext, und Microsoft Graph weist automatisch denselben Wert der id-Eigenschaft zu.
    • In nachfolgenden Updates können Sie den Wert der extensionName-Eigenschaft in einen Wert ändern, der sich vom id-Wert unterscheidet.
    • Wenn Sie in nachfolgenden Aktualisierungen nur die id-Eigenschaft im Anforderungstext angeben, wird die extensionName-Eigenschaft automatisch aus der geöffneten Erweiterung gelöscht.

Beziehungen

Keine

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

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

Verwandte Inhalte

  • Last updated on