Expresión

Una expresión en BOLD funciona de forma similar a como funciona en el Excel: se trata de una fórmula que se evalúa retornando uno o más valores.

Las fórmulas o expresiones se utilizan para personalizar todo tipo de información dentro de la aplicación.

1 Utilización de expresiones o fórmulas

Por ejemplo para efectuar las siguientes cosas:

• Personalizar columnas de informes (ExtAttribute)
• Personalizar la información que aparece al pulsar en diferentes objetos de la aplicación (ej.: en el diagrama de Gantt)
• Personalizar los contadores anuales y de cálculo de nómina
• Personalizar alertas en la aplicación y en el portal (KPI)
• Personalizar el comportamiento antes determinadas acciones del usuario
• etc…

2 Sintaxis de una expresión

Un ejemplo de expresión es el siguiente código:

IfElse(PreferentNeed.32DatosEvaluacion1.IdJefe!=0, "SI", "NO")

Una expresión se evalúa siempre dentro de un contexto. El contexto significa simplemente que existen una seria de variables predefinidas cuyo valor es directamente accessible.

Dentro de una expresión pueden aparecer:

• Referencias a atributos de los objetos del sistema (ej.: CustomProps.M30DatosEmpleado.IdCW.PreferentNeed2.ID accedería a la propiedad ID del objeto IdCW)
• Otras funciones (ver funciones)
• Atributos implícitos del objeto de contexto (ej.: Name o Description)
• Variables globales publicadas el contexto de evaluación (ej.: @From o @To)
• Comentarios: los comentarios empiezan con /* y terminan con */. En expresiones del tipo IfElse anterior con varios niveles o condiciones lógicas complejas vale la pena utilizar la sintaxis de este ejemplo.

3 Tipo devuelto por una expresión

Debe ser uno de los definidos en Tipos de datos (Type).

4 Acceso a los atributos de los objetos del sistema

Una expresión puede referenciar atributos de los objetos del sistema asociadas a los objetos de contexto. El acceso a estos atributos se efectúa ‘navegando’ por las referencias de los objetos disponibles en el contexto de evaluación de la expresión utilizando el operador de “.” En el ejemplo anterior, suponiendo que el contexto fuera un objeto de tipo contrato (ContractWorker) se está accediendo al atributo necesidad preferente del contrato y se comprueba si existe, y en ese caso se retorna el valor “SI”.

5 Tipo Link y acceso a atributos cuando la referencia no es válida

Una referencia a un objeto del sistema internamente se representa mediante el tipo de datos Link.

Si no estamos seguros de que la referencia al objeto sea válida y se intenta acceder a alguna de sus propiedades la expresión generará un error. Para controlar los errores es necesario verificarlo mediante una condición como la siguiente:

CustomProps.M30DatosEmpleado.IdCW.PreferentNeed2.ID != 0

La condición anterior será verdadera cuando PreferentNeed2 apunte a un objeto inexistente (sea NULL).

6 Otros enlaces de interés

Prueba de expresiones

Configuración de columnas en informes

Lista de funciones