objectMapping リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。
特定のオブジェクトをソース ディレクトリからターゲット ディレクトリに同期する方法を定義します。 特に、ソース ディレクトリ内のオブジェクトをターゲット ディレクトリ内のオブジェクトと一致する方法、特定のオブジェクトをプロビジョニングする必要がある場合にどのスコープ フィルターを使用して決定するか、およびオブジェクト属性をソースディレクトリからターゲット ディレクトリに変換する方法を定義します。
オブジェクト マッピングは同期ルールの主要部分であり、同期スキーマの一部として更新されます。
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| attributeMappings | attributeMapping コレクション | 属性マッピングは、ソース オブジェクトからターゲット オブジェクトにマップする属性と、その属性のフロー方法を定義します。 元のソース値の変換をサポートするには、多くの関数を使用できます。 |
| enabled | ブール型 (Boolean) | この true 場合、このオブジェクト マッピングは同期中に処理されます。 この false 場合、このオブジェクト マッピングはスキップされます。 |
| flowTypes | objectFlowTypes | このオブジェクト マッピングで有効になっているフローの種類。 Add ターゲット ディレクトリに新しいオブジェクトを作成し、既存のオブジェクトを変更し、既存のユーザーの Update Delete プロビジョニングを解除します。 既定値は Add, Update, Delete です。 |
| metadata | metadataEntry コレクション | その他の拡張プロパティ。 明示的に言及しない限り、メタデータ値を変更する必要はありません。 |
| name | String | オブジェクト マッピングの人間に優しい名前。 |
| scope | filter | 特定のオブジェクトを準備するかどうかを決定するときに使用するフィルターを定義します。 たとえば、米国に位置するユーザーのみをプロビジョニングする場合があります。 |
| sourceObjectName | String | ソース ディレクトリ内のオブジェクトの名前。 ソース ディレクトリ定義のオブジェクト名と一 致する必要があります。 |
| targetObjectName | String | ターゲット ディレクトリ内のオブジェクトの名前。 ターゲット ディレクトリ定義のオブジェクト名と一 致する必要があります。 |
JSON 表記
リソースの JSON 表記を次に示します。
{
"attributeMappings": [{"@odata.type": "microsoft.graph.attributeMapping"}],
"enabled": true,
"flowTypes": "String",
"metadata": [{"@odata.type": "microsoft.graph.metadataEntry"}],
"name": "String",
"scope": {"@odata.type": "microsoft.graph.filter"},
"sourceObjectName": "String",
"targetObjectName": "String"
}
JSON の例
{
"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"
}
フィードバック
フィードバックの送信と表示