Cómo usar las variables del proceso
Conceptos básicos
En un diagrama es posible definir un conjunto de variables globales de proceso.
Las propiedades de una variable de proceso son las siguientes:
- Nombre. El nombre interno que identifica la variable.
- Descripción. La descripción de la variable.
- Tipo de dato. El tipo de dato de la variable pudiendo ser uno de los siguientes: currency, date, double, integer o text.
- Tipo de valor por defecto. Con cada nueva instancia de proceso se crean las variables y se inicializan sus valores. Con esta propiedad se indica cómo debe obtenerse el valor inicial de la variable, pudiendo ser uno de los siguientes:
- Campo. Toma el valor de un campo del objeto de negocio.
- Variable de entorno. Toma el valor de una variable de entorno, variable del objeto de negocio.
- Variable de entorno global. Toma el valor de una variable de entorno, variable global.
- Constante. Toma un valor constante. En este caso el tamaño máximo permitido es de 512 caracteres.
- Atributo. Toma el valor de un ítem del objeto de negocio que esté asignado al atributo indicado.
- Valor por defecto. El propio valor dependiendo de su tipo.
- KPI. Esta variable está asignada a un indicador KPI con lo que es caso de que se haya activado se recolectarán en el histórico de KPI el valor inicial de la variable al iniciar el proceso y su valor final al finalizar el proceso.
Además...
¿Dónde se hace uso de las variables del proceso?
Las variables del proceso se usan en distintos puntos:
- En el enlace con los parámetros de entrada y salida de las actividades automáticas. Los valores de las variables pueden cambiar después de la llamada a una actividad automática.
- En el enlace con las variables de un subproceso. Los valores de las variables pueden cambiar después de la llamada a un subproceso.
- En la construcción de las expresiones de una bifurcación.
- En una personalización de mensaje de una actividad manual; el token LMV.VarName permite referenciar al valor de la variable VarName.
¿Cómo actualizar una variable desde un script de un diagrama?
Desde programación la clase LMEvent ofrece los servicios getProcessVariable(String key) y setProcessVariable(String key, String value) para manipular los valores de una variable.
Las variables del proceso se pueden manipular desde un script asociado al diagrama. Entorno de modelado. Conformado por el Editor de scripts. Para acceder a la herramienta, desde Studio, en la vista Script View, seleccione el producto deseado, en la carpeta Business Navigator, se tiene acceso a la lista de scripts definidos, siendo posible consultar, modificar, añadir nuevos, etc.
Para añadir un nuevo script, sobre la carpeta Business Navigator seleccionar la acción New object y en el diálogo de New script seleccionar objeto de negocio y Finish.
Ejemplo de script asociado al diagrama ksk_dgcustomrisk:
package lm;
import com.unit4.karat.base.OTException;
import com.unit4.karat.bo.BOObject;
import com.unit4.karat.lm.LMEvent;
import com.unit4.karat.session.Session;
public class ksk_dgcustomrisk extends com.unit4.karat.lm.LMDefaultEvents {
public ksk_dgcustomrisk(Session session) {
super(session);
}
@Override
public void doAction(LMEvent lmEvent) throws OTException {
if ("tracustommanko".equals(lmEvent.getAction())) {
lmEvent.setProcessVariable("customerrisk", "1");
}
}
}Temas relacionados
Cómo añadir una actividad manual
Cómo añadir una actividad automática