Datos de Acciones Ejecutadas

<< Clic para mostrar Tabla de Contenidos >>

Navegación:  Bizagi Studio > Bizagi desde aplicaciones externas > API de Bizagi para aplicaciones externas > Servicios OData > Índice de servicios > Servicios de Datos > Datos de Mis Cosas > Datos de Acciones de Mis Cosas >

Datos de Acciones Ejecutadas

Introducción

Bizagi ofrece un servicio OData que maneja aspectos del Diseño de Experiencia.

Por medio de la URI Stuff, puede manejar información respecto a la sección Mis Cosas para el Stakeholder autenticado, y puede partir de ahí para buscar acciones de registros, como se describe en Datos de acciones de Mis Cosas.

Esta sección describe como ejecutar una acción obtenida desde información de Mis Cosas.

 

URL del Recurso

Partamos de la siguiente URL:

[url_del_proyecto_bizagi]/odata/data/stuff([ID_stuff])/values([ID_valor])/actions([ID_accion]/execute)

 

Donde:

[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 registro específico de una colección de Mis Cosas, como se retorna cuando se obtiene Datos de Mis Cosas

[ID_accion]: El ID de una acción específica, como se retorna cuando se obtiene Datos de Acciones 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_value])/actions([ID_action]/execute)

Mientras que para proyectos Bizagi Cloud, esta URL sería:

https://[ambiente_del_proyecto]-[su_proyecto]-[su_compañia].bizagi.com/odata/data/stuff([ID_stuff])/values([ID_value])/actions([ID_action]/execute)

 

Ejemplo

Para disparar una acción que empieza un nuevo caso, la URL descrita anteriormente es invocada por medio de una petición HTTP POST.

Considere incluir la siguiente estructura JSON para enviar parámetros:

{

      "startParameters": [

       {

           "xpath": "[nombre_xpath]",

           "type": "[tipodato_xpath]",

           "value": "[valor_para_xpath]"

       }

   ]

}

 

Siendo:

[nombre_xpath]: El XPath exacto esperado por los parámetros de la acción que inicia el proceso.

[tipodato_xpath]: El tipo de dato como lo espera cada parámetro.

[valor_para_xpath]: El valor que le quiere asignar a ese parámetro XPath.

 

Si tiene mas de un parámetro, usaría:

{

      "startParameters": [

       {

           "xpath": "[nombre_xpath1]",

           "type": "[tipodato_xpath1]",

           "value": "[valor_para_xpath1]"

       },

       {

           "xpath": "[nombre_xpath2]",

           "type": "[tipodato_xpath2]",

           "value": "[valor_para_xpath2]"

       }

   ]

}

 

Del mismo modo, si no hay parámetros, usaría:

{

 "startParameters": [

 ]

}

 

La siguiente imagen ilustra la información que se puede enviar en una petición HTTP POST y la respuesta que se obtiene que indica el número del caso del caso recién creado (en value):

 

OData_SActionExecR

 

Esta otra imagen muestra una invocación previa con los parámetros que la acción espera (como se necesita enviar el tipo exacto de dato y la información del XPath que corresponde):

 

OData_SActionQuery

 

Formatos específicos

Consulte los siguientes enlaces para casos de uso específicos:

Para filtrar la búsqueda con parámetros, tenga en cuenta las anotaciones para los diferentes tipos de datos, como se describen en Tipos de datos en las respuestas OData de Bizagi.

Para obtener de manera dinámica los valores de negocio que pueda necesitar como parámetros de entrada para iniciar un proceso nuevo o completar una actividad, consulte los Valores de entidades relacionadas.

Para obtener de manera dinámica las columnas que necesita llenar cuando se envian registros nuevos en colecciones, consulte Columnas en colecciones.

Para conocer cómo construir un formato compatible a lo que se espera cuando se envian fechas, imágenes o adjuntos, o campos booleanos, consulte Enviar parámetros de entrada.