Overview
Bizagi ofrece servicios OData para que aplicaciones externas puedan trabajar con la información que tiene Bizagi.
Esta sección describe como hacer uso de los servicios OData que le permiten ejecutar consultas. Este servicio solo le permite hacer consultas en sus entidades maestras. A diferencia de la opción de consulta en los servicios de Datos, estos servicios no se deben asociar a una consulta de Bizagi.
URL base para los servicios de consulta
Para acceder a los Servicios de consulta, inicie por esta URL:
[your_bizagi_project_url]/odata/query
Donde:
•[your_bizagi_project_url]: Corresponde a la URL del Portal de Trabajo al que acceden sus usuarios finales.
Para proyectos Automation Service, esta URL sería:
https://[project_environment]-[your_project]-[your_company].bizagi.com/odata/query
Recursos en los Servicios de Consulta
La siguiente tabla muestra información sobre los recursos manejados por los Servicios de Consulta:
Recurso |
Descripción |
URL ejemplo |
|---|---|---|
Entity |
Retorna la lista de las entidades expuestas y sus posibles XPaths |
[your_bizagi_project_url]/odata/query/entity |
executeEntityQuery |
Ejecuta una consulta sobre una entidad específica |
[your_bizagi_project_url]/odata/query/executeEntityQuery |
Ejemplos
En esta sección encontrará ejemplos de cada uno de estos servicios.
Entidad
La siguiente imagen muestra cómo se puede enviar una solicitud HTTP GET para este recurso:
Este servicio retorna una lista de entidades dentro de la sección valor. Cada una de estas entidades tiene la siguiente información:
•@odata.id: La URL que identifica este elemento.
•Id: Una cadena de caracteres tipo GUID que representa la URI del elemento.
•Nombre: El nombre de la entidad como se definió en Bizagi Studio.
•EsProcesoEntidad: Este elemento muestra si la entidad es una entidad de proceso o no.
•ProcesosRelacionados: La lista de los procesos relacionados con esta entidad.
Los atributos disponibles para estos procesos son:
oId: Una cadena de caracteres tipo GUID del proceso.
odisplayName: Nombre del proceso.
•Attribs: Un array que muestra los XPath o entidades que se pueden consultar desde esta entidad.
oId: Una cadena de caracteres tipo GUID que identifica el XPath o la entidad.
odisplayName: Nombre de la entidad o XPath.
oxpaths: Una lista de los posibles XPath.
La siguiente imagen muestra un ejemplo de cómo se ve la llave "attribs":
Si la entidad es una entidad de proceso, esta muestra unos atributos especiales relacionados con el proceso en la llave "attrib".
•@IdProceso: Número de ID del proceso.
•@NúmerodeCaso: Número del caso.
•@FechadeCreación: Fecha de creación del caso.
•@FechaestimadadeSolución: Fecha estimada de solución del caso.
•@FechadeSolución: Fecha de solución del caso.
•@Cerrado: Muestra si el caso está cerrado.
•@ArtículosdeTrabajo: Información sobre los artículosdetrabajo pendientes.
ejecutarConsultaEntidad
Este servicio POST ejecuta una consulta sobre una entidad específica que se determina a través de un archivo JSON. Este JSON debe contener también la lista de XPaths que se desean recuperar. Estos XPaths deben coincidir con los valores retornados por el servicio de Entity.
Los elementos esperados del JSON son:
•ParámetroConsulta: Los parámetros de la consulta sobre la entidad
oEntidad: El nombre de la entidad. No use el nombre para mostrar
oIdProceso: Número de ID del proceso que se desea consultar a través de la entidad del proceso
oXPaths: Una lista de los XPaths que se desean ver en la consulta
Este servicio devuelve una lista de XPath para cada registro de su entidad junto con el número total de registros.
La siguiente imagen muestra un ejemplo del JSON que se debe enviar y de la respuesta retornada por el endpoint:
Consideraciones
•Si no se entrega ningún XPath, el servicio solo retorna el campo IDBizagi.
•Para las Entidades de proceso, si no se provee un Idprocess, la consulta usa el primer proceso asociado con el proceso.
•Para las entidades que no son de proceso, no se puede enviar un Idprocess.
•El servicio de consultas solo puede acceder a dos capas de información.
•Las colecciones no se pueden consultar usando este servicio.
Last Updated 2/4/2022 3:33:09 PM