Variables
Las variables permiten almacenar y utilizar información adicional durante la generación de un listado.
La mayor parte de la información utilizada por una plantilla se obtiene directamente de los campos de los modelos de registro. Sin embargo, las variables permiten trabajar con datos que no proceden directamente de estos campos, por ejemplo, para almacenar resultados parciales, realizar cálculos, controlar determinadas acciones mediante guiones o recoger información introducida a través de diálogos.
Las variables pueden utilizarse en diferentes elementos de la plantilla, como objetos alfanuméricos, guiones y diálogos. No obstante, no es necesario que estén asociadas a un objeto de la plantilla, ya que también pueden emplearse internamente para realizar cálculos o controlar el funcionamiento del listado.
El Editor de Plantillas de Listado permite trabajar con variables de la plantilla y variables almacenables.
| Nota: |
|---|
| Los campos de registro proporcionan información procedente de los modelos de registro y no pueden modificarse mediante los guiones. Las variables, en cambio, pueden recibir y modificar valores durante la generación del listado. Además, las variables almacenables permiten conservar sus valores en la base de datos utilizada para generar el listado. |
Variables de la plantilla
Las variables de la plantilla se definen y almacenan en la propia plantilla. Se pueden gestionar desde la opción "Variables de la plantilla" del menú "Datos".
Cada variable se define mediante los siguientes datos:
- Nombre
Identifica de forma única la variable. Puede estar formado por letras sin tildes, números y el carácter de subrayado (_). No se distinguen mayúsculas y minúsculas, por lo que, por ejemplo,total,TotalyTOTALhacen referencia al mismo nombre. Tampoco puede coincidir con el nombre de otra variable, un campo de registro, una función, un procedimiento o una palabra reservada del lenguaje de guiones. - Tipo
Determina el tipo de información que puede almacenar la variable. Puede ser número decimal, número entero o texto. - Valor inicial
Define el valor que contiene inicialmente la variable mientras no sea modificado, por ejemplo, mediante una sentencia de asignación de un guion. - Comentario
Permite añadir una descripción para facilitar la identificación de la variable en las ventanas en las que se muestran las variables disponibles.
La ventana muestra también los usos de la variable seleccionada, indicando los objetos y guiones de la plantilla en los que se utiliza. Esto permite localizar sus dependencias antes de modificarla o eliminarla.
Las variables definidas también se pueden reordenar, mediante los botones de avance y retroceso, para facilitar su identificación y localización.
Variables almacenables
Las variables almacenables se utilizan en los guiones de forma similar a las variables de la plantilla, pero con la particularidad de que sus valores pueden almacenarse en la base de datos utilizada para generar el listado. De este modo, mientras que las variables de la plantilla pertenecen a una plantilla concreta, las variables almacenables permiten conservar información asociada a la base de datos.
Las variables almacenables se organizan en conjuntos de variables almacenables, clasificados por tipo. Estos conjuntos pueden utilizarse en diferentes plantillas, aunque cada plantilla puede emplear como máximo un conjunto.
Las variables almacenables se gestionan desde la opción "Variables almacenables" del menú "Datos". El acceso varía en función de si la plantilla tiene asociado un conjunto de variables almacenables.
Si la plantilla no tiene ningún conjunto asociado, el programa permite seleccionar uno existente o crear uno nuevo. Al seleccionar esta opción, se abre la ventana "Conjuntos de variables almacenables disponibles", desde la que se puede seleccionar, crear o eliminar conjuntos, localizar su fichero y consultar sus usos.
Si la plantilla ya tiene un conjunto asociado, se abre directamente la ventana "Conjunto de Variables Almacenables". En ella se muestran las variables que contiene, junto con su tipo, valor inicial y comentario, y se pueden gestionar las variables del conjunto y consultar sus usos.
Asimismo, la opción "Conversión de variables almacenables a variables de la plantilla" permite convertir las variables del conjunto en variables propias de la plantilla.
| Buenas prácticas: |
|---|
Para evitar conflictos con los nombres de los campos de registro y de las variables de la plantilla, se recomienda utilizar prefijos identificativos en los nombres de las variables almacenables. Por ejemplo, para un conjunto relacionado con certificaciones se puede utilizar el prefijo vac_, con nombres como vac_numprmcert o vac_coefbaja. |
