Integración con sistemas de terceros
En este modelo de integración, todos los pasos del proceso se realizan con datos almacenados exclusivamente en la nube de BPM. Cuando algún paso está configurado con mecanismo de atribución Usuario de la tercera aplicación, el sistema de terceros tendrá disponible una API para consumir los datos de la solicitud en curso. Cada vez que un proceso configura un paso con el tipo de motor de aplicación Usuario de aplicación externa, el proceso ya está esperando que la tercera aplicación responda al paso para continuar con el flujo del proceso.
El siguiente diagrama ejemplifica la integración de una aplicación de terceros, que de vez en cuando, de acuerdo con las necesidades del proceso desarrollado, consume solicitudes de terceros completadas por usuarios de BPM:
Consumo de solicitudes de terceros
Siempre que un evento mueva un proceso BPM, la información de la tarea y el estado de la tarea se actualizarán con los siguientes estados.
- Pendiente: la solicitud fue creada por BPM y aún no ha sido finalizada o cancelada;
- Tratado: la solicitud ha sido completada;
- Todos: todas las solicitudes de terceros con el usuario de la aplicación externa.
Para integrarse con el backend de un sistema de terceros, el desarrollador debe consultar y responder a la solicitud de integración.
Integración con Senior G5
Las API getThirdPartyRequestByStatus y pendencia de respuesta se puede utilizar en reglas LSP (Lenguaje de programación superior), utilizando las funciones HttpPost para llamadas API REST yListRuleLoadJson y ListRuleGetValueAlpha para manejar la devolución de datos en formato JSON.
Para programar el consumo de solicitudes de BPM, se recomienda la función de programación web de G5 o la programación de servicios web.
Qué puedes hacer:
Habilite la función de integración bajo demanda
Para habilitar la función de integración de solicitudes utilizando la opción de integración en el espacio de trabajo del proceso, ingrese los campos a continuación:
- Habilitar la integración de solicitudes: indica si la integración está habilitada, es decir, comienza a generar registros para el consumo de la API (getThirdPartyRequestByStatus);
- Clave de proceso para aplicación de terceros: es el identificador único del proceso. Debe usarse para consultar las tareas/solicitudes.
Consultar temas pendientes para la integración
Para consultar las solicitudes, ingrese la clave del proceso, configurada en el área de trabajo del proceso, y el estado.
- Consultar solicitudes pendientes:
Ejemplo:
POST /resto/plataforma/flujo de trabajo/consultas/getThirdPartyRequestByStatus
{ "clave de proceso":"ERP_REGISTRO DEL PRODUCTO”, “estado":"En progreso ” }
- Consulta de asuntos pendientes ya integrados:
Ejemplo:
POST /resto/plataforma/flujo de trabajo/consultas/getThirdPartyRequestByStatus
{ "clave de proceso":"ERP_REGISTRO DEL PRODUCTO”, “estado":"terminado” }
La devolución de este servicio será una lista de solicitudes con detalles de las variables de proceso utilizadas en la integración:
{ "peticiones": [{ "token de flujo": { "ID de instancia de proceso": 806,"paso": 4,"ID de actividad": 6}," procesar datos": { "escribe": "Persona jurídica ", "Nombre": "SENIOR LTDA" } }, { " token de flujo ": { " ID de instancia de proceso ": 329," paso ": 4," ID de actividad ": dos }, " procesar datos ": { " escribe ": " Persona jurídica ", " Nombre ": "OFICINAS DE CORREO" } } ] }
A continuación se muestra un desglose de la estructura JSON devuelta por el servicio:
| Campo | Descripción |
|---|---|
| token de flujo/ID de instancia de proceso | Número de solicitud de proceso |
| token de flujo/paso | Identificador de paso de proceso interno |
| token de flujo/ID de actividad | Identificador de actividad de proceso interno |
| procesar datos | Lista de valores clave con variables de proceso |
Responder a solicitudes por aplicación externa
Solo es posible responder a tareas de aplicaciones de terceros si está en un paso como usuario de una aplicación externa.
- Responde a la solicitud número 806 llamando a la acción de terminación:
Ejemplo:
POST /rest/plataforma/workflow/actions/responsePendency
{ "token de flujo de servicio": { "ID de instancia de proceso": 806," paso": 4,"ID de actividad": 6} "datos de respuesta" : { "datos de ejecución de flujo " : { " actionToExecute" : "finalizar" } } }
Cuando el flujo está en un paso de aplicación externa, no se puede utilizar con usuarios de la plataforma. Es necesario tener una clave de aplicación que represente el sistema de terceros para responder a la tarea.
English
Español
