Freigeben über


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 Zielattribute während der Synchronisierung fließen sollen.

Eigenschaften

Eigenschaft Typ Beschreibung
defaultValue Zeichenfolge Standardwert für den Fall, dass die Quelleigenschaft als nullausgewertet wurde. Optional.
exportMissingReferences Boolesch Ausschließlich für interne Zwecke.
flowBehavior attributeFlowBehavior Definiert, wann dieses Attribut in das Zielverzeichnis exportiert werden soll. Mögliche 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 beim Erstellen eines neuen Objekts
  • MultiValueAddOnly – nur, wenn durch die Änderung neue Werte zu einem mehrwertigen Attribut hinzugefügt werden
  • ValueAddOnly – Wenn ein aktueller Wert vorhanden ist, werden nur "Add"-Vorgänge ausgeführt; "Entfernen"-Vorgänge werden nicht ausgeführt.
  • AttributeAddOnly – Gibt Änderungen nur weiter, wenn überhaupt kein aktueller Wert vorhanden ist
  • matchingPriority Int32 Wenn höher als 0 ist, wird dieses Attribut verwendet, um eine anfängliche Übereinstimmung der Objekte zwischen Quell- und Zielverzeichnissen durchzuführen. Die Synchronisierungs-Engine versucht, das übereinstimmende Objekt mithilfe des Attributs mit dem niedrigsten Wert der übereinstimmenden Priorität zuerst zu finden. Wenn sie nicht gefunden wird, wird das Attribut mit der nächsten übereinstimmenden Priorität verwendet usw. bis eine Übereinstimmung gefunden wird oder keine übereinstimmenden Attribute mehr vorhanden sind. Als übereinstimmende Attribute sollten nur Attribute verwendet werden, die über eindeutige Werte verfügen, z. B. E-Mail.
    source attributeMappingSource Definiert, wie ein Wert aus dem Quellobjekt extrahiert (oder transformiert) werden soll.
    targetAttributeName Zeichenfolge Name des Attributs für das Zielobjekt.

    JSON-Darstellung

    Die folgende JSON-Darstellung zeigt 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"
    }