Datasets y Data Widgets

Los Datasets permiten almacenar datos en forma de tabla dentro del CMS y mostrarlos después en tus Layouts usando Data Widgets (tablas, listados, calendarios, etc.).[web:118][web:120][web:123]

Qué es un Dataset

Un Dataset es una tabla de datos definida en la Biblioteca de shining: tú decides qué columnas tiene y después rellenas filas con la información que quieras mostrar (horarios, reservas, listados de eventos, precios, etc.).[web:118][web:120]

La gracia es que el Dataset se mantiene separado del Layout: puedes actualizar los datos sin entrar al editor gráfico y reutilizar el mismo Dataset en varios Layouts, Playlists o Widgets.[web:121]

Crear un Dataset

Los Datasets se crean desde la sección de Biblioteca, igual que el resto de elementos de contenido.

  1. Ve al menú principal y entra en Library → DataSets.
  2. Pulsa Add DataSet para crear un nuevo Dataset.
  3. Introduce un Nombre descriptivo y, si quieres, una descripción interna y un código (útil para la API).
  4. Selecciona la carpeta donde se guardará; heredará los permisos de esa carpeta.
  5. Guarda; después pasarás a definir las columnas que tendrá la tabla.

En este punto solo has creado la estructura básica; aún no hay columnas ni datos.

Definir columnas

Las columnas definen la estructura del Dataset: cada columna representa un campo (fecha, texto, número, etc.) que luego se rellenará en cada fila.

  1. Desde la lista de Datasets, usa el menú de fila y elige View Columns para el Dataset que acabas de crear.
  2. Verás que se crea una columna inicial (por ejemplo, Col1); puedes renombrarla o eliminarla.
  3. Pulsa Add Column para añadir cada nuevo campo que quieras guardar: nombre, tipo (texto, número, fecha, fórmula…), ancho máximo, etc.
  4. Repite hasta definir todas las columnas necesarias; más columnas dan más detalle, pero también complican el mantenimiento.

Puedes modificar el orden de las columnas más adelante, incluso después de haber agregado datos, para ajustar cómo se muestran.

Cargar datos (manual, CSV, API)

Una vez definida la estructura, hay varias formas de meter datos en el Dataset: manualmente, importando desde un CSV, a través del API o sincronizando con una fuente externa.

  • Entrada manual: desde el menú de fila del Dataset, usa View Data y añade filas con el botón Add Row; rellena las columnas no calculadas.
  • Importar CSV: shining permite cargar un archivo CSV y mapear sus columnas con las columnas del Dataset para subir muchos registros de golpe.
  • API / JSON: si tienes una integración, puedes empujar datos como JSON al Dataset usando la API de shining o configurando una sincronización remota programada.

Esta flexibilidad hace que los Datasets sean ideales para datos vivos, como agendas, reservas de salas, listados rotativos o información que viene de otros sistemas.

Usar Datasets en Layouts (Data Widgets)

Para mostrar los datos de un Dataset en pantalla se utilizan Data Widgets, que son widgets especiales pensados para consumir datos tabulares.

  1. Abre un Layout en el editor de Layouts.
  2. Añade un Widget de tipo DataSet View, Table, Ticker u otro Data Widget compatible, según tu versión.
  3. En la configuración del Widget selecciona el Dataset que quieres usar como fuente de datos.[web:123]
  4. Define qué columnas se mostrarán y en qué orden; en algunos widgets puedes usar plantillas o elementos individuales para tener más control.
  5. Ajusta filtros (por ejemplo, solo registros de hoy, solo reservas futuras) y criterios de ordenación.

El Layout mostrará los datos tal y como estén en el Dataset, y se actualizará automáticamente cuando cambies la tabla, sin tocar el diseño.

Opciones avanzadas de Data Widgets

Los Data Widgets modernos de shining trabajan con Elements, que son piezas pequeñas de datos (título, descripción, fecha, etc.) que puedes colocar libremente en el Layout.

  • Cada Data Widget tiene varios Elements que puedes arrastrar y posicionar en el lienzo del Layout.
  • Los Elements usan Data Slots para paginar los resultados, de forma que puedes repartir las filas entre varios Elements en la pantalla.
  • En la pestaña de Appearance de un Data Widget configuras transiciones, estilos y cómo se rellenan los slots.
  • La pestaña Advanced te permite controlar nombre, duración, nivel de estadísticas (Proof of Play) y repetición.

Usando Elements y Data Slots puedes construir paneles complejos basados en datos, como listados dinámicos, calendarios o dashboards que se actualizan solos.

Esta guía no es oficial. Está basada en el manual original de Xibo: manual