Lista de Valores
Las List of Values(listas de valores) son catálogos reutilizables de opciones que se vinculan a campos de datagrids. Permiten estandarizar los valores permitidos en un campo — países, categorías, estados, monedas — y mantener consistencia entre múltiples datagrids.
Tipos de List of Values
Estática
Valores definidos manualmente. Cada valor tiene:
| Propiedad | Descripción |
|---|---|
| Value | Clave del valor (lo que se almacena) |
| Label | Etiqueta visible para el usuario |
| Order | Posición en la lista |
Basada en datagrid
Valores que se obtienen dinámicamente de una columna de otro datagrid:
- Datagrid fuente: el datagrid del que se extraen los valores.
- Campo de valor: la columna que proporciona los valores (keys).
Esto permite que la lista de opciones se actualice automáticamente cuando cambian los datos del datagrid fuente.
Listas de valores de sistema y usuales
Además de las listas que defines manualmente, Mind One incluye dos familias de listas integradas que están disponibles desde el primer momento, sin necesidad de crearlas. Aparecen como opción al configurar un campo de datagrid igual que cualquier otra value list.
Listas de valores de sistema
Las listas de sistema validan los valores de un campo contra los metadatos de la propia aplicación. En lugar de definir las opciones a mano, el campo se valida contra las entidades reales de tu cuenta, y las opciones se resuelven dinámicamente: si añades, por ejemplo, un nuevo usuario o workspace, aparece de forma automática sin tener que actualizar nada.
Son útiles para campos que deben referenciar una entidad existente — por ejemplo, un campo “Responsable” que solo admita usuarios reales de la cuenta, o un campo que apunte a un workspace o datagrid concreto.
| Lista | Clave | Valida contra |
|---|---|---|
| Usuarios del Tenant | tenant-users | Usuarios de la cuenta |
| Conexiones del Tenant | tenant-connections | Conexiones de Autosync configuradas |
| Workspaces del Tenant | tenant-workspaces | Workspaces existentes |
| Datagroups del Tenant | tenant-datagroups | Datagroups existentes |
| Datagrids del Tenant | tenant-datagrids | Datagrids existentes |
| Metadatos del Tenant | tenant-metadata | Metadatos definidos en la cuenta |
Listas de valores usuales
Las listas usuales son catálogos predefinidos de valores comunes que siguen estándares internacionales. Vienen precargados y listos para vincular a cualquier campo, de modo que no tienes que mantener manualmente catálogos habituales como países, idiomas o monedas.
| Lista | Clave | Estándar |
|---|---|---|
| Países | SYS_COUNTRIES | ISO 3166-1 alpha-2 |
| Regiones del mundo | SYS_REGIONS | Macrorregiones geográficas |
| Idiomas | SYS_LANGUAGES | ISO 639-1 |
| Locales | SYS_LOCALES | BCP-47 (idioma + región) |
| Monedas | SYS_CURRENCIES | ISO 4217 |
| Zonas horarias | SYS_TIMEZONES | IANA tz database |
| Unidades de medida | SYS_UNITS_MEASUREMENT | SI + imperial |
A diferencia de las listas de sistema, los valores de las listas usuales son estáticos: representan catálogos estandarizados que cambian con poca frecuencia.
Crear una List of Values
- Desde el menú lateral, accede a Value Lists.
- Haz clic en Crear value list.
- Completa los campos:
- Key: identificador único (por ejemplo,
paises,categorias_producto). No puede cambiarse después de la creación. - Nombre: nombre descriptivo.
- Descripción (opcional): propósito de la lista.
- Tipo: estática o basada en datagrid.
- Key: identificador único (por ejemplo,
- Si es estática, añade los valores con su clave, etiqueta y orden.
- Si es basada en datagrid, selecciona el datagrid fuente y los campos.
- Confirma la creación.
Vincular a campos de datagrids
Para usar una value list en un campo de datagrid:
- Al definir o editar un campo del datagrid, selecciona la propiedad Value List Key.
- Introduce la key de la value list (por ejemplo,
paises). - El campo mostrará un desplegable con las opciones de la value list.
La misma value list puede vincularse a campos de múltiples datagrids.
Seguimiento de uso
Mind One rastrea en qué datagrids y campos se usa cada value list. Desde la vista de detalle de una value list puedes consultar:
- Número total de datagrids que la usan.
- Número total de campos vinculados.
- Detalle por datagrid: nombre del datagrid y campos específicos.
Gestión
Editar
Modifica nombre, descripción, valores o configuración de fuente. Los cambios se reflejan inmediatamente en todos los datagrids que usan la value list.
Activar/Desactivar
Las value lists inactivas no aparecen como opción al configurar campos, pero los datagrids que ya las usan siguen funcionando.
Eliminar
Solo se puede eliminar una value list si no está en uso por ningún datagrid.
Plantillas
Las value lists pueden marcarse como plantillas para reutilizarse al crear nuevas listas con la misma estructura de valores.
Permisos
| Acción | Admin | Modelador | Contribuidor | Visor de Datos |
|---|---|---|---|---|
| Ver | ✓ | ✓ | ✓ | ✓ |
| Crear | ✓ | ✓ | — | — |
| Editar | ✓ | ✓ | ✓ | — |
| Eliminar | ✓ | ✓ | — | — |
Relacionado
- Datagrids — Los campos de datagrids se vinculan a value lists.
- Workspaces — Los campos del schema de workspace también pueden usar value lists.