Arquímedes - Plantillas de listados - Guiones

Compartir

Guiones de plantillas

Los guiones permiten incorporar lógica y automatismos a las plantillas mediante un lenguaje de programación propio del programa. Aunque muchos listados pueden diseñarse sin ellos, otros los requieren para realizar cálculos, modificar variables, mostrar mensajes, controlar la impresión o definir comportamientos personalizados.

Una plantilla de listado puede contener los siguientes tipos de guiones:

  • Guion de inicialización
    Solo se puede definir uno por plantilla. Se ejecuta justo antes de comenzar la impresión del listado.
  • Guion 'Al cargar'
    Se puede definir para cada sección de registros. Se ejecuta después de cargar los datos de cada registro y antes de imprimirlos mediante las zonas de la sección.
  • Guion 'Antes de imprimir'
    Se puede definir para cada zona de la plantilla. Se ejecuta inmediatamente antes de imprimir cada instancia de la zona y permite, entre otras operaciones, preparar las variables utilizadas por sus objetos.
  • Guion 'Tras imprimir'
    Se puede definir para cada zona de la plantilla. Se ejecuta inmediatamente después de imprimir su contenido y permite, entre otras operaciones, actualizar variables utilizadas por los objetos de la máscara de página.

Editor de guiones

El Editor de guiones permite definir y modificar el contenido de los guiones de la plantilla. En la parte superior se identifica el tipo de guion que se está editando y la sección o zona a la que pertenece.

Además de las herramientas habituales de edición, dispone de las siguientes opciones:

  • Evaluación del guion. Permite establecer si el guion debe evaluarse durante la generación del listado. Entre las opciones disponibles se encuentra "Evaluar siempre", "Evaluar si visible" y "No evaluar". Esta última permite mantener el guion definido sin que se ejecute.
  • Analizar. Comprueba la sintaxis del guion para detectar posibles errores.
  • Dar formato. Aplica formato al código para facilitar su lectura.
  • Pegar constante. Permite seleccionar e insertar una constante en la posición actual del cursor.
  • Pegar campo. Permite seleccionar e insertar un campo de registro disponible en la posición actual del cursor.
  • Pegar variable. Permite seleccionar e insertar una variable disponible en la posición actual del cursor.
  • Pegar función. Permite seleccionar e insertar una función del lenguaje de guiones en la posición actual del cursor.
  • Localizar origen. Permite localizar el origen de un elemento utilizado en el guion.
  • Variables de la plantilla. Permite acceder a las variables definidas en la plantilla.

Además, la barra superior incluye herramientas para guardar, deshacer y rehacer, cortar, copiar, pegar, buscar y reemplazar, entre otras operaciones de edición.

Variables utilizadas en los guiones

Los guiones pueden utilizar diferentes tipos de variables para almacenar y manipular información durante su ejecución. Además de las variables de la plantilla y las variables almacenables, pueden emplearse variables internas, utilizadas para cálculos intermedios dentro de un guion, y variables dinámicas, que parten de las variables internas y permiten conservar y compartir valores entre diferentes ejecuciones y guiones. También pueden utilizarse variables de usuario, cuyos valores se almacenan en la base de datos y que pueden emplearse en expresiones asociadas a columnas de usuario calculadas.

Guion externo

Además de los guiones definidos directamente en la plantilla, esta puede utilizar un guion externo.

Los guiones externos se organizan por tipos y pueden ser utilizados por diferentes plantillas.

Estos guiones se gestionan desde la opción "Guion externo" del menú "Datos". Si la plantilla no tiene ninguno asociado, el programa permite seleccionar uno entre los guiones externos disponibles o crear uno nuevo. También permite gestionar los guiones externos existentes, localizar sus ficheros y consultar las plantillas en las que se utilizan.

CYPE Mentor