Editor de scripts y algoritmos

Referencia de la herramienta del Terminal: qué hace cada panel, cuándo dispara cada evento y cómo pruebas y depuras un algoritmo.

El Terminal trae un editor para escribir la lógica de tu solución. Con él creas scripts, que reaccionan a lo que pasa en un formulario, y algoritmos, que calculan valores. Esta página es la referencia de esa herramienta. Para el lenguaje en sí, ve a DinaScript.

El editor de scripts

El área de escritura colorea la sintaxis y detecta errores mientras escribes. Debajo tienes el panel de errores: lista cada fallo con su número de línea, y al hacer clic saltas directo a esa línea.

El autocompletado te acompaña a medida que tecleas. Cuando escribes un prefijo y un punto (S., F., V., C.…), te sugiere lo disponible en ese contexto. Y mientras escribes una función, te muestra sus parámetros. El catálogo completo está en la referencia de funciones.

El panel de variables administra las variables locales del script. Con los atajos de teclado del editor revalidas el código y lo ejecutas sin salir de la pantalla.

Cuándo se ejecuta un script

El selector de evento decide cuándo corre el script. Según el evento que elijas, asocias uno o varios campos, o un informe. Estas son las familias de evento y cuándo disparan:

Familia	Cuándo dispara
Independiente	A demanda, sin ningún formulario abierto.
De formulario	Al crear un registro, antes de guardar, antes de cancelar, al cargar, en el recálculo periódico, al autoguardar o con un atajo de teclado.
De campo	Cuando un campo cambia, gana o pierde el foco, al abrir o cerrar una relación, o al filtrar un desplegable.
De informe	Sobre el informe entero o sobre las filas que el usuario ha seleccionado.

Para el detalle conceptual de cada disparador, ve a scripts.

Algunas funciones solo tienen sentido en ciertos eventos, y el editor te lo avisa. Por ejemplo, filtrar un desplegable solo vale en el evento que filtra ese desplegable.

Definir parámetros del script

Puedes declarar los parámetros que el script recibe. Mientras los usas dentro del código, el editor te muestra su información.

El editor de algoritmos

Un algoritmo se define en dos partes. La cabecera fija su identidad; el diseñador de fórmula, su cálculo.

En la cabecera indicas el nombre, la categoría y subcategoría, el rol (el tipo de dato que devuelve: texto, moneda, porcentaje…) y una descripción. El diseñador de fórmula es el editor DinaScript donde escribes el cálculo.

Al crear el algoritmo eliges su tipo. De él depende qué paneles aparecen:

Tipo	Para qué sirve
Lineal	Cálculo directo sobre una sección.
De dato	Devuelve un valor de un registro.
Compuesto	Cruza una sección principal con una relacionada.
De cálculo	Opera sobre resultados agregados.
De compatibilidad	Mantiene algoritmos de versiones anteriores.

Según el tipo verás paneles de filtrado previo, criterios de relación (en los compuestos, entre la sección principal y la relacionada), orden y límites. Los conceptos de cada tipo están en algoritmos.

Además puedes configurar:

Referencia de fecha: eliges un campo de fecha y el algoritmo filtra automáticamente por periodo.
Preguntas del algoritmo: defines variables que el usuario responde justo al ejecutarlo.

Probar y depurar

Probar algoritmo: lo ejecutas con datos reales y ves el resultado antes de guardarlo. Si tiene preguntas o referencia de fecha, el editor te las pide primero.
Ver el SQL: muestra, ya formateada, la consulta que Dinaup genera a partir de tu algoritmo. Útil para entender o depurar qué hace por dentro.

Para probar el algoritmo o ver su SQL cuando tiene preguntas, primero tienes que guardarlo.

Cada variable que definas debe usarse en alguna fórmula. Si sobra una, el editor no te deja guardar.