Permite crear o dar de alta un nuevo agente en el sistema.
Para acceder a esta operación se debe hacer clic sobre la opción “Crear Agente” del submenú “Agente” en el menú de operaciones del módulo de configuración, o bien seleccionar dicha opción desde la búsqueda rápida del menú, ingresando la palabra “agente”.
El procedimiento a seguir es el siguiente:
1.Ingresar el código del agente que se desea dar de alta.
2.Al presionar “Aceptar”, se presenta la siguiente pantalla:
En la cual se deben ingresar:
•Tipo de agente. Obligatorio.
•Descripción del agente. Obligatorio.
•Ejecutor o clase Java. Opcional
•Parámetros de ejecutor o clase Java. Opcional.
3.Dependiendo del tipo de agente a dar de alta, se deben cumplir las siguientes condiciones (se especifican de acuerdo a cada tipo de agente):
-No debe existir previamente un agente con el código ingresado.
-Todos los datos obligatorios deben estar informados.
•Si tipo de agente es Clase Java.
Se invoca a una clase Java, que debe ser subclase de BTWorkflowAgentExecutor
Ejecutor:
Se utiliza el campo Ejecutor para especificar el nombre de la clase a invocar.
El paquete que contiene la clase puede especificarse en el mismo campo ejecutor. Por ejemplo, se podría informar
“com.consist.workflow.common.agents.BTAgentExeSpecificActivity”
Caso contrario, si no se informa el paquete, Deyel verificará la existencia de la clase dentro del paquete especificado en la variable PACKAGE_AGENTS.
Parámetros de la clase:
Presionando este icono se despliega un asistente que analiza los parámetros indicados en la clase a ejecutar y asiste al usuario en su configuración.
•Si tipo de agente es Regla de Negocio.
Se invoca a una regla de negocio que debe estar definida y en uso en el sistema.
Se utiliza el campo Ejecutor para especificar el nombre y versión de la regla a invocar, separando estos datos por un carácter ‘-‘.
Ejemplo: DeyelAgentExample-1
Parámetros de la regla:
Esto dependerá de la definición de la regla a utilizar. En principio la regla deberá tener como mínimo los siguientes parámetros:
TRES parámetros de salida:
'participantCodes'
De tipo java.util.List o compatible, para indicar los códigos de los participantes seleccionados.
'participantTypes'
De tipo java.util.List o compatible, para indicar los tipos de los participantes seleccionados, correspondientes con la lista anterior (solamente se admiten USER, ORG_UNIT y ROLE).
'errors'
De tipo java.util.List o compatible, para indicar mensajes de error en caso de ser necesario.
CUATRO parámetros de entrada:
'caseNumber'
De tipo java.lang.String donde recibe el número de caso en ejecución.
'process'
De tipo java.lang.Integer donde recibe el código de proceso del caso en ejecución
'processVersion'
De tipo java.lang.String donde recibe el código de versión de proceso del caso en ejecución
'activity'
De tipo java.lang.Integer donde recibe el código de actividad para la cual se evalúa el agente.
Otra forma de obtener en la regla datos del caso y su ejecución es utilizando un adaptador de regla que defina un contexto de tipo
com.consist.seguridad.server.BT.agent.ExecutionContextWorkflowAgentRule.
La regla puede tener parámetros de entrada adicionales, y en ese caso, se especifican en la sección de parámetros.
Presionando este icono se despliega un asistente que analiza los parámetros indicados en la regla a ejecutar y asiste al usuario en su configuración.
El formato general es un par [param]=[value] por línea.
Donde [param] es el nombre de alguno de los parámetros y [value] puede ser un valor fijo o una variable del workflow (que se evaluará con información del caso actual al momento de la ejecución). Por ejemplo: pCdUser=|ONLINE-USER|
•Si el tipo de agente es Participante Explícito.
Un agente de este tipo indica explícitamente los participantes que determina.
No requiere ejecutor, pero es obligatorio definir parámetros en los cuales se indica/n el/los participante/s que devolverá como resultado.
Para configurar dicho agente será necesario indicar una serie de parámetros que indiquen el código de participante y su tipo. Para todos los casos, tanto participantCode como participantType, deben encontrarse en líneas diferentes del texto. Los parámetros deben ser especificados de la siguiente forma:
participantCode[X]=[expresiónA]
participantType[X]=[expresiónB]
Donde:
-[X] es un número desde 1 a N para especificar varios participantes.
-[expresiónA] es una expresión que puede ser una constante o una variable del workflow, y que definirá el código de participante.
-[expresiónB] es una expresión que debe especificar el tipo de participante, siendo posible los siguientes valores: USER, ORG_UNIT o ROLE.
Por ejemplo, en el caso que sea necesario incluir más de un participante en el agente que se está definiendo, debe realizarse de la siguiente forma:
participantCode1=[expresiónA1]
participantType1=[expresiónB1]
participantCode2=[expresiónA2]
participantType2=[expresiónB2]
.
.
participantCodeN=[expresiónAN]
participantTypeN=[expresiónBN]
Ejemplo:
Hay algunos aspectos a tener en cuenta al momento de definir los valores de los parámetros:
-Si el valor de participantCode[X] es vacío, no se considera el participante.
-Si el valor de participantType[X] es vacío, se buscará el participante existente en el orden USER, ORG_UNIT o ROLE.
Para que la parametrización sea válida siempre debe existir la propiedad participantCode[X] y participantType[X] por cada participante.
En caso de múltiples participantes la numeración debe ser correlativa.
4.Una vez ingresados los datos correspondientes, pulsando el botón “Aceptar”, se visualizará la pantalla de confirmación.
5.Si los datos son correctos, pulsando el botón “Confirmar” se realiza efectivamente la operación y se muestra una pantalla informando el resultado de la operación realizada.
•En el caso que el agente represente un recurso, como por ejemplo una máquina, software o programa se le puede definir un coordinador. Este coordinador del recurso puede ser un usuario determinado, una unidad organizacional o un rol.
