Ejemplos: Actualizar usuarios con SCIM
Tras crear un objeto de usuario, puede actualizar sus campos. Para actualizar un objeto de usuario, envíe una solicitud PATCH al extremo Usuarios.
Ediciones necesarias
| Disponible en: Salesforce Classic y Lightning Experience |
| Disponible en: Todas las ediciones |
Los siguientes ejemplos muestran cómo actualizar objetos de usuario con SCIM. Estas actualizaciones de objeto de usuario son compatibles.
Nota
Cuando crea o actualiza usuarios con SCIM, solo puede asignar un número de teléfono a cada usuario.
Actualizar un campo de objeto de usuario único
Este ejemplo muestra una actualización de campo única en el objeto de usuario.
Solicitud:
PATCH https://mycompany.my.salesforce.com/services/scim/v2/Users/<userid>
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:PatchOp"
],
"Operations": [
{
"op": "replace",
"value": {
"nickName": "user2"
}
}
]
}Respuesta:
HTTP/1.1 200 OK
…
{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"id": "0054W00000CVREkQAP",
"userName": "scimuser@mycompany.com",
"externalId": "scimUser",
"name": {
"formatted": "User Scim",
"familyName": "Scim",
"givenName": "User"
},
"displayName": "User Scim",
"nickName": "user2",
"emails": [
{
"type": "work",
"primary": true,
"value": "user@mycompany.com"
}
],
"photos": [
{
"type": "photo",
"value": "https://mycompany.file.force.com/profilephoto/005/F"
},
{
"type": "thumbnail",
"value": "https://mycompany.file.force.com/profilephoto/005/T"
}
],
"userType": "Standard",
"preferredLanguage": "en_US",
"emailEncodingKey": "UTF-8",
"locale": "en_US",
"timezone": "America/Los_Angeles",
"active": true,
"entitlements": [
{
"value": "00e4W000002Kw0XQAS",
"$ref": "/Entitlements/00e4W000002Kw0XQAS",
"display": "System Administrator",
"type": "Profile",
"primary": true
}
],
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"organization": "00D4W000007RdhEUAS"
},
"urn:salesforce:schemas:extension:2.0": {
"alias": "90905417"
},
"meta": {
"created": "2020-10-22T06:21:45Z",
"lastModified": "2020-10-23T05:33:53Z",
"location": "https://mycompany.my.salesforce.com/services/scim/v2/Users/0054W00000...",
"resourceType": "User",
"version": "9c7f7da0ddb5118829d51dd29e844264496f852b"
}
}
Actualizar múltiples campos de objeto de usuario
Este ejemplo muestra múltiples campos actualizándose en el objeto de usuario.
Solicitud:
PATCH https://mycompany.my.salesforce.com/services/scim/v2/Users/<userid>
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:PatchOp"
],
"Operations": [
{
"op": "replace",
"value": [
{
"nickName": "user3",
"active": false
}
]
}
]
}Respuesta:
HTTP/1.1 200 OK
…
{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"id": "0054W00000DGzivQAD",
"userName": "user3@example.com",
"name": {
"formatted": "User3 SCIM",
"familyName": "SCIM",
"givenName": "User3"
},
"displayName": "User3 SCIM",
"nickName": "user3",
"emails": [
{
"type": "work",
"primary": true,
"value": "user3@example.com"
}
],
...
"active": false,
"entitlements": [
{
"value": "00e4W000002Kw0kQAC",
"$ref": "/Entitlements/00e4W000002Kw0kQAC",
"display": "Identity User",
"type": "Profile",
"primary": true
}
],
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"organization": "00D4W000007RdhEUAS"
},
"urn:salesforce:schemas:extension:2.0": {
"alias": "11399755"
},
"meta": {
"created": "2020-11-05T09:23:19Z",
"lastModified": "2020-12-03T09:10:57Z",
"location": "https://mycompany.my.salesforce.com/services/scim/v2/Users/0054W00...",
"resourceType": "User",
"version": "18e2e5a3f4038af969c9d129c9b12f5e29c85b55"
}
}
Actualizar función de objeto de usuario
Antes de actualizar la función de un objeto de usuario, recuerde consultar el extremo Funciones para ver una lista de funciones disponibles. A continuación se incluye un ejemplo de actualización de la función asignada a un objeto de usuario.
Solicitud:
PATCH https://mycompany.my.salesforce.com/services/scim/v2/Users/<UserId>
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:PatchOp"
],
"Operations": [
{
"op": "replace",
"value": {
"roles": [
{
"value": "<role_id>"
}
]
}
}
]
}Respuesta:
HTTP/1.1 200 OK
…
{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"id": "0054W00000CVREkQAP",
"userName": "scimuser@mycompany.com",
"externalId": "scimUser",
"name": {
"formatted": "User Scim",
"familyName": "Scim",
"givenName": "User"
},
"displayName": "User Scim",
"nickName": "user2",
"emails": [
{
"type": "work",
"primary": true,
"value": "user@mycompany.com"
}
...
"entitlements": [
{
"value": "00e4W000002Kw0XQAS",
"$ref": "/Entitlements/00e4W000002Kw0XQAS",
"display": "System Administrator",
"type": "Profile",
"primary": true
}
],
"roles": [
{
"value": "00E4W0000026qDpUAI",
"$ref": "/Roles/00E4W0000026qDpUAI",
"display": "CEO"
}
],
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"organization": "00D4W000007RdhEUAS"
},
"urn:salesforce:schemas:extension:2.0": {
"alias": "90905417"
},
"meta": {
"created": "2020-10-22T06:21:45Z",
"lastModified": "2020-10-25T09:06:56Z",
"location": "https://mycompany.my.salesforce.com/services/scim/v2/Users/0054W000...",
"resourceType": "User",
"version": "d959e2db34c46435d2c1321126dc54ef25f2ca39"
}
}
Agregar un conjunto de permisos a un objeto de usuario
Este ejemplo muestra cómo agregar un conjunto de permisos a un objeto de usuario. Al modificar objetos de usuario en Salesforce, puede agregar múltiples conjuntos de permisos a objetos de usuario. Antes de agregar un conjunto de permisos a un objeto de usuario, recuerde consultar el extremo Asignaciones para ver una lista de conjuntos de permisos disponibles.
Solicitud:
PATCH https://mycompany.my.salesforce.com/services/scim/v2/Users/<UserId>
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:PatchOp"
],
"Operations": [
{
"op": "add",
"value": {
"entitlements": [
{
"value": "<permission_set_id>"
}
]
}
}
]
}Respuesta:
HTTP/1.1 200 OK
…
{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"id": "0054W00000CUpYGQA1",
"userName": "integration@00d4w000007rdheuas.com",
"name": {
"formatted": "Integration User",
"familyName": "User",
"givenName": "Integration"
},
"displayName": "Integration User",
"nickName": "integration1.4407085834085586E12",
"emails": [
{
"type": "work",
"primary": true,
"value": "integration@example.com"
}
],
"addresses": [
{
"type": "work",
"primary": true,
"country": "xx",
"formatted": "xx"
}
...
"entitlements": [
{
"value": "00e4W000002Kw0YQAS",
"$ref": "/Entitlements/00e4W000002Kw0YQAS",
"display": "Analytics Cloud Integration User",
"type": "Profile",
"primary": true
},
{
"value": "0PS4W000002pwIXWAY",
"$ref": "/Entitlements/0PS4W000002pwIXWAY",
"display": "SCIM_Test_Persmissions",
"type": "Permission Set",
"primary": false
}
],
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"organization": "00D4W000007RdhEUAS"
},
"urn:salesforce:schemas:extension:2.0": {
"alias": "integ"
},
"meta": {
"created": "2020-10-22T09:14:27Z",
"lastModified": "2020-10-26T05:58:59Z",
"location": "https://mycompany.my.salesforce.com/services/scim/v2/Users/0054W00000CUpYGQA1",
"resourceType": "User",
"version": "4cd44c006b2bc431a720b668e0acaaba32b380d1"
}
}
¿Resolvió este artículo su problema?
¡Háganos saber cómo podemos mejorar!
