objectMapping 资源类型
命名空间：microsoft.graph
定义应如何将给定对象从源目录同步到目标目录。 具体而言，它定义了应如何将源目录中的对象与目标目录中的对象匹配、 (哪些) 范围筛选器用于确定是否要预配给定对象，以及如何将对象属性从源目录转换为目标目录。
对象映射是 同步规则 的主要部分，作为 同步架构的一部分进行更新。
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| attributeMappings | attributeMapping 集合 | 属性映射定义哪些属性要从源对象映射到目标对象，以及它们应如何流动。 有许多函数可用于支持原始源值的转换。 |
| enabled | 布尔值 | 当 为 时 true，将在同步期间处理此对象映射。 当 为 时 false，将跳过此对象映射。 |
| flowTypes | objectFlowTypes | 为此对象映射启用了哪些流类型。
Add 在目标目录中创建新对象， Update 修改现有对象，并 Delete 取消预配现有用户。 默认值为 Add, Update, Delete。 |
| 元数据 | objectMappingMetadataEntry 集合 | 其他扩展属性。 除非明确提及，否则不应更改元数据值。 |
| name | String | 对象映射的友好名称。 |
| 范围 | filter | 定义在确定是否应预配给定对象时要使用的筛选器。 例如，你可能只想预配位于美国的用户。 |
| sourceObjectName | String | 源目录中对象的名称。 必须与源 目录定义中的对象名称匹配。 |
| targetObjectName | String | 目标目录中的对象的名称。 必须与目标 目录定义中的对象名称匹配。 |
示例配置
{
"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"
}