Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Define cómo se debe sincronizar un objeto determinado desde el directorio de origen al directorio de destino. En particular, define cómo se debe hacer coincidir el objeto en el directorio de origen con un objeto en el directorio de destino, qué filtros de ámbito (si los hay) se deben usar para decidir si queremos aprovisionar un objeto determinado y cómo se deben transformar los atributos del objeto pasando del directorio de origen al de destino.
Las asignaciones de objetos son la parte principal de la propiedad objectMappings de synchronizationRule y se actualizan como parte de synchronizationSchema.
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| asignaciones de atributos | colección attributeMapping | Las asignaciones de atributos definen qué atributos asignar del objeto de origen al objeto de destino y cómo deben fluir. Hay varias funciones disponibles para admitir la transformación de los valores de origen originales. |
| habilitado | Booleano | Cuando true, esta asignación de objetos se procesará durante la sincronización. Cuando false, se omitirá esta asignación de objetos. |
| tipos de flujo | objectFlowTypes | ¿Qué tipos de flujo están habilitados para esta asignación de objetos?
Add crea nuevos objetos en el directorio de destino, Update modifica los objetos existentes y Delete desaprovisiona a los usuarios existentes. El valor predeterminado es Add, Update, Delete. |
| metadatos | colección objectMappingMetadataEntry | Propiedades de extensión adicionales. A menos que se mencionen explícitamente, los valores de metadatos no deben cambiarse. |
| name | Cadena | Nombre descriptivo de la asignación de objetos. |
| ámbito | filter | Define un filtro que se usará al decidir si se debe aprovisionar un objeto determinado. Por ejemplo, es posible que quiera aprovisionar únicamente a usuarios ubicados en Estados Unidos. |
| sourceObjectName | Cadena | Nombre del objeto en el directorio de origen. Debe coincidir con el nombre de objeto de la definición del directorio de origen. |
| targetObjectName | Cadena | Nombre del objeto en el directorio de destino. Debe coincidir con el nombre de objeto de la definición del directorio de destino. |
Configuración de ejemplo
{
"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"
}
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@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"
}