attributeMapping リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

同期中に指定されたターゲット属性の値がどのように流れるかを定義します。

プロパティ

プロパティ 説明
Defaultvalue String ソース プロパティが に評価された場合に使用されるnull既定値。 省略可能です。
exportMissingReferences ブール型 内部使用のみ。
flowBehavior attributeFlowBehavior この属性をターゲット ディレクトリにエクスポートするタイミングを定義します。 使用可能な値は FlowWhenChanged 、 と FlowAlwaysです。 既定値は FlowWhenChanged です。
flowType attributeFlowType ターゲット ディレクトリでこの属性を更新するタイミングを定義します。 使用可能な値は次のとおりです。
  • Always (既定値)
  • ObjectAddOnly - 新しいオブジェクトが作成された場合のみ
  • MultiValueAddOnly - 変更が複数値属性に新しい値を追加している場合にのみ
  • ValueAddOnly - 現在の値がある場合は、"追加" 操作のみがフローされます。"Remove" 操作はフローしません
  • AttributeAddOnly - 現在の値がまったく存在しない場合にのみ変更を反映します
  • matchingPriority Int32 0 より大きい場合は、この属性を使用して、ソース ディレクトリとターゲット ディレクトリの間でオブジェクトの最初の一致が実行されます。 同期エンジンは、一致する優先度が最も低い属性を使用して、一致するオブジェクトを最初に検索しようとします。 見つからない場合は、次に一致する優先順位を持つ属性が使用されます。そのため、一致が見つかるまで、または一致する属性が残りません。 電子メールなどの一意の値が必要な属性のみを、一致する属性として使用する必要があります。
    source attributeMappingSource ソース オブジェクトから値を抽出 (または変換) する方法を定義します。
    targetAttributeName String ターゲット オブジェクトの属性の名前。

    JSON 表記

    リソースの JSON 表記を次に示します。

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