Introducción
Bizagi ofrece un servicio OData que maneja aspectos de Diseño de Experiencia, como se explica en Servicios de datos.
Por medio de la URI de cases, puede obtener los casos pendientes del usuario autenticado, como se muestra en la Bandeja de Entrada en el Portal de Trabajo.
|
Este recurso está disponibles para todos los usuarios, sean o no Stakeholders |
URL del Recurso
Empecemos con la siguiente URL:
[url_del_proyecto_bizagi]/odata/data/casesWithWorkitems
Donde:
•[url_del_proyecto_bizagi]: Corresponde a la URL donde los usuarios finales acceden al Portal de Trabajo de Bizagi.
Por ejemplo, para proyectos de Bizagi en sus instalaciones, esta URL sería:
https://[su_servidor]/[su_proyecto]/odata/data/casesWithWorkitems
Mientras que para proyectos Automation Service, esta URL sería:
https://[ambiente_del_proyecto]-[su_proyecto]-[su_compañía].bizagi.com/odata/data/casesWithWorkitems
Ejemplo
La siguiente imagen muestra como se puede enviar una solicitud HTTP GET para este recurso:
Los resultados de esta petición son los siguientes (dentro del elemento valor):
•idCaso: El número interno de caso (entero) como es usado por Bizagi.
•caseNumber: El identificador del caso (cadena de texto) como se personaliza en el proyecto y es mostrado a los usuarios finales en el Portal de Trabajo.
•Fechadesolución: La fecha estimada de solución para el caso, de acuerdo a los Acuerdos de Servicios (ANS) del proceso.
•@odata.id: La URL única para el caso en específico.
•Artículosdetrabajo
oid: El identificador interno (entero) para el workitem (típicamente una actividad o instancia de evento).
oNombredetarea: El nombre (cadena de texto) del artículodetrabajo.
oestado: El estado del workiten en términos de: rojo (expirada/atrasado), amarillo (en riesgo), o verde (a tiempo).
oFechadesolución: La fecha estimada de solución para el caso, de acuerdo a los Acuerdos de Servicios (ANS) del proceso.
oParámetros: La lista de los datos (atributos) y sus valores que usa el workitem dado.
Tales parámetros incluyen para cada atributo los mismo parámetros anteriores, aunque aplicables al workitem..
Recuerde que la principal ventada de este recurso es el hecho que entrega los artículosdetrabajo disponibles para los casos. Por este mismo motivo, la respuesta no considera la información y estructura de Parámetros para los casos sino que vienen para los artículosdetrabajo.
|
En adición a lo mencionado anteriormente, para cada conjunto de resultados entregados por los servicios OData, la respuesta exitosa incluye un grupo de propiedades estándar que son precedidas por el símbolo @. Estas propiedades se describen en Propiedades y opciones de consulta. |
Dese cuenta cómo por medio de la propiedad @odata.id, puede obtener el detalle de aquel registro únicamente, en vez de una lista.
Por ejemplo, haciendo uso de:
[url_del_proyecto_bizagi]/odata/data/processes([ID_proceso])/casesWithWorkitems([ID_caso])
|
Para mejorar el desempeño del recurso, las imágenes y los archivos en los casos no son retornados inmediatemente por este servicio. Para aprender más sobre esta opción refiérase a URLs para imágenes y archivos. |
Personalizar los atributos retornados
En caso de que desee filtrar o cambiar por completo los atributos que han sido entregados con esta invocación, refiérase a Configurar qué información de negocio se retorna.