Datagrids
Los datagrids son las tablas de datos maestros de Mind One. Cada datagrid pertenece a un workspace y almacena registros estructurados con validación, versionado y sincronización opcional con data warehouses.
Crear un datagrid
- Desde el menú lateral, accede a Datagrids.
- Haz clic en Crear datagrid.
- Completa la información:
- Nombre: identificador del datagrid.
- Descripción: propósito de los datos.
- Workspace: selecciona el workspace contenedor.
- Datagroup (opcional): asigna a uno o más datagroups.
- Table Code (opcional): código para la tabla en el data warehouse (se genera automáticamente desde el nombre si no se especifica). Solo letras, números y guiones bajos; debe empezar con letra.
- Define los campos del datagrid (o hereda los del workspace).
- Opcionalmente, define reglas de validación cruzada.
- Confirma la creación.
Campos
Cada campo del datagrid se configura con:
| Propiedad | Descripción |
|---|---|
| Nombre | Nombre visible del campo |
| Tipo | string, number, boolean, date, email, url |
| Obligatorio | Si el campo es requerido para guardar un registro |
| Único | Si el valor debe ser único en todo el datagrid |
| Column Code | Código de columna para el data warehouse |
| Value List Key | Vinculación a una value list para opciones desplegables |
| Validación | Min, max, patrón regex, opciones permitidas |
| Partición | Configuración de partición para cubos de datos |
Particiones
Un campo puede configurarse como partición, convirtiendo el datagrid en un cubo de datos. Las particiones obtienen sus valores de:
- Value List: valores de una lista estática o dinámica.
- Otro datagrid: valores de una columna de otro datagrid.
- Libre: cualquier valor es aceptado.
Validación
Validación de campo
Cada campo puede tener reglas de validación individuales:
- Formato: patrón regex que el valor debe cumplir.
- Rango: valores mínimo y máximo para campos numéricos o de fecha.
- Opciones: conjunto de valores permitidos.
- Obligatoriedad: el campo no puede estar vacío.
- Unicidad: el valor no puede repetirse en el datagrid.
Validación cruzada entre campos
Reglas que comparan valores entre campos del mismo registro:
- Operadores:
<,<=,>,>=,=,!= - Ejemplo:
precio_venta > precio_coste
Validación cruzada entre datagrids
Reglas que validan valores contra datos de otros datagrids. Útil para verificar que un código de producto existe en el datagrid maestro de productos, por ejemplo.
Los errores de validación se muestran a nivel de celda, campo y regla cruzada, indicando la fila y el campo afectado.
Edición de datos
Edición en interfaz
El datagrid se presenta como una tabla tipo spreadsheet. Puedes:
- Añadir filas directamente.
- Editar celdas individuales.
- Los cambios se validan en tiempo real.
- Guardar aplica todas las modificaciones y genera una nueva versión.
Bloqueo
Mind One usa bloqueo pesimista para evitar ediciones concurrentes:
- Al abrir un datagrid para edición, se adquiere un bloqueo automático.
- El bloqueo tiene un TTL (tiempo de vida) y se renueva mediante heartbeat mientras el usuario está activo.
- Si el usuario se desconecta (cierra pestaña, pierde conexión WebSocket), el bloqueo se libera automáticamente.
- Otros usuarios ven quién tiene el bloqueo y cuándo expira.
- Los administradores pueden forzar el desbloqueo.
Import/Export
Importar desde Excel
- Descargar plantilla: obtén un archivo Excel con la estructura correcta del datagrid (columnas, tipos, validaciones).
- Completar datos: rellena la plantilla con tus datos.
- Importar: sube el archivo y selecciona el modo:
- Reemplazar: sustituye todos los datos existentes.
- Añadir: agrega las nuevas filas sin eliminar las existentes.
- Validación previa: Mind One valida los datos antes de aplicar. Los errores se muestran por celda con el mensaje específico.
- Aplicar: si la validación es correcta, los datos se importan.
Para importaciones grandes, el proceso se ejecuta como un job asíncrono y puedes consultar su progreso.
Exportar a Excel
Descarga el datagrid completo en formato Excel (.xlsx) con opciones:
- Dropdowns habilitados: las celdas con value lists incluyen validación de datos en Excel.
- Visualización de value lists: exportar el valor (key) o la etiqueta (label).
Exportar a PDF
Genera un PDF del datagrid con opciones de márgenes y bordes configurables.
Versionado
Cada vez que se guardan cambios en un datagrid, el número de versión se incrementa automáticamente. Puedes:
- Consultar la versión actual del datagrid.
- Crear una nueva versión explícita mediante la acción Crear versión.
Workflow
Los datagrids soportan un flujo de aprobación:
| Estado | Descripción |
|---|---|
| Draft | El datagrid está en borrador, puede editarse libremente |
| Approved | El datagrid ha sido aprobado, registra quién y cuándo lo aprobó |
Duplicar
Crea una copia completa del datagrid (estructura + datos):
- Selecciona la acción Duplicar en el datagrid.
- Asigna un nuevo nombre.
- Confirma. Se crea un datagrid independiente con los mismos datos.
Sincronización con data warehouse
Si el datagrid tiene una conexión configurada (propia o heredada del workspace), al guardar datos se puede disparar una sincronización automática con el data warehouse. El estado de sincronización se muestra como:
- Syncing: sincronización en curso.
- Skipped: no se sincronizó (sin conexión configurada).
- Error: la sincronización falló (se muestra el error).
Búsqueda
Mind One permite buscar datagrids por nombre a través de toda la plataforma, devolviendo el nombre del datagrid y el workspace al que pertenece.
Permisos
| Acción | Admin | Modeller | Contributor | Data Explorer | Data Viewer |
|---|---|---|---|---|---|
| Ver | ✓ | ✓ | ✓ | ✓ | ✓ |
| Crear | ✓ | ✓ | — | — | — |
| Editar datos | ✓ | ✓ | ✓ | — | — |
| Gestionar schema | ✓ | ✓ | — | — | — |
| Eliminar | ✓ | ✓ | — | — | — |
| Importar Excel | ✓ | ✓ | ✓ | — | — |
| Exportar | ✓ | ✓ | ✓ | ✓ | ✓ |
Relacionado
- Workspaces — Los datagrids pertenecen a workspaces y heredan su schema.
- Value Lists — Vincular listas de valores a campos del datagrid.
- Datagroups — Agrupar datagrids relacionados.
- Conexiones — Sincronizar datos con data warehouses.