attributeMapping-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Definiert, wie Werte für das angegebene Zielattribut während der Synchronisation fließen sollen. Dieses Objekt wird in der attributeMappings-Eigenschaft von objectMapping konfiguriert.

Eigenschaften

Eigenschaft Typ Beschreibung
defaultValue Zeichenfolge Standardwert, der verwendet werden soll, wenn die Quelleigenschaft als nullausgewertet wurde. Optional.
exportMissingReferences Boolean Ausschließlich für interne Zwecke.
flowBehavior attributeFlowBehavior Definiert, wann dieses Attribut in das Zielverzeichnis exportiert werden soll. Die möglichen Werte sind: FlowWhenChanged und FlowAlways. Der Standardwert ist FlowWhenChanged.
flowType attributeFlowType Definiert, wann dieses Attribut im Zielverzeichnis aktualisiert werden soll. Die folgenden Werte sind möglich:
  • Always (Standard)
  • ObjectAddOnly - nur bei Anlegen eines neuen Objekts
  • MultiValueAddOnly - nur, wenn die Änderung neue Werte zu einem mehrwertigen Attribut hinzufügt
  • ValueAddOnly - Wenn ein aktueller Wert vorhanden ist, fließt nur "Add"-Operationen; werden keine "Remove"-Vorgänge ausführen
  • AttributeAddOnly - Propagiert Änderungen nur, wenn überhaupt kein aktueller Wert vorhanden ist

    Hinweis: AD2AAD-Bereitstellungsaufträge berücksichtigen den flowType Eigenschaftswert nicht.
matchingPriority Int32 Wenn höher als 0, wird dieses Attribut verwendet, um eine anfängliche Übereinstimmung der Objekte zwischen Quell- und Zielverzeichnis durchzuführen. Das Synchronisierungsmodul versucht, das übereinstimmende Objekt zuerst mithilfe des Attributs mit dem niedrigsten Wert der übereinstimmenden Priorität zu finden. Wenn nicht gefunden, wird das Attribut mit der nächsten übereinstimmenden Priorität verwendet, usw. so lange, bis eine Übereinstimmung gefunden wird oder keine übereinstimmenden Attribute mehr vorhanden sind. Nur Attribute, von denen erwartet wird, dass sie eindeutige Werte aufweisen, z. B. E-Mail, sollten als übereinstimmende Attribute verwendet werden.
source attributeMappingSource Definiert, wie ein Wert aus dem Quellobjekt extrahiert (oder transformiert) werden soll.
targetAttributeName Zeichenfolge Name des Attributs auf dem Zielobjekt.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.attributeMapping",
  "defaultValue": "String",
  "exportMissingReferences": "Boolean",
  "flowBehavior": "String",
  "flowType": "String",
  "matchingPriority": "Integer",
  "source": {
    "@odata.type": "microsoft.graph.attributeMappingSource"
  },
  "targetAttributeName": "String"
}
  • Last updated on