Introducción
Bizagi ofrece un servicio OData que maneja aspectos del Diseño de Experiencia.
Por medio de la URI Cosas, puede manejar información respecto a la sección Mis Cosas para el Stakeholder autenticado, como se describe en Datos de Mis Cosas.
Esta sección describe como consultar y ejecutar una acción desde datos en Mis Cosas.
|
Las acciones consideradas por este servicio son sólo aquellas que disparan nuevos procesos. Las acciones que ejecutan reglar o lanzan formas no son soportadas. |
URL del Recurso
Empezamos con la siguiente URL:
[url_del_proyecto_bizagi]/odata/data/stuff([ID_stuff])/values([ID_valor])/actions
Siendo:
•[ID_stuff]: El GUID de una colección específica de Mis Cosas que es retornado al invocar Datos de Mis Cosas.
•[ID_valor]: El ID de un ítem de una colección de Mis Cosas, como se retorna cuando se obtiene Datos de Mis Cosas.
•[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/stuff([ID_stuff])/values([ID_valor])/actions
Mientras que para proyectos Automation Service, esta URL sería:
https://[ambiente_del_proyecto]-[su_proyecto]-[su_compañía].bizagi.com/odata/data/stuff([ID_stuff])/values([ID_valor])/actions
Ejemplo
La siguiente imagen ilustra como se puede enviar una solicitud HTTP GET para este recurso:
Los resultados obtenidos (dentro del elemento valor) son:
•name: El nombre único de la acción.
•displayName: El nombre para mostrar por defecto de la acción, como se muestra para un registro.
•@odata.id: La URL única para acceder la acción en específico.
•Id: Una cadena de texto con el GUID que representa la URI de esta acción en específico.
•parameters: La lista de datos (atributos) que necesita la acción para correr una nueva (en este caso, iniciar un caso).
Estos parámetros incluyen para cada atributo:
oId: El GUID en una cadena de texto para el atributo.
oname: El nombre del atributo.
oXPath: El XPath completo para ese atributo (incluye su nombre).
otype: El tipo de dato para ese atributo. Una lista de los posibles valores para los tipos de datos en Bizagi se encuentra en Tipos de datos.
|
Adicionalmente, para cada conjunto de resultados entregado por los servicios OData, la respuesta exitosa incluye un grupo de propiedades estándar que están precedidas por el símbolo @. Estas propiedades se describen en Propiedades y opciones de consulta. |
Dese cuenta como desde la propiedad @odata.id, puede obtener únicamente el detalle de ese registro en específico en vez de una lista.
Por ejemplo, usando
[url_del_proyecto_bizagi]/odata/data/stuff([ID_stuff])/values([ID_valor])/actions([ID_accion])
Para una acción dada, puede elegir ejecutarla.
Par más información en cómo ejecutar acciones, refiérase a Datos de Acciones Ejecutadas.