Introducción
Bizagi ofrece un servicio OData que maneja aspectos del Asistente de Personas.
Por medio de la URI Cosas, puede manejar información respecto a la sección Mis Cosas para la Persona autenticada, 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.
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_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):
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):
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:09:58 PM