Übersicht über erweiterte Outlook-Eigenschaften

  • Artikel

Namespace: microsoft.graph

Erweiterte Eigenschaften ermöglichen das Speichern benutzerdefinierter Daten und dienen speziell als Fallbackmechanismus für Apps, um auf benutzerdefinierte Daten für Outlook MAPI-Eigenschaften zuzugreifen, wenn diese Eigenschaften noch nicht im Microsoft Graph-API metadata_ verfügbar gemacht wurden. Sie können die REST-API für erweiterte Eigenschaften verwenden, um diese benutzerdefinierten Daten in folgenden Benutzerressourcen zu speichern oder abzurufen:

Möglich sind auch die folgenden Microsoft 365-Gruppenressourcen:

  • event-Ressourcen für Gruppen
  • calendar-Ressourcen für Gruppen
  • post-Ressourcen für Gruppen

Sollten erweiterte Eigenschaften oder offene Erweiterungen verwendet werden?

In den meisten üblichen Szenarios sollten offene Erweiterungen verwendet werden können (dargestellt durch openTypeExtension und bisher als Office 365-Datenerweiterungen bezeichnet), um benutzerdefinierte Daten für Ressourceninstanzen im Postfach eines Benutzers zu speichern oder darauf zuzugreifen. Verwenden Sie erweiterte Eigenschaften nur, wenn Sie auf benutzerdefinierte Daten für Outlook MAPI-Eigenschaften zugreifen müssen, die noch nicht in den Microsoft Graph-API-Metadaten verfügbar gemacht wurden.

Typen erweiterter Eigenschaften

Je nachdem, ob Sie einen einzelnen oder mehrere Werte (vom gleichen Typ) in einer erweiterten Eigenschaft speichern möchten, können Sie eine erweiterte Eigenschaft als SingleValueLegacyExtendedProperty oder als MultiValueLegacyExtendedProperty erstellen.

Jeder dieser Typen identifiziert die Eigenschaft nach ihrer ID und speichert Daten als Wert.

Sie können die ID verwenden, um eine spezifische Ressourceninstanz zusammen mit der erweiterten Eigenschaft abzurufen, oder sie können nach einer einwertigen erweiterten Eigenschaft filtern, um alle Instanzen mit dieser Eigenschaft abzurufen.

Hinweis Sie können die REST-API nicht verwenden, um alle erweiterten Eigenschaften eines bestimmten instance in einem Aufruf abzurufen.

ID-Formate

Sie können die ID einer erweiterten Eigenschaft in einem der folgenden drei Formate angeben:

  • Als benannte Eigenschaft, die durch den erweiterten Eigenschaftentyp, einen Namespace und einen Zeichenfolgennamen identifiziert wird.
  • Als benannte Eigenschaft, die durch den erweiterten Eigenschaftentyp, einen Namespace und einen numerischen Bezeichner identifiziert wird.
  • Im proptag-Format, identifiziert durch den erweiterten Eigenschaftentyp und ein MAPI-Eigenschaftentag.

In den nächsten beiden Tabellen werden diese Formate beschrieben, die auf ein- und mehrwertige erweiterte Eigenschaften angewendet werden. {type} stellt den Typ des Werts bzw. der Werte für die erweiterte Eigenschaft dar. In den Beispielen sind dies Zeichenfolgen, ganze Zahlen und Arrays dieser Typen.

Gültige ID-Formate für einwertige erweiterte Eigenschaften

Format Beispiel Beschreibung
„{type} {guid} Name {name}“ "String {8ECCC264-6880-4EBE-992F-8888D2EEAA1D} Name TestProperty" Identifiziert eine Eigenschaft nach dem Namespace (der GUID), zu dem sie gehört, und einem Zeichenfolgennamen.
„{type} {guid} Id {id}“ "Integer {8ECCC264-6880-4EBE-992F-8888D2EEAA1D} Id 0x8012" Identifiziert eine Eigenschaft nach dem Namespace (der GUID), zu dem sie gehört, und einem numerischen Bezeichner.
"{type} {proptag}" "String 0x4001" Identifiziert eine vordefinierte Eigenschaft anhand ihres Eigenschaftentags.

Gültige ID-Formate für mehrwertige erweiterte Eigenschaften

Format Beispiel Beschreibung
„{type} {guid} Name {name}“ "StringArray {8ECCC264-6880-4EBE-992F-8888D2EEAA1D} Name TestProperty" Identifiziert eine Eigenschaft nach dem Namespace (der GUID)und einem Zeichenfolgennamen.
„{type} {guid} Id {id}“ "IntegerArray {8ECCC264-6880-4EBE-992F-8888D2EEAA1D} Id 0x8013" Identifiziert eine Eigenschaft nach dem Namespace (der GUID) und einem numerischen Bezeichner.
"{type} {proptag}" "StringArray 0x4002" Identifiziert eine vordefinierte Eigenschaft anhand ihres Eigenschaftentags.

Verwenden Sie entweder die Formate der benannten Eigenschaft, um einen Eigenschaft mit einem einzelnen Wert oder erweiterte Eigenschaften mit mehreren Werten als benutzerdefinierte Eigenschaft zu definieren. Von den beiden Formaten, ist das erste, das einen Zeichenfolgennamen (Name) verwendet, aufgrund der einfachen Referenz das bevorzugte Format. Die Eigenschaftenbezeichner von benannten Eigenschaften befinden sich im Bereich 0x8000-0xfffe.

Verwenden Sie das Proptag-Format, um auf Eigenschaften zuzugreifen, die von MAPI oder von einem Client oder Server vordefiniert sind und die noch nicht in Microsoft Graph verfügbar gemacht wurden. Die Eigenschaftenbezeichner dieser Eigenschaften befinden sich im Bereich 0x0001-0x7fff. Versuchen Sie nicht, eine benutzerdefinierte Eigenschaft mit dem Proptag-Format zu definieren.

Informationen zum Zuordnen einer erweiterten Eigenschaft zu einer vorhandenen MAPI-Eigenschaft, z. B. eigenschaftenbezeichner und GUID, finden Sie in [MS-OXPROPS] Microsoft Corporation, "Exchange Server Protocols Master Property List".

Hinweis Nachdem Sie ein Format für die ID ausgewählt haben, sollten Sie nur mit diesem Format auf die betreffende erweiterte Eigenschaft zugreifen.

REST-API-Vorgänge

Vorgänge für erweiterte Eigenschaften mit einem einzelnen Wert:

Vorgänge für erweiterte Eigenschaften mit mehreren Werten: