Cómo funciona el catálogo de fórmulas
Conceptos básicos
El catálogo de fórmulas es una biblioteca pública de fórmulas gestionada por UI. Le permite crear su propia colección de fórmulas, para utilizarlas posteriormente en otras fórmulas.
Cada fórmula tiene un nombre único o identificador, que no se puede repetir en otro contexto ni producto. Junto al identificador se almacena el propio código fuente de la fórmula, y otra información adicional como la descripción, los parámetros y el tipo de retorno.
El catálogo está organizado con la siguiente estructura jerárquica: producto, contextos y fórmulas.
El contexto General es un contexto genérico siempre disponible, y en el que puede añadir sus fórmulas. El uso de otros contextos está ligado a usos específicos en el ámbito de una aplicación. En este caso, la propia aplicación provee el contexto adecuado para poder agregar en él sus fórmulas.
Para acceder a la herramienta, desde Sistema y Herramientas de usuario; en Catálogo de fórmulas.
Funciones básicas
Después de seleccionar el producto y el contexto en el que desea crear la fórmula (puede seleccionar uno existente o crear un nuevo, situándose sobre Repositorio, mediante el botón secundario del ratón), puede crear una nueva fórmula, situándose sobre éste, mediante el botón secundario del ratón.
Puede indicar el nombre y la descripción de la fórmula, seleccionar el tipo de retorno, los tipos de parámetros, la ayuda de los parámetros y el código fuente de la fórmula.
Funciones avanzadas
Para usar una fórmula del catálogo dentro de otra fórmula, esté catalogada o no, basta con escribir el nombre de la fórmula con el prefijo "@" y el sufijo "()". Su uso es muy parecido a las funciones predefinidas del sistema añadiendo la arroba como prefijo.
Por ejemplo, una fórmula que usa una hipotética fórmula catalogada de nombre "pi": "@pi()".
Al definir la fórmula es importante especificar el tipo de retorno en la casilla Retorno, con las opciones siguientes: Número entero, Número con decimales, Texto, Moneda, o bien Fecha.
Es posible definir una fórmula que admita parámetros. Para ello es necesario indicar los campos Parámetros yAyuda parámetros con los siguientes valores:
- Parámetros. Indique los tipos de los parámetros separados por coma. Los tipos se indican con los literales int, double, string, currency o date, dependiendo de cuál sea su tipo de datos.
- Ayuda parámetros. Indique la ayuda (multiidioma) de cada uno de los parámetros, con el formato "Nombre parámetro 1=Descripción1,Nombre parámetro 2=Descripción2,...".
Los parámetros son anónimos, no tienen nombre. Para acceder a los parámetros desde el interior de la fórmula se deben usar las variables especiales pN, donde N es el ordinal del parámetro definido: 1 para el primero, 2 para el segundo, etc.
Por ejemplo, se define la función suma(), que acepta dos parámetros de tipo entero. La fórmula retorna la suma de ambos valores.
- Fórmula. Suma
- Descripción. Suma de dos valores enteros
- Retorno. Número entero
- Parámetros. int,int
- Ayuda parámetros. Número1=Primer sumando,Número2=Segundo sumando
- Fórmula. p1+p2
Desde otra fórmula suma(), se usa de la siguiente manera: "@suma(2, 3)".
Cada una de las fórmulas del catálogo están sujetas a los mecanismos de seguridad estándar. Esto permite asignar permisos de lectura, modificación, ejecución o eliminación para cada usuario individual.