Para obtener información de un usuario utilizando Bizagi SCIM, debe utilizar 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/{username}
Método HTTP
POST
Autorización
OAuth 2.0
Entradas
El username o el ID (guidUser de la tabla WFUser) enviado en la URL.
Ejemplo de URL
[Project_URL]/scim/v2/Users/MarkW
Esto devuelve la información del usuario MarkW. Si usted tiene múltiples dominios puede enviar el parámetro usando el siguiente formato:
userName@domain
La ejecución final en POSTMAN se ve así:
La respuesta es un JSON con el esquema SCIM y la información guardada en Bizagi.
Ordenar sus resultados
Por defecto, Bizagi devuelve los primeros 100 usuarios. Sin embargo, puede buscar páginas específicas, ordenar o aumentar los resultados por página. El número de resultados, elementos por página y página de inicio se muestran en JSON.
Puede cambiar cualquiera de estos valores en la invocación del método, donde
•startIndex: indica la primera página que se mostrará en el resultado. De forma predeterminada, es uno y los valores inferiores a uno se consideran uno.
•count: número de resultados máximo. Este valor no puede ser superior a 500.
•sortBy: indica el atributo utilizado para ordenar los resultados. Vea qué atributos puede usar. Si usa cualquier atributo de nombre (name), Bizagi ordena el resultado usando el atributo nombre completo (full name).
•sortOrder: indica el orden de clasificación. Puede utilizar dos valores, ascending o descending.
Concatene esto al final de la URL de invocación usando el simbolo ?, por ejemplo.
[Project_URL]/scim/v2/Users?startIndex=1&count=10&orderBy=username&sortOrder=descending
Consultar atributos específicos
Si desea obtener solo un conjunto de atributos en el resultado, puede enviar en la invocación una lista de los atributos deseados. Para hacer eso, use el siguiente comando:
?attributes=attributo1,attributo2
Concatene esto al final de la URL de invocación usando el simbolo ?. Vea atributos válidos para usar en SCIM. por ejemplo.
[Project_URL]/scim/v2/Users/IvanHerrera?attributes=username,emails.value,Active
Si necesita establecer los parámetros de ordenamiento y establecer atributos específicos, concatenar ambos comandos con el simbolo &. Por ejemplo:
[Project_URL]/scim/v2/Users?startIndex=1&count=10&orderBy=username&sortOrder=descending&attributes=username
Puede obtener un subconjunto de resultados utilizando filtros. Para filtrar una invocación, use el siguiente comando:
filter= [Parametro] [Operador] "[Valor]"
donde:
Parámetro: atributo del schema SCIM. Vea atributos válidos para usar en SCIM.
Valor: Valor del atributo que está usando como filtro.
Operador: Operador del filtro. La siguiente tabla muestra los operadores soportados:
Operador |
Descripción |
|---|---|
eq |
Igual |
ne |
No es igual |
gt |
Mayor que |
ge |
Mayor o igual que |
lt |
Menor que |
le |
Menor o igual que |
Usted puede agregar múltiples condiciones usando operadores lógicos:
Operador Lógico |
Descripción |
|---|---|
and |
El método muestra resultados si ambas condiciones se cumplen. |
or |
El método muestra resultados si alguna de las condiciones se cumple. |
También puede agrupar condiciones usando paréntesis ( ). Los filtros se ejecutan en el siguiente orden:
1.Condiciones agrupadas entre paréntesis
2.Operadores lógicos. El operador and tiene prioridad sobre or.
3.Operadores que utilizan atributos.
|
En Bizagi solo puede registrar un correo electrónico y un teléfono móvil. Por lo tanto, se ignoran los filtros que utilizan cualquier subtipo de estos atributos. Por ejemplo, los filtros que usan el teléfono del trabajo o el teléfono principal (o correo electrónico), brindan los mismos resultados porque todos se comparan con los atributos contactEmail y contactCell de Bizagi. |
Last Updated 1/27/2022 4:02:53 PM