SQL
Configuración del SQL
Configuración de SQL de la Grid
En esta sección, se definen las configuraciones relacionadas con el comando SQL principal de la Grid, incluyendo la selección de campos, límite de registros, comandos ejecutados antes de la consulta, ordenación, conexión y opciones de mensaje cuando no se encuentra ningún registro.
Comando SQL
Permite definir el SQL principal de la aplicación.
En este campo, es posible editar el comando SQL utilizado por la Grid, agregando o eliminando campos según la necesidad de la aplicación.
Limit
Permite limitar la cantidad de registros recuperados por el SQL para su visualización en la Grid.
Esta configuración puede utilizarse para controlar el volumen de datos devuelto por la aplicación, especialmente en consultas con una gran cantidad de registros.
Preparación SQL
Permite informar comandos SQL o procedures que deberán ejecutarse antes del SELECT principal de la aplicación.
Esta opción puede utilizarse cuando sea necesario preparar datos, ejecutar rutinas auxiliares o realizar alguna acción en la base de datos antes de la ejecución de la Grid.
Campos de clave foránea
Muestra los campos identificados como claves foráneas en la estructura de la base de datos.
Estos campos serán utilizados por Scriptcase en el mapeo automático de los enlaces entre aplicaciones. Cuando la aplicación se utilice como destino de un enlace, las claves foráneas identificadas podrán seleccionarse en la configuración del enlace, evitando la necesidad de crear variables globales en el SQL de la aplicación de destino.
Campos para ordenación de la Grid
Define los campos utilizados en la ordenación inicial de la Grid.
Los campos seleccionados en esta opción serán considerados por Scriptcase para crear la ordenación predeterminada de la aplicación.
Si desea definir una ordenación personalizada directamente en el SQL de la Grid, desmarque los campos seleccionados en esta opción.
Conexión
Muestra el nombre de la conexión utilizada por la aplicación.
Esta conexión puede cambiarse por otra conexión del proyecto, siempre que tenga la misma estructura de tabla utilizada por la Grid.
Usar mensaje personalizado
Define si se mostrará un mensaje personalizado cuando la Grid no devuelva registros.
Cuando esta opción esté habilitada, será posible configurar el texto y la apariencia del mensaje mostrado al usuario.
Mensaje de registro inexistente
Define el mensaje mostrado cuando la Grid no devuelve ningún registro.
Esta opción está disponible cuando Usar mensaje personalizado está activado.
Nombre de la fuente
Define la fuente utilizada en el mensaje de registro inexistente.
Para seleccionar la fuente, haga clic en el ícono mostrado junto al campo. Esta opción está disponible cuando Usar mensaje personalizado está activado.
Tamaño de la fuente
Define el tamaño de la fuente utilizada en el mensaje de registro inexistente.
Esta opción está disponible cuando Usar mensaje personalizado está activado.
Color de la fuente
Define el color de la fuente utilizada en el mensaje de registro inexistente.
Esta opción está disponible cuando Usar mensaje personalizado está activado.
Variable para tabla
Permite sustituir parte del nombre de la tabla definida en el SELECT por el contenido de una variable antes de la ejecución del comando.
El primer campo debe completarse con el nombre de la variable. El segundo campo debe completarse con la parte del nombre de la tabla que será sustituida.
Variable para campos
Permite sustituir el nombre de un campo del SELECT por el contenido de una variable antes de la ejecución del comando.
El primer campo debe completarse con el nombre de la variable. En el segundo campo, debe seleccionarse el nombre del campo que será sustituido.
Diferenciar letras mayúsculas/minúsculas
| Define si la conexión será case sensitive, diferenciando letras mayúsculas y minúsculas durante la ejecución de la Grid. |
Parámetros y filtros manuales en los enlaces
Cuando las tablas tienen claves foráneas configuradas correctamente, Scriptcase puede identificar estas relaciones y ponerlas a disposición en la interfaz de configuración de los enlaces. De esta forma, es posible relacionar las aplicaciones sin la necesidad de crear variables globales manualmente en el SQL de la aplicación de destino.
Sin embargo, en algunos escenarios, puede ser necesario configurar el filtro manualmente. Esto puede ocurrir cuando no existe una clave foránea configurada en la base de datos, cuando la relación no se identifica automáticamente o cuando el enlace necesita utilizar una condición específica.
En estos casos, los parámetros pueden utilizarse para pasar valores entre aplicaciones. Para ello, agregue una variable global en la cláusula WHERE del comando SQL, filtrando los registros que deben mostrarse cuando se accede a la aplicación mediante un enlace.
Por ejemplo, en un enlace entre una Grid de clientes y una Grid de pedidos, la Grid de pedidos puede recibir el código del cliente por medio de una variable global. Esta variable se utilizará en la cláusula WHERE para mostrar solamente los pedidos relacionados con el cliente seleccionado.
Para configurar el parámetro manualmente, acceda a la opción SQL en el menú lateral izquierdo de la aplicación.
Edite el comando SQL, agregando la cláusula WHERE y el campo que recibirá el valor pasado por la [variable global][global_var], como se muestra en la imagen a continuación.
Después de la edición, genere la aplicación nuevamente haciendo clic en el botón Generar fuente - 
- o utilizando el atajo de teclado F8.
Utilice variables globales cuando sea necesario crear un filtro manual o personalizado. Para enlaces basados en relaciones ya configuradas en la base de datos, recomendamos utilizar el mapeo automático por clave foránea siempre que sea posible.