<< Clic para mostrar Tabla de Contenidos >> Crear un usuario utilizando REST |
Para crear usuarios usando Bizagi SCIM, debe usar el servicio descrito en este artículo. El siguiente ejemplo utiliza POSTMAN como cliente, pero puede invocar este servicio desde cualquier cliente compatible con servicios RESTful con autenticación OAUth 2.0.
Antes de continuar, revise la sección Iniciando con el procedimiento de sincronización.
URL del recurso
[Project_URL]/scim/v2/Users
Método HTTP
POST
Autorización
OAuth 2.0
Entradas
La estructura del mensaje JSON que debe enviarse en el cuerpo de la invocación es la siguiente. En [Nombre de variable] encontrará el nombre de las variables que deben enviarse desde su sistema externo:
{
"schemas":[
"urn:ietf:params:scim:schemas:core:2.0:User"
],
"userName":"[userName]@[domain]",
"active":"[activeUser]",
"name":{
"familyName":"[FamilyName]",
"middleName":"[MiddleName]",
"givenName":"[GivenName]"
},
"emails":[
{
"value":"[email]",
"type":"[emailType]",
"primary":"[primaryEmail]"
}
],
"phoneNumbers":[
{
"value":"[phoneNumber]",
"type":"[phoneType]",
"primary":"[primaryPhone]"
}
],
"urn:ietf:params:scim:schemas:extension:bizagi:2.0:UserProperties":
{
"DelegateEnabled": [DelegateEnabled],
"enabledForAssignation": [AssignationEnabled],
"createdCasesSkipAssigRules": [SkipAssignations]
"[NewUserProperty]": [PropertyValue]
}
}
Para asegurar el funcionamiento correcto de la funcionalidad de creación de usuarios, es crucial mapear el atributo enabledForAssignation. |
Sincronización de Propiedades de Usuarios no está disponible en Entra ID. |
Variable |
Descripción |
Tipo |
Propiedad de Usuario en Bizagi (WFuser) |
---|---|---|---|
userName |
El nombre de usuario en Bizagi. Este es un campo obligatorio. El nombre de usuario @ dominio no puede exceder los 25 caracteres. También puede usar este formato dominio \ usuario. |
String |
nombre de usuario y dominio |
active |
Valor booleano que define si el usuario está activo en Bizagi y puede acceder al Portal de Trabajo. |
Boolean |
Activo |
name.FamilyName |
Apellido del usuario. Esto se concatena con GivenName y MiddleName, y se envía como el nombre del usuario en este formato "givenName_MiddleName_FamilyName". Este es un campo obligatorio si los demás están vacíos. |
String |
nombre = GivenName_MiddleName_FamilyName |
name.MiddleName |
Segundo nombre del usuario. Esto se concatena con GivenName y FamilyName y se envía como el nombre del usuario en este formato "givenName_MiddleName_FamilyName". Este es un campo obligatorio si los demás están vacíos. |
String |
nombre = GivenName_MiddleName_FamilyName |
name.GivenName |
Nombre del usuario. Esto se concatena con MiddleName y FamilyName, y se envía como el nombre del usuario en este formato "givenName_MiddleName_FamilyName". Este es un campo obligatorio si los demás están vacíos. |
String |
nombre = GivenName_MiddleName_FamilyName |
emails.value |
Correo electrónico del usuario en Bizagi. |
String |
Email de contacto |
emails.Type |
Solo el tipo work se almacena en Bizagi. El tipo de correo electrónico no se almacena en el WFUser, pero este parámetro debe tener un valor en el JSON. |
String |
N/A |
emails.primary |
Valor booleano. Siempre debe ser true si desea almacenar el correo electrónico en Bizagi. |
Boolean |
N/A |
phoneNumbers.value |
El número de teléfono móvil almacenado en Bizagi. |
String |
Celular de contacto |
phoneNumbers.Type |
Solo el tipo de trabajo se almacena en Bizagi. El tipo de teléfono no se almacena en el WFUser, pero este parámetro debe tener un valor en el JSON. |
String |
N/A |
phoneNumbers.primary |
Valor booleano. Siempre debe ser cierto si desea almacenar el correo electrónico en Bizagi. |
Boolean |
N/A |
DelegateEnabled |
Valor booleano que define si el usuario va a tener un usuario delegado. |
Boolean |
Delegado habilitado |
enabledForAssignation |
Valor booleano que define si el administrador puede seleccionar al usuario en las asignaciones. |
Boolean |
Habilitado para asignación |
createdCasesSkipAssigRules |
Valor booleano que define si los casos creados por el usuario omiten la asignación. |
Boolean |
Omitir reglas de asignación en los casos creados por este usuario |
NewUserProperty |
Este es un ejemplo de una nueva propiedad de usuario creada en la vista experto. |
Mismo que la propiedad de usuario |
Nueva propiedad de usuario |
Este es un ejemplo del JSON que se debe enviar en el cuerpo :
{
"schemas":[
"urn:ietf:params:scim:schemas:core:2.0:User"
],
"userName":"domain\\JohnS",
"active":true,
"name":{
"familyName":"John",
"givenName":" Michael",
"middleName":"Smith"
},
"emails":[
{
"value":"JohnS@example.com",
"type":"work",
"primary":true
}
],
"phoneNumbers":[
{
"value":"2342424",
"type":"work",
"primary":true
}
],
"urn:ietf:params:scim:schemas:extension:bizagi:2.0:UserProperties":{
"DelegateEnabled":true,
"enabledForAssignation":true,
"createdCasesSkipAssigRules":false,
"Otherproperty":250
}
}
Sincronización de Propiedades de Usuarios no está disponible en Entra ID. |
La invocación final en POSTMAN se ve de la siguiente manera:
La respuesta es un JSON con un esquema SCIM de la información guardada en Bizagi.
No puede crear múltiples usuarios en la misma invocación. Un método masivo para crear múltiples usuarios no está disponible. |
Last Updated 9/11/2024 10:34:19 AM