Getting Started with Human Task Manager (HTM)
Requisitos previos
Esta guía de inicio para usar Human Task Manager asume que tienes acceso a lo siguiente:
-
Un servidor HTM: está disponible como una imagen de docker de Icon.
-
El Operational Dashboard: está disponible como una imagen de docker de Icon.
-
Un flujo que ya incluye las IPF Business Functions. Puedes encontrar más detalles sobre cómo añadir business functions a tu flujo aquí.
Integración con un flujo
La business function de HTM está diseñada para permitir una interacción sencilla entre un proceso de flujo de IPF y la aplicación HTM. Proporciona la capacidad de definir las características principales de una tarea dentro del DSL, de modo que se puedan crear tareas y devolver códigos de respuesta a medida desde cualquier punto de tu flujo.
Definir una tarea de HTM
Para definir una tarea para HTM, necesitamos definir una 'HTM Request' dentro de nuestro flujo. Para ello usamos el lenguaje específico de HTM; funciona igual que el lenguaje principal, excepto que aparecerá en la carpeta de ese lenguaje:
El componente principal aquí es la 'HTM Request Library'. Se comporta de manera similar al componente de dominio externo, ya que crear una proporcionará tanto las solicitudes como las respuestas que necesitas para interactuar con el sistema HTM. Vamos a crear una nueva librería ahora y deberías ver:
Ahora podemos definir el nombre y dar una descripción a nuestra librería. Luego podemos añadir una nueva HTM Request: cada HTM request representa un tipo de tarea diferente que queremos enviar al HTM Server. Hay varias propiedades que proporcionar al definir la solicitud:
-
Name: se proporcionará a HTM como el 'task type'.
-
Description: solo informativo.
-
Priority: se proporcionará a HTM como la 'task priority'. Es un valor entero.
-
Required Approvals: se proporcionará a HTM como las |required approvals for the task|.
-
Ignore Tech Response: permite que el flujo se enganche a la respuesta HTTP de la solicitud inicial de creación de la tarea. Si no es necesario, puede ignorarse y solo se devolverá al flujo el resultado final de la finalización.
-
Response Codes: es el resultado disponible dentro de la aplicación HTM.
-
Business Data: son los datos de negocio que se empaquetarán y enviarán a HTM.
-
MetaData Tags: son etiquetas personalizadas y opcionales que se pueden adjuntar a la HTM Request.
Usar una tarea de HTM
Una HTM Task se usa exactamente igual que un par solicitud/respuesta de un dominio externo tradicional. La tarea se crea simplemente llamando a la HTM Request como una acción en cualquier punto del flujo.
Después, podemos usar la entrada de respuesta coincidente resultante.
Proporcionar una implementación
Una vez que hayamos configurado la integración del flujo, necesitamos proporcionar la implementación. Lo hacemos simplemente añadiendo la siguiente dependencia:
<dependency>
<groupId>com.iconsolutions.ipf.businessfunctions.htm</groupId>
<artifactId>ipf-human-task-manager-floclient-service</artifactId>
</dependency>Desde el punto de vista de la configuración, simplemente necesitamos especificar dónde se está ejecutando nuestra implementación del servidor HTM. Esto se hace estableciendo las siguientes propiedades:
ipf.htm.request-reply.starter {
http.client {
host = "localhost"
port = 8083
}
register-task.enabled = true
cancel-task.enabled = false
}