Corfix Form Builder: uso del componente «Data Grid».

Este potente componente le permite crear una estructura dinámica y repetible, similar a una tabla, en la que los usuarios pueden añadir varias filas de subcomponentes (campos). Es ideal para recopilar listas de elementos, múltiples entradas del mismo tipo o datos complejos que se repiten.

Dónde encontrarlo

En su Corfix Form Builder, haga clic en un componente de cuadrícula de datos para acceder al panel de configuración. Verá cuatro pestañas:

Visualización
Datos
Validación
Condicional

1. Pestaña «Visualización»

La pestaña «Visualización» controla el diseño y el aspecto general del componente de cuadrícula de datos.

Etiqueta:
- Este es el título visible de su sección de cuadrícula de datos que verán los usuarios. Es un campo obligatorio.
- Ejemplo: «Partidas», «Asistentes», «Defectos detectados».
Posición de la etiqueta:
- Determina dónde se muestra la etiqueta en relación con la cuadrícula de datos (p. ej., Arriba, Izquierda, Derecha, Abajo).
- Valor predeterminado: Arriba.
Descripción:
- Proporciona un texto explicativo adicional sobre el componente, que suele mostrarse debajo de la etiqueta.
- Ejemplo: «Enumere todos los materiales utilizados, la cantidad y el precio unitario».
Texto de ayuda:
- Texto que aparece cuando el usuario pasa el ratón por encima del componente. Resulta útil para ofrecer ayuda rápida o contexto sobre toda la cuadrícula.
Desactivar la adición/eliminación de filas:
- Si se marca esta casilla, los usuarios no podrán añadir nuevas filas ni eliminar las existentes dentro de la cuadrícula de datos. De este modo, se convierte efectivamente en un conjunto fijo de filas.
Añadir otro texto:
- Permite personalizar el texto del botón en el que los usuarios hacen clic para añadir una nueva fila.
- Por defecto: «Añadir otra».
Posición de «Añadir otro»:
- Determina dónde aparece el botón «Añadir otro» en relación con las filas (p. ej., Abajo, Arriba, Ambos).
- Valor predeterminado: Abajo.
Inicializar vacío:
- Si se marca esta opción, la tabla de datos se iniciará sin filas visibles, y el usuario deberá hacer clic en «Añadir otra» para empezar a añadir entradas. Si no se marca, normalmente se iniciará con una fila vacía.
Clase CSS personalizada:
- Permite a los usuarios avanzados aplicar estilos personalizados a todo el componente mediante clases CSS.
Ocultar etiqueta:
- Si se marca esta opción, la etiqueta principal del componente no se mostrará en el formulario.
Mostrar etiqueta en la tabla de datos:
- Es probable que esta configuración determine si se muestran las etiquetas de los campos individuales dentro de cada fila de la tabla de datos (por ejemplo, si se añade un campo «Cantidad» a la tabla, esto determina si «Cantidad» aparece encima o junto al campo de entrada en cada fila).
Edición modal:
- Si se marca esta casilla, la edición de filas o componentes individuales dentro de la cuadrícula de datos podría abrirse en una ventana modal emergente independiente, lo que puede resultar útil en el caso de filas complejas.

2. Pestaña «Datos»

La pestaña «Datos» gestiona los datos iniciales y la estructura de la cuadrícula de datos.

Valor predeterminado:
- Le permite rellenar previamente la cuadrícula de datos con una o varias filas predeterminadas al cargar el formulario. Para definir estas filas predeterminadas, haga clic en «Añadir otra» en este apartado.

3. Pestaña «Validación»

La pestaña «Validación» define las reglas para el componente «Cuadrícula de datos».

Obligatorio:
- Si se marca esta casilla, el usuario deberá añadir al menos una fila a la cuadrícula de datos antes de enviar el formulario.
Longitud mínima:
- El número mínimo de filas que debe haber en la cuadrícula de datos.
Longitud máxima:
- El número máximo de filas que se pueden añadir a la tabla de datos.

4. Pestaña «Condicional»

La pestaña «Condicional» le permite configurar reglas que determinan cuándo debe mostrarse u ocultarse todo este componente de cuadrícula de datos (y todos los componentes que contiene) en función de los valores de otros componentes del formulario.

Simple:
- Normalmente se trata de un botón de alternancia o un menú desplegable para elegir entre lógica condicional simple y avanzada.
Este componente debe «Mostrar»:
- Elija si el componente debe «Mostrarse» u «Ocultarse» (opciones implícitas) en función de la condición.
Cuando el componente del formulario:
- Seleccione otro componente de su formulario cuyo valor active la condición.
Tenga el valor:
- Especifique el valor exacto que debe tener el componente del formulario seleccionado para que se cumpla la condición.
Ejemplo: Podría configurar una regla para que la tabla de datos «Gastos adicionales» solo se muestre cuando la casilla «¿Hay gastos adicionales?» esté marcada.

Ventana de vista previa

El área de vista previa, situada a la derecha del cuadro de diálogo, representa visualmente el componente «Cuadrícula de datos». Normalmente muestra un marcador de posición para una fila y un botón «Añadir otro», lo que indica que los usuarios pueden añadir varias entradas. Le ayuda a visualizar cómo aparecerá la sección repetible en su formulario.

Acciones en la parte inferior del cuadro de diálogo:

Guardar: guarda todos los cambios realizados en la configuración del componente de tabla de datos.
Cancelar: descarta cualquier cambio no guardado y cierra el cuadro de diálogo.
Eliminar: Elimina del formulario el componente «Cuadrícula de datos» y todos los componentes situados en su interior.

Prácticas recomendadas para el componente «Cuadrícula de datos»:

Utilícelo para datos repetitivos: ideal para situaciones en las que los usuarios necesiten añadir varias entradas del mismo tipo, como una lista de artículos de inventario, personas a cargo o lecturas diarias.
Personalice el texto «Añadir otro»: Modifique el texto «Añadir otro» para que sea más descriptivo (por ejemplo, «Añadir otro artículo», «Añadir nueva persona») y así orientar mejor al usuario.
Establezca la longitud mínima y máxima: utilice la «Longitud mínima» para garantizar que se recopilen los datos esenciales (por ejemplo, al menos un defecto notificado) y la «Longitud máxima» para evitar entradas excesivas si fuera necesario.
Tenga en cuenta la opción «Inicializar en blanco»: en el caso de las cuadrículas que quizá no siempre sean necesarias, marque «Inicializar en blanco» para mantener el formulario más limpio hasta que el usuario necesite añadir filas de forma explícita.
Visualización condicional: Oculte toda la tabla de datos hasta que sea relevante para la entrada del usuario, lo que facilita la navegación por formularios complejos.