Atajando

Esta es una recopilación de cosas útiles que se han ido viendo durante los ejemplos, pero que no son del todo fáciles de encontrar.

Fecha del sistema

import java.time.LocalDateTime; 

????.fecha = LocalDateTime.now(); 

El tipo concreto de fecha (java.time.*) depende de lo elegido para el atributo de la variable de negocio o la variable de proceso. Por ejemplo:

import java.time.LocalDate; 

????.fecha = LocalDate.now(); 

Id del iniciador del proceso

Este código se puede obtener de "plantillas de código" (processInitiatorUser) al escribir un script en Bonita

def processInitiator = apiAccessor.getIdentityAPI().getUser(apiAccessor.getProcessAPI()

.getProcessInstance(processInstanceId)

.getStartedBy()) 

Con esto obtenemos el identificador del usuario que ha iniciado el proceso —Walter Bates en nuestro entorno de desarrollo—. Con él podemos acceder a su información personal, por ejemplo:

???? = processInitiator.firstName+" "+processInitiator.lastName

Acceder a datos personales del usuario

Quién es el usuario que está ejecutando el formulario

../API/system/session/1 

Con esta expresión tenemos acceso, entre otros, a .user_id y .user_name. (doc)

Acceso a los datos de usuario

../API/identity/user/{{idusuario}}

Ese idusuario se obtiene bien de la variable definida con la API externa anterior, bien porque se dispone previamente de él —una variable de negocio, por ejemplo—. Si suponemos que tenemos una variable de formulario usuario, la expresión sería

../API/identity/user/{{usuario.user_id}}

Nos proporciona, entre otros, .firstname y .lastname. (doc)

Acceso a las variables de negocio

Dependiendo de cómo esté diseñado nuestro proceso, en algunas tareas no tendremos acceso directo a las variables de negocio en el formulario. Si queremos recuperarlas para mostrar algunos datos para ofrecer una información más completa, necesitamos una variable —la hemos llamado misdatos pero tú pondrás el nombre que quieras—:

nombre: misdatos

tipo: External API

API URL: ../{{context.mivn_ref.link}}

Se supone que mivn es el nombre de la variable de negocio a la que queremos acceder.

Acceso a las variables de un caso

Parecido al anterior, pero nos permite recuperar las variables de proceso. (doc)

nombre: misdatos

tipo: EXTERNAL API
valor: ../API/bpm/caseVariable/{{task.caseId}}/mivariable

Se supone que mivariable es el nombre de la variable de proceso a la que queremos acceder. Nos devolverá un JSON con estas propiedades:

{

  "description":"Detailed description of the case variable, as set in the definition at design-time",

  "name":"name of the variable in the case",

  "value":"the current value of the case variable",

  "case_id":"ID of the case this variable belongs to",

  "type":_the Java type of the variable"

}

Por lo que, si solo queremos el valor, deberemos acceder a misdatos.value.

Se supone que tenemos definida una variable de proceso mivariable, y que el formulario dispone, además, de las variables

nombre: taskId

tipo: URL

valor: id

y

nombre: task

tipo: EXTERNAL API

valor: ../API/bpm/userTask/{{taskId}}

Por lo tanto, estamos en un formulario de una tarea y, por lo general, esas dos últimas variables ya nos las pone Bonita. La variable task la necesitamos porque nos informa del identificador de caso.

Acceso a las variables de una tarea

Muy parecido al anterior, igualmente tenemos acceso a las variables de proceso —no a las de negocio— y a las variables locales de una tarea.

../API/bpm/activityVariable/{{taskId}}/nombreVariable

Consultar un BDM

Podemos consultar cualquier modelo de datos de negocio desplegado (doc), por ejemplo:

tipo: EXTERNAL API

valor: ../API/bdm/businessData/unBDM?q=find&p=0&c=100

Donde unBDM será algo parecido a com.company.model.mibdm.

Los widget select son listas deplegables que muestran texto y asignan un valor. Por lo general, estarán asociados a listas generadas desde Bonita, una consulta de base de datos, por ejemplo, pero puede que necesitemos crear una por nuestra cuenta para elegir desde una lista de opciones propias.

Supongamos que esa lista es [1, 2, 3] pero que, para que sea más entendible, queremos asociar cada valor con un texto descriptivo. Sea, entonces, [{"primera opción":1}, {"segunda opción":2}, {"tercera opción":3}].

En primer lugar necesitas una variable de formulario de tipo JSON, supongamos que la llamamos vLista, y con el siguiente contenido:

[

    {"etiq":"primera opción", "valor":1},

    {"etiq":"segunda opción", "valor":2},

    {"etiq":"tercera opción", "valor":3}

] 

El resumen es que un widget de este tipo se nutre de un JSON en el que especificamos una lista de pares (clave mostrada, clave de retorno) del tipo que queramos, texto o número. 

La clave mostrada no es imprescindible, pero sí la de retorno. Nuestro JSON podría ser solo una lista de (clave retorno), y la utilizaríamos tanto para lo mostrado como lo retornado.

Cambiar tipo de widget

El botón "cambiar" está desactivado. Para activarlo, y pulsarlo, debemos pulsar primero "mostrar propiedades", aunque no vayamos a modificar nada.