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 Processes, puede manejar información relacionada los Procesos de un usuario (no necesariamente Stakeholder), como se describe en Datos de proceso.
Esta sección describe cómo consultar la lista de casos para un proceso dado.
URL del Recurso
Empecemos con la siguiente URL:
[url_del_proyecto_bizagi]/odata/data/processes([ID_proceso])/cases
Donde:
•[ID_proceso]: El GUID de un proceso en específico como es retornado al invocar Datos de proceso.
•[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/processes([ID_proceso])/cases
Mientras que para proyectos Automation Service, esta URL sería:
https://[ambiente_del_proyecto]-[su_proyecto]-[su_compañía].bizagi.com/odata/data/processes([ID_proceso])/cases
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):
•idCase: El número interno de caso (entero) como es usado por Bizagi.
•Númerodecaso: 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.
•Parámetros: La lista de datos (atributos) y sus valores que tiene este caso.
Estos parámetros incluyen para cada atributo:
oXPath: El XPath completo para ese atributo (incluye su nombre).
oValue: El valor para ese caso en el XPath.
Los resultados retornados a nivel de la raíz, consideran también la llave de la entidad (@bizagi.entidad) para incluir la información sobre a cuál entidad de proceso los caso pertenecen.
|
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, usando:
[url_del_proyecto_bizagi]/odata/data/processes([ID_proceso])/cases([ID_caso])
|
Con el objetivo de promover un rendimiento óptimo, las imágenes o adjuntos no son retornados de manera inmediata por la misma invocación del servicio. A su vez, una URL se entrega para que pueda consultar tal imagen o adjunto de manera separada. Para aprender más sobre esta opción, consulte URLs para imágenes y adjuntos. |
Usted podrá también continuar navegando en los workitems (actividades o eventos) disponibles para ese caso.
Por ejemplo usando:
[your_bizagi_project_url]/odata/data/processes([ID_proceso])/cases([ID_caso])/workitems
Para mayor información sobre cómo continuar con el trabajo pendiente mediante los workitems de un caso, consulte Datos de actividades de casos.
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.