openTypeExtension-Ressourcentyp (offene Erweiterungen)openTypeExtension resource type (open extensions)

Offene Erweiterungen (bisher als Office 365-Datenerweiterungen bezeichnet) bieten eine einfache Möglichkeit zum direkten Hinzufügen nicht typisierter Eigenschaften zu einer Ressource in Microsoft Graph.Open extensions (formerly known as Office 365 data extensions) give you an easy way to directly add untyped properties to a resource in Microsoft Graph.

Offiene Erweiterungen werden mithilfe der openTypeExtension-Ressource dargestellt.Open extensions are represented by the openTypeExtension resource. Alle offenen Erweiterungen, die einer Ressource hinzugefügt wurden, werden in der extensions-Navigationseigenschaft angezeigt, die vom abstrakten Typ extension abgeleitet wird.Any open extension added to a resource shows up in the extensions navigation property, which is derived from the extension abstract type. Jede Erweiterung weist eine extensionName-Eigenschaft auf, die die einzige vordefinierte, schreibbare Eigenschaft für alle Erweiterungen zusammen mit ihren benutzerdefinierten Daten ist.Each extension has an extensionName property which is the only pre-defined, writable property for all extensions, along with your custom data.

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.One way to help make sure extension names are unique is to use a reverse domain name system (DNS) format that is dependent on your own domain, for example, Com.Contoso.ContactInfo. Verwenden Sie in Erweiterungsnamen auf keinen Fall die Microsoft-Domäne (Com.Microsoft oder Com.OnMicrosoft).Do not use the Microsoft domain (Com.Microsoft or Com.OnMicrosoft) in an extension name.

Beispiel für eine offene Erweiterung: Hinzufügen von benutzerdefinierten Daten zu Benutzern mithilfe offener ErweiterungenOpen extension example: Add custom data to users using open extensions

Offene Erweiterungen werden von den folgenden Ressourcen in den entsprechenden Versionen unterstützt: - Allgemein verfügbar (GA: /v1.0 und /beta) oder Vorschau (/beta).Open extensions are supported by the following resources in the corresponding versions - general availability (GA: /v1.0 and /beta) or preview (/beta).

RessourceResource VersionVersion
Administrative EinheitAdministrative unit Nur VorschauPreview only
KalenderereignisCalendar event Allgemein verfügbarGA
Kalenderereignis für GruppeGroup calendar event Allgemein verfügbarGA
Unterhaltungsthread der Gruppe postenGroup conversation thread post Allgemein verfügbarGA
devicedevice Allgemein verfügbarGA
groupgroup Allgemein verfügbarGA
messagemessage Allgemein verfügbarGA
organizationorganization Allgemein verfügbarGA
Privater KontaktPersonal contact Allgemein verfügbarGA
useruser Allgemein verfügbarGA

Outlook-spezifische AspekteOutlook-specific considerations

Jede auf einer Outlook-Ressource (Ereignis, Nachricht oder persönlicher Kontakt) vorhandene offene Erweiterung ist in einer Eigenschaft namens MAPI gespeichert.Each open extension present on an Outlook resource (event, message, or personal contact) is stored in a MAPI named property. Wenn Sie offene Erweiterungen für Outlook erstellen, bedenken Sie, dass mit MAPI benannte Eigenschaften eine endliche Ressource im Postfach eines Benutzers darstellen.When you create open extensions for Outlook, consider that MAPI named properties are a finite resource in a user's mailbox. Wenn das Kontingent für benannte Eigenschaften eines Benutzers aufgebraucht ist, können nicht Sie keine weiteren benannten Eigenschaften für diesen Benutzer erstellen.When a user's named property quota is exhausted, you can't create any more named properties for that user. Dies kann zu unerwartetem Verhalten von Clients führen, die für ihre Funktionalität auf benannte Eigenschaften angewiesen sind.This can result in unexpected behavior from clients that rely on named properties to function.

Wenden Sie die folgenden Richtlinien an, wenn Sie offene Erweiterungen in Outlook-Ressourcen erstellen:Apply the following guidelines when you create open extensions on Outlook resources:

  • Erstellen Sie die minimal erforderliche Anzahl von Erweiterungen.Create the minimum number of extensions required. Die meisten Anwendungen sollten nicht mehr als eine Erweiterung erfordern.Most applications should require no more than one extension. Erweiterungen verfügen über keine fest definierten Eigenschaften oder Strukturen, somit können Sie in einer einzelnen Erweiterung mehrere Werte speichern.Extensions have no set defined properties or structure, so you can store multiple values in a single extension.
  • Vermeiden Sie es, Erweiterungen auf eine variable Weise zu benennen (z. B. basierend auf der Benutzereingabe usw.).Avoid naming extensions in a variable manner (such as based on user input, etc.). 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.Each time an open extension is created with a new name that has not been used in a user's mailbox before, a new MAPI named property is created. Durch das Entfernen der Erweiterung wird die benannte Eigenschaft nicht entfernt.Removing the extension does not remove the named property.

Sollen offene Erweiterungen (für Outlook-Ressourcen) oder erweiterte Eigenschaften verwendet werden?Use open extensions (for Outlook resources) or extended properties?

Offene Erweiterungen sind die empfohlene Lösung für die meisten Szenarios, bei denen benutzerdefinierte Daten gespeichert und aufgerufen werden sollen.Open extensions is the recommended solution for most scenarios involving storing and accessing custom data. Wenn Sie auf benutzerdefinierte Daten für Outlook-MAPI-Eigenschaften zugreifen müssen, die nicht bereits in den Microsoft Graph-API-Metadaten verfügbar gemacht wurden, können Sie erweiterte Eigenschaften und deren REST-API verwenden.If, however, you need to access custom data for Outlook MAPI properties that are not already exposed through the Microsoft Graph API metadata, you can use extended properties and its REST API. Unter https://graph.microsoft.com/v1.0/$metadata können Sie überprüfen, welche Eigenschaften die Metadaten verfügbar machen.You can verify which properties the metadata exposes at https://graph.microsoft.com/v1.0/$metadata.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource.

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

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
extensionNameextensionName StringString Ein eindeutiger Textbezeichner für eine offene Erweiterung. Erforderlich.A unique text identifier for an open type open extension. Required.
idid StringString Eine vollqualifizierte ID, die den Erweiterungstyp mit dem extensionName-Element verkettet. Schreibgeschützt.A fully qualified identifier that concatenates the extension type with the extensionName. Read-only.

BeziehungenRelationships

KeineNone

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
PostPost openTypeExtension (in einer vorhandenen Ressourceninstanz) oder ein neues contact-, event- oder message-Objekt, das ein openTypeExtension-Objekt enthält.openTypeExtension (in an existing resource instance), or a new contact, event, or message that contains an openTypeExtension object Dient zum Erstellen eines openTypeExtension-Objekts in einer vorhandenen oder neuen Ressourceninstanz.Create an openTypeExtension object in an existing or new resource instance.
GetGet openTypeExtensionopenTypeExtension Dient zum Lesen der Eigenschaften und der Beziehungen des openTypeExtension-Objekts.Read properties and relationships of openTypeExtension object.
UpdateUpdate openTypeExtensionopenTypeExtension Dient zum Aktualisieren des openTypeExtension-Objekts.Update openTypeExtension object.
DeleteDelete KeineNone Dient zum Löschen des openTypeExtension-Objekts.Delete openTypeExtension object.