Introducción
Bizagi ofrece un servicio OData que maneja aspectos de Asistente de Personas.
Por medio de la URI de Relevantes, puede manejar información relacionada a la sección Relevantes para mí de las Personas, como se menciona en Datos de Relevantes para Mí.
Esta sección describe cómo iniciar un nuevo caso para un Proceso relevante.
URL del Recurso
Empiece con la siguiente URL:
[url_del_proyecto_bizagi]/odata/data/relevants([ID_relevante])/start
Donde:
•[ID_relevante]: El ID para un Proceso Relevante, como se retorna cuando se obtienen Datos de Relevantes para Mí.
•[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/relevants([ID_relevante])/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]",
"type": "[tipodato_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.
•[tipodato_XPath]: El tipo de dato para ese XPath, como se espera para cada parámetro.
•[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]",
"type": "[tipodato_xpath1]",
"value": "[valor_para_xpath1]"
},
{
"XPath": "[nombre_xpath2]",
"type": "[tipodato_xpath2]",
"value": "[valor_para_xpath2]"
}
]
}
De la misma manera, si no se esperan parámetros, usaría:
{
"startParameters": [
]
}
|
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):
Esta otra imagen muestra una invocación previa con los parámetros que el proceso 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:10:12 PM