Base de Conocimientos

Campos de la fórmula

El valor de un campo personalizado con fórmula es calculado automáticamente por Celoxis basándose en su fórmula. El valor se calcula cada vez que se visualiza el campo. El lenguaje de expresión de fórmulas es sofisticado, por lo que puede realizar manipulaciones de datos complejas, incluidas transformaciones aritméticas, de cadenas y de fechas.

Sintaxis

El operador de puntos

Operadores

• Aritmética: +, - (binario), *, / y div, % y mod, - (unario)
• Concatenación de cadenas: +=
• Lógico: y, &&, o, ||, no, !
• Relacional: ==, eq, !=, ne, <, lt, >, gt, <=, ge, >=, le. Se pueden hacer comparaciones con otros valores o con literales booleanos, de cadena, enteros o de coma flotante.
• Vacío: El Vacío es una operación prefijada que se puede utilizar para determinar si un valor es nulo o vacío.
• Condicional: A ? B : C. Evaluar B o Cdependiendo del resultado de la evaluación de A.
• Asignación: =
• Punto y coma: ;

• [] .
• () (utilizado para cambiar la precedencia de los operadores)
• - (unario) ¡no! vacío
• * / div % mod
• + - (binario)
• +=
• < > <= >= lt gt le ge
• == != eq ne
• && y
• || o
• ? :
• =
• ;

Palabras reservadas

Ejemplos básicos

Funciones de utilidad

Se ha proporcionado el siguiente conjunto de funciones de ayuda:

• Formato
• Matemáticas
• Cadena
• Fecha
• Colección

Escribir fórmulas multilíneas

Para escribir el código de la fórmula en una línea múltiple, utilice la tecla = y ; operadores. El valor de retorno es el último enunciado de la fórmula. Por ejemplo:

${
apc = me.actualPercentComplete;
ppc = me.plannedPercentComplete;
(apc - ppc)/ppc
}

El tipo de datos de retorno de la fórmula

Mientras se define una fórmula, se debe seleccionar un Tipo de datos de la fórmula. Esto le dice al sistema lo que debe esperar que la fórmula devuelva. Celoxisformatea el valor de retorno automáticamente basado en el tipo de datos. Por ejemplo, si indica que el tipo de retorno es una moneda, entonces si su fórmula devuelve un número 10000el resultado sería $10,000 es decir, Celoxisautomáticamente formatea el número y lo prefija con el símbolo de la moneda de la empresa.

El me Objeto

El me El objeto en la fórmula representa el objeto para el cual la fórmula está siendo evaluada. Por ejemplo, digamos que nuestro campo de la fórmula Avance del cliente se define como ${me.budget * 0.1} es decir, representa el 10% del presupuesto. Si hemos adjuntado este campo tanto a los proyectos como a las tareas, entonces al evaluar la fórmula de un proyecto, el me sería un proyecto mientras que para una tarea sería un objeto de tarea.

Referencia de campo

Para ver la lista de campos disponibles, haga clic en la pestaña Referencia de Campo en la pantalla de añadir/editar campo personalizado. Haga clic en el icono más para expandir la lista de variables disponibles para las diferentes entidades.

Tratamiento de errores

Cuando se produce un error al evaluar una fórmula, por ejemplo, si se ha introducido un número en lugar de una cadena, la salida mostrará lo siguiente ERR!. Mueva el ratón sobre él para obtener una mejor descripción del problema.

Ejemplos

Supongamos que tenemos un proyecto con los siguientes datos.

Ahora veremos algunos ejemplos sencillos. Supondremos que la fórmula se adjunta a los proyectos y que el resultado de la muestra es para el proyecto descrito anteriormente.

Ejemplo Avanzado: El indicador de salud de su propio horario

Digamos que usted quiere tener un indicador de salud del programa que se basa en líneas base, es decir, la fecha que realmente prometió al cliente en lugar de la fecha de finalización del plan actual.

Creará un campo de fórmula, lo adjuntará a los proyectos, establecerá su tipo de datos de salida en Texto e introducir la fórmula como:

${
pc = me.actualPercentComplete;
pFinish = me.projectedFinishCalendar;
bFinish = me.baselineFinish;
now = Date.now();
label = 'Unknown';
label = Date.before(pFinish,  bFinish) ? 'On Time' : label;
label = Date.after(pFinish, bFinish) ? 'At Risk' : label;
label = Date.after(now, bFinish) ? 'Overdue' : label;
label = pc == 100 ? 'Completed' : label;
label
}

En la parte de Color de la fórmula ponga las asignaciones como: