Datos para el inicio de procesos

<< Clic para mostrar Tabla de Contenidos >>

Navegación:  Automatización de Procesos con poco código > Studio Cloud -ambiente de autoría > Bizagi Studio > Bizagi desde aplicaciones externas > API de Bizagi para aplicaciones externas > Servicios RESTful OData > Ejemplos del API de Bizagi > Ejemplos de Servicios de Datos > Datos de Proceso >

Datos para el inicio de procesos

Introducción

Bizagi ofrece un servicio OData que maneja aspectos de Asistente de Personas, como se explica en Servicios de datos.

Por medio de la URI de Procesos, puede manejar información relacionada los Procesos de un usuario (no necesariamente Persona), como se describe en Datos de proceso.

Esta sección describe cómo iniciar casos para un proceso dado.

 

URL del recurso

Empecemos con la siguiente URL:

[your_bizagi_project_url]/odata/data/processes([ID_proceso])/start

 

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.

Para proyectos Automation Service, esta URL sería:

https://[ambiente_del_proyecto]-[su_proyecto]-[su_compañía].bizagi.com/odata/data/processes([ID_proceso])/start

 

Ejemplo

Para iniciar un nuevo caso, la URL descrita anteriormente es invocada por medio de un HTTP POST.

Incluya la siguiente estructura JSON para enviar los parámetros:

{

      "startParameters": [

       {

           "xpath": "[nombre_xpath]",

           "value": "[valor_para_xpath]"

       }

   ]

}

 

Donde:

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

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

 

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

{

      "startParameters": [

       {

           "xpath": "[nombre_xpath1]",

           "value": "[valor_para_xpath1]"

       },

       {

           "xpath": "[nombre_xpath2]",

           "value": "[valor_para_xpath2]"

       }

   ]

}

 

De la misma manera, si no se esperan parámetros, usaría:

{

 "startParameters": [

 ]

}

 

note_pin

Estos parámetros se toman de la forma de inicio del proceso.

De lo contrario y si no se ha definido forma de inicio, entonces los parámetros serán en blanco.

 

La siguiente imagen ilustra la información que puede enviar en una acción HTTP POST y  la respuesta que obtendría indicando el número del caso para el caso creado (dentro de valor):

 

OData_ProcessesStart_user

 

 

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 envían registros nuevos en colecciones, consulte Columnas en colecciones.

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


Last Updated 1/23/2023 12:10:22 PM