名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
特定のオブジェクトをソース ディレクトリからターゲット ディレクトリに同期する方法を定義します。 具体的には、ソースディレクトリ内のオブジェクトをターゲットディレクトリ内のオブジェクトとどのように照合するか、特定のオブジェクトをプロビジョニングするかどうかを決定するために使用するスコープフィルター(存在する場合)を定義します。およびソースディレクトリからターゲットディレクトリにオブジェクト属性を変換する方法を定義します。
オブジェクト マッピングは、synchronizationRule の objectMappings プロパティのメイン部分であり、synchronizationSchema の一部として更新されます。
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| attributeMappings | attributeMapping コレクション | 属性マッピングでは、ソース オブジェクトからターゲット オブジェクトにマップする属性と、そのフロー方法を定義します。 元のソース値の変換をサポートするために使用できる関数が多数用意されています。 |
| enabled | ブール型 |
trueすると、このオブジェクト マッピングは同期中に処理されます。
falseする場合、このオブジェクト マッピングはスキップされます。 |
| flowTypes | objectFlowTypes | このオブジェクト マッピングで有効になるフローの種類。
Add ターゲット ディレクトリに新しいオブジェクトを作成し、既存のオブジェクト Update 変更し、既存のユーザーのプロビジョニングを Delete 解除します。 既定値は Add, Update, Delete です。 |
| metadata | objectMappingMetadataEntry コレクション | 追加の拡張機能プロパティ。 明示的に明記しない限り、メタデータ値は変更しないでください。 |
| name | String | わかりやすいオブジェクト マッピングの名前。 |
| scope | filter | 特定のオブジェクトをプロビジョニングするかどうかを決定するときに使用されるフィルターを定義します。 たとえば、米国に存在するユーザーのみをプロビジョニングしたい場合があります。 |
| sourceObjectName | 文字列 | ソース ディレクトリ内のオブジェクトの名前。 ソース ディレクトリ定義のオブジェクト名と一致する必要があります。 |
| targetObjectName | 文字列 | ターゲット ディレクトリ内のオブジェクトの名前。 ターゲット ディレクトリ定義のオブジェクト名と一致する必要があります。 |
構成例
{
"attributeMappings": [
{
"defaultValue": "True",
"exportMissingReferences": false,
"flowBehavior": "FlowWhenChanged",
"flowType": "Always",
"matchingPriority": 0,
"source": {
"expression": "Not([IsSoftDeleted])",
"name": "Not",
"parameters": [
{
"key": "source",
"value": {
"expression": "[IsSoftDeleted]",
"name": "IsSoftDeleted",
"parameters": [],
"type": "Attribute"
}
}
],
"type": "Function"
},
"targetAttributeName": "IsActive"
},
{
"defaultValue": null,
"exportMissingReferences": false,
"flowBehavior": "FlowWhenChanged",
"flowType": "Always",
"matchingPriority": 0,
"source": {
"expression": "Mid([userPrincipalName], 1, 8)",
"name": "Mid",
"parameters": [
{
"key": "source",
"value": {
"expression": "[userPrincipalName]",
"name": "userPrincipalName",
"parameters": [],
"type": "Attribute"
}
},
{
"key": "start",
"value": {
"expression": "\"1\"",
"name": "1",
"parameters": [],
"type": "Constant"
}
},
{
"key": "length",
"value": {
"expression": "\"8\"",
"name": "8",
"parameters": [],
"type": "Constant"
}
}
],
"type": "Function"
},
"targetAttributeName": "Alias"
},
{
"defaultValue": null,
"exportMissingReferences": false,
"flowBehavior": "FlowWhenChanged",
"flowType": "Always",
"matchingPriority": 0,
"source": {
"expression": "[mail]",
"name": "mail",
"parameters": [],
"type": "Attribute"
},
"targetAttributeName": "Email"
},
{
"defaultValue": "ISO-8859-1",
"exportMissingReferences": false,
"flowBehavior": "FlowWhenChanged",
"flowType": "Always",
"matchingPriority": 0,
"source": null,
"targetAttributeName": "EmailEncodingKey"
},
{
"defaultValue": "en_US",
"exportMissingReferences": false,
"flowBehavior": "FlowWhenChanged",
"flowType": "Always",
"matchingPriority": 0,
"source": null,
"targetAttributeName": "LanguageLocaleKey"
},
{
"defaultValue": null,
"exportMissingReferences": false,
"flowBehavior": "FlowWhenChanged",
"flowType": "Always",
"matchingPriority": 0,
"source": {
"expression": "[givenName]",
"name": "givenName",
"parameters": [],
"type": "Attribute"
},
"targetAttributeName": "FirstName"
},
{
"defaultValue": ".",
"exportMissingReferences": false,
"flowBehavior": "FlowWhenChanged",
"flowType": "Always",
"matchingPriority": 0,
"source": {
"expression": "[surname]",
"name": "surname",
"parameters": [],
"type": "Attribute"
},
"targetAttributeName": "LastName"
},
{
"defaultValue": "en_US",
"exportMissingReferences": false,
"flowBehavior": "FlowWhenChanged",
"flowType": "Always",
"matchingPriority": 0,
"source": {
"expression": "Replace([preferredLanguage], \"-\", , , \"_\", , )",
"name": "Replace",
"parameters": [
{
"key": "source",
"value": {
"expression": "[preferredLanguage]",
"name": "preferredLanguage",
"parameters": [],
"type": "Attribute"
}
},
{
"key": "Find",
"value": {
"expression": "\"-\"",
"name": "-",
"parameters": [],
"type": "Constant"
}
},
{
"key": "Replacement",
"value": {
"expression": "\"_\"",
"name": "_",
"parameters": [],
"type": "Constant"
}
}
],
"type": "Function"
},
"targetAttributeName": "LocaleSidKey"
},
{
"defaultValue": "Chatter Free User",
"exportMissingReferences": false,
"flowBehavior": "FlowWhenChanged",
"flowType": "Always",
"matchingPriority": 0,
"source": {
"expression": "SingleAppRoleAssignment([appRoleAssignments])",
"name": "SingleAppRoleAssignment",
"parameters": [
{
"key": "source",
"value": {
"expression": "[appRoleAssignments]",
"name": "appRoleAssignments",
"parameters": [],
"type": "Attribute"
}
}
],
"type": "Function"
},
"targetAttributeName": "ProfileName"
},
{
"defaultValue": "America/Los_Angeles",
"exportMissingReferences": false,
"flowBehavior": "FlowWhenChanged",
"flowType": "Always",
"matchingPriority": 0,
"source": null,
"targetAttributeName": "TimeZoneSidKey"
},
{
"defaultValue": null,
"exportMissingReferences": false,
"flowBehavior": "FlowWhenChanged",
"flowType": "Always",
"matchingPriority": 1,
"source": {
"expression": "[userPrincipalName]",
"name": "userPrincipalName",
"parameters": [],
"type": "Attribute"
},
"targetAttributeName": "Username"
},
{
"defaultValue": "False",
"exportMissingReferences": false,
"flowBehavior": "FlowWhenChanged",
"flowType": "Always",
"matchingPriority": 0,
"source": null,
"targetAttributeName": "UserPermissionsCallCenterAutoLogin"
},
{
"defaultValue": "False",
"exportMissingReferences": false,
"flowBehavior": "FlowWhenChanged",
"flowType": "Always",
"matchingPriority": 0,
"source": null,
"targetAttributeName": "UserPermissionsMarketingUser"
},
{
"defaultValue": "False",
"exportMissingReferences": false,
"flowBehavior": "FlowWhenChanged",
"flowType": "Always",
"matchingPriority": 0,
"source": null,
"targetAttributeName": "UserPermissionsOfflineUser"
}
],
"enabled": true,
"flowTypes": "Add, Update, Delete",
"metadata": [
{
"key": "IsCustomerDefined",
"value": "false"
},
{
"key": "DisableMonitoringForChanges",
"value": "false"
},
{
"key": "Disposition",
"value": "\"Normal\""
},
{
"key": "ExcludeFromReporting",
"value": "false"
},
{
"key": "EscrowBehavior",
"value": "\"Default\""
},
{
"key": "Unsynchronized",
"value": "false"
}
],
"name": "Synchronize Azure Active Directory Users to salesforce.com",
"scope": null,
"sourceObjectName": "User",
"targetObjectName": "User"
}
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.objectMapping",
"attributeMappings": [
{
"@odata.type": "microsoft.graph.attributeMapping"
}
],
"enabled": "Boolean",
"flowTypes": "String",
"metadata": [
{
"@odata.type": "microsoft.graph.objectMappingMetadataEntry"
}
],
"name": "String",
"scope": {
"@odata.type": "microsoft.graph.filter"
},
"sourceObjectName": "String",
"targetObjectName": "String"
}