Crear un usuario utilizando REST

<< Clic para mostrar Tabla de Contenidos >>

Navegación:  Automatización de Procesos con poco código > Studio Cloud -ambiente de autoría > Bizagi Studio > Definición de Seguridad > Seguridad del Portal de Trabajo > Sincronización de usuarios > Sincronizar usuarios con métodos REST de SCIM > Iniciando a sincronizar usuarios con métodos REST >

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]
    }

}

 

note_pin

Para asegurar el funcionamiento correcto de la funcionalidad de creación de usuarios, es crucial mapear el atributo enabledForAssignation.

 

note_pin

Sincronización de Propiedades de Usuarios no está disponible en Entra ID.

 

Donde:

 

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

  }

}

 

note_pin

Sincronización de Propiedades de Usuarios no está disponible en Entra ID.

 

La invocación final en POSTMAN se ve de la siguiente manera:

 

SCIM_10

 

La respuesta es un JSON  con un esquema SCIM de la información guardada en Bizagi.

 

note_pin

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