Feedback Bearbeiten

Übersicht über erweiterte Outlook-Eigenschaften

  • Artikel
  • 3 Minuten Lesedauer

Namespace: microsoft.graph

Erweiterte Eigenschaften ermöglichen das Speichern von benutzerdefinierten Daten und dienen insbesondere als Fallbackmechanismus, mit dem Apps auf benutzerdefinierte Daten für Outlook-MAPI-Eigenschaften zugreifen können, wenn diese Eigenschaften noch nicht in den Microsoft Graph-API-Metadaten 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 nicht bereits 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 dafür verwenden, alle erweiterten Eigenschaften einer spezifischen Instanz 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.

Die folgenden zwei Tabellen beschreiben die unterstützten Formate für Eigenschaften mit einzelnen Werten und erweiterte Eigenschaften mit mehreren Werten. {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 identifiziert 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 identifiziert 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 die von MAPI, von einem Client oder von einem Server vordefinierten Eigenschaften zuzugreifen, die nicht bereits 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 wie dem Eigenschaftsbezeichner und der GUID finden Sie unter [MS-OXPROPS] Microsoft Corporation, „Eigenschaften für Exchange Server-Protokolle“.

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: