Creando una Grid/Informe

View video

El tipo de aplicación Grid se utiliza para visualizar, filtrar y analizar datos en Scriptcase, permitiendo crear informes analíticos a partir de tablas.

Con la Grid, puede organizar la información mostrada y utilizar recursos como filtros, totales, resúmenes, gráficos, tablas dinámicas, comparaciones de datos y exportaciones en formatos como PDF, Excel, CSV y XML.

Nueva aplicación

Para crear una aplicación en el proyecto, acceda al menú Aplicación > Nueva aplicación o utilice el acceso rápido F2.

Los accesos rápidos de la interfaz se pueden configurar accediendo a Configuración > Mis teclas de acceso rápido.

Haga clic en la tarjeta de aplicación Grid/Informe.

Datos de la aplicación

Conexión

Este campo lista todas las conexiones del proyecto y define la conexión que será utilizada por la aplicación.

Seleccione la conexión para listar las tablas de la base de datos.

Conexión con Diccionario de Datos

Cuando la conexión seleccionada tiene un Diccionario de Datos vinculado, el nombre del diccionario se mostrará debajo del campo Conexión.

Esta información indica que la conexión tiene un diccionario configurado, que puede utilizarse para completar las etiquetas de los campos con lang en las aplicaciones generadas.

Al hacer clic en el nombre del diccionario, se mostrará una pantalla donde podrá vincular nuevas tablas al Diccionario de Datos. Utilice esta opción si la tabla seleccionada para crear la aplicación aún no se ha configurado en el diccionario.

Para más detalles, acceda a la documentación del Diccionario de Datos.

Nombre

Define el nombre de la aplicación que será creada. Este campo es obligatorio y debe contener entre 1 y 64 caracteres.

Se permiten caracteres alfanuméricos, punto (.), guion (-) y guion bajo (_). No se permiten espacios ni otros caracteres especiales.

Table

Defines the table or tables that will be used as the data source.

It is possible to select more than one table. In this case, Scriptcase builds the relationship between them according to the selection order and the foreign keys identified in the database.

For the relationships to be built correctly, select the tables following the logical sequence of the foreign keys. For example: customers, orders, and order_details.

If the selection order does not match the existing relationships, the SELECT command may not be built correctly. After selecting the tables, use the Relationships tab to view the identified links and adjust the structure, if necessary.

Campos

Lista los campos disponibles en la tabla o tablas seleccionadas para crear la Grid.

Puede seleccionar o deseleccionar los campos que formarán parte de la aplicación. Los campos seleccionados se utilizarán para crear el comando SELECT inicial de la Grid.

Después de crear la aplicación, los campos utilizados en la Grid pueden modificarse en el menú SQL, agregando o eliminando campos del comando SELECT.

Localización

Define el idioma predeterminado de la aplicación que será creada. De forma predeterminada, Scriptcase selecciona la opción Heredar idioma predeterminado del proyecto, haciendo que la aplicación utilice automáticamente el idioma definido como predeterminado en las propiedades del proyecto.

Si es necesario, puede seleccionar un idioma específico para la aplicación. En este caso, la aplicación utilizará el idioma seleccionado, independientemente del idioma predeterminado definido en el proyecto.

Después de crear la aplicación, el idioma de la aplicación puede modificarse en Aplicación > Configuración. Si la opción Heredar idioma predeterminado del proyecto está seleccionada, el idioma utilizado será definido por el idioma predeterminado del proyecto, que puede modificarse en Proyecto > Propiedades.

Editar charset del idioma

También puede cambiar el charset utilizado por el idioma en la aplicación que se está creando. Para cambiar el charset, haga clic en el botón de edición que se muestra al lado del campo de selección del idioma.

Al hacer clic en el botón, se mostrará la opción para cambiar el charset del idioma seleccionado.

Nota: Este cambio se aplicará solamente a la aplicación que se está creando. El charset definido para los idiomas en la configuración del proyecto no será modificado.

Comando SELECT

Muestra el comando SELECT generado después de seleccionar las tablas y los campos. Este campo también permite insertar una instrucción SQL creada previamente, siempre que utilice tablas existentes en la base de datos seleccionada en la conexión.

SQL Builder

Abre el SQL Builder en una nueva pestaña del navegador.

Este recurso permite crear el comando SQL de forma asistida, seleccionando tablas, campos, condiciones, ordenación y relaciones para generar un SELECT personalizado.

Después de crear el comando, puede incorporarse al campo Comando SELECT de la Grid.

Reconocer claves foráneas y crear JOINs automáticamente

Genera automáticamente el comando SELECT de la aplicación utilizando JOINs, con base en las claves foráneas existentes en la tabla seleccionada.

Este recurso está disponible solo cuando se utiliza una tabla para crear la Grid. Si la tabla seleccionada no tiene claves foráneas configuradas en la base de datos, los JOINs no se crearán automáticamente.

Aplicaciones adicionales

En la pestaña Aplicaciones adicionales, puede crear otras aplicaciones junto con la Grid principal, utilizando como base la tabla seleccionada durante la creación de la aplicación.

Además de crear un Formulario para editar los registros de la tabla principal, Scriptcase puede identificar tablas relacionadas mediante claves foráneas y sugerir la creación de nuevas Grids y Formularios para estas tablas.

Las aplicaciones adicionales creadas en esta etapa se vincularán a la aplicación principal mediante recursos como enlace de campo o subgrid, según la configuración seleccionada.

Este recurso está disponible solo cuando se utiliza una única tabla para crear la Grid.

Crear también un Formulario para editar la Grid

Permite crear un Formulario para editar los registros mostrados en la Grid principal.

Al habilitar esta opción, Scriptcase crea el Formulario indicado y configura automáticamente el enlace entre las aplicaciones.

Nombre del Formulario para edición

Define el nombre del Formulario que se creará para editar los registros mostrados en la Grid principal.

Apertura del enlace

Define cómo se abrirá la aplicación Formulario para editar el registro.

• Abrir en la misma ventana: Abre la aplicación Formulario en la misma ventana que la aplicación Report.
• Modal: Abre la aplicación Formulario en una ventana modal. El ancho y la altura de la modal se pueden cambiar en la configuración del enlace.

Crear aplicaciones adicionales

Permite crear Grids y Formularios para tablas relacionadas con la tabla principal, identificadas mediante las claves foráneas existentes en la base de datos.

Al habilitar esta opción, Scriptcase muestra las relaciones encontradas y permite configurar qué aplicaciones se crearán para cada tabla relacionada. También es posible definir algunas configuraciones básicas para las aplicaciones y el enlace.

Separar aplicaciones por carpeta

Cuando está habilitada, las aplicaciones adicionales se crearán en carpetas separadas dentro del proyecto, facilitando la identificación y el mantenimiento de las aplicaciones generadas.

Relación

Al habilitar la opción Crear aplicaciones adicionales, se mostrará una lista de tablas que referencian la tabla principal mediante una clave foránea. La tabla principal es la seleccionada en la pestaña Datos de la aplicación.

Las tablas relacionadas se mostrarán en niveles. Si también son referenciadas por otras tablas, estas tablas secundarias también serán listadas.

En el ejemplo anterior, la tabla demo_customers fue seleccionada como tabla principal de la Grid. A partir de ella, Scriptcase identifica las tablas que referencian demo_customers mediante una clave foránea, como demo_contacts, demo_orders y demo_sales.

Como la tabla demo_order_details referencia demo_orders, esta relación se muestra en un nuevo nivel dentro de la estructura.

Pantalla de configuración

En la pantalla de configuración, cada tabla relacionada puede expandirse para definir qué aplicaciones serán creadas. Puede crear aplicaciones Grid (columna izquierda) y aplicaciones de Formulario (columna derecha) con base en la tabla relacionada, además de configurar cómo estas aplicaciones se vincularán a la Grid principal.

Configuraciones de creación de la Grid

• Crear Grid - Define si se creará una aplicación Grid para la tabla relacionada. Si no desea crear la aplicación, seleccione la opción No crear Grid.

  • La opción Crear Grid para la tabla crea una nueva aplicación Grid con base en la tabla relacionada.
  • La opción No crear Grid no crea ni utiliza una aplicación Grid para la tabla relacionada.
• Nombre - Define el nombre de la aplicación Grid que se creará para la tabla relacionada. De forma predeterminada, Scriptcase sugiere un nombre basado en la tabla seleccionada, como grid_demo_orders.
• Link open - Define cómo se abrirá la aplicación vinculada cuando la opción Navegar esté seleccionada en Tipo de enlace.
  • La opción Modal abre la aplicación vinculada en una ventana superpuesta a la Grid principal. El tamaño del modal debe definirse posteriormente en las propiedades del enlace.
  • La opción Abrir en la misma ventana abre la aplicación vinculada en la misma ventana que la Grid principal.
• Reconocer claves foráneas y crear JOINs automáticamente - Genera automáticamente el comando SELECT de la aplicación adicional utilizando JOINs, con base en las claves foráneas existentes en la tabla.

Configuraciones de creación del Formulario

• Crear Formulario - Define si se creará una aplicación de Formulario para la tabla relacionada, si se utilizará una aplicación existente o si no se creará ninguna aplicación de Formulario.

  • La opción Crear Formulario para la tabla crea una nueva aplicación de Formulario con base en la tabla relacionada.
  • La opción Utilizar formulario existente permite utilizar una aplicación de Formulario ya existente.
  • La opción No crear/utilizar formulario no crea ni utiliza una aplicación de Formulario para la tabla relacionada.
• Nombre - Define el nombre de la aplicación de Formulario que se creará para la tabla relacionada. De forma predeterminada, Scriptcase sugiere un nombre basado en la tabla seleccionada, como form_demo_orders.

• Tipo - Define el tipo de aplicación de Formulario que se creará para la tabla relacionada.

  • La opción Registro único crea un Formulario para mostrar y editar un registro por vez.
  • La opción Múltiples registros crea un Formulario para mostrar y editar varios registros en una única pantalla.
  • La opción Grid editable crea un Formulario con edición directa de los registros en formato de grid.
  • La opción Grid editable (view) crea un Formulario en formato de grid editable basado en una view.

Edición de campos

Esta pantalla muestra los campos de las tablas seleccionadas y permite realizar ajustes antes de crear la aplicación, como cambiar el tipo de dato, el nombre de visualización y otras configuraciones.

Observación: Cuando se crean aplicaciones adicionales, cada aplicación se mostrará en su propia pestaña en esta etapa. Esto permite configurar por separado los campos de la Grid principal, el Formulario de edición y las aplicaciones adicionales.

• Campos - Lista los campos de la tabla utilizada para crear la aplicación.

• Etiqueta - Define el texto mostrado para el campo en las aplicaciones generadas. Cuando la tabla está asociada a un diccionario de datos, Scriptcase utiliza las variables de idioma asociadas a los campos y muestra el ícono de traducción, permitiendo cambiar el texto de la lang utilizada en la etiqueta.

• Tipo de dato - Define el tipo de dato del campo, como texto, número, fecha u otros formatos utilizados por la aplicación.

• Inserción - Define si el campo estará disponible para ser completado al insertar nuevos registros.

• Actualización - Define si el campo estará disponible para edición durante la actualización de los registros.

Las columnas Inserción y Actualización se muestran al habilitar la opción Crear también un Formulario para editar la Grid.

• Grid - Define si el campo será mostrado en la aplicación de tipo Grid.

• Búsqueda - Define si el campo estará disponible en la Búsqueda de la aplicación.

Relación

Al seleccionar dos o más tablas, aparecerá la pestaña “Relación”. En esta pestaña podemos visualizar la relación creada entre las aplicaciones, donde podemos editar los campos relacionados.

Al hacer clic en una conexión, de la pantalla anterior, se muestra el formulario de edición de los campos relacionados, como se puede ver a continuación.

![Campos relacionados][img_app_04]