Saltar al contenido principal

Datos e Interacciones

Los widgets basados en datos utilizan una Fuente de Datos guardada en la Vista de Usuario. Una fuente puede ser reutilizada por múltiples widgets de la misma vista.

Tipos de Fuente​

Entorno​

Utiliza una conexión preconfigurada y disponible proporcionada por el administrador. Es la opción recomendada cuando la misma conexión debe ser gobernada centralmente.

Manual​

Permite registrar una conexión protegida directamente en la vista, cuando esta posibilidad ha sido habilitada por el administrador.

La pantalla permite guardar, verificar, revocar o eliminar la conexión. Los valores reservados no se muestran después del guardado. Para Oracle, es necesario indicar si el nombre de la base de datos representa un SID o un Nombre de Servicio.

Modelo Semántico​

Utiliza campos y mediciones de un Modelo Semántico publicado y accesible. Es posible:

  • seguir automáticamente la última versión publicada;
  • mantener la versión actual;
  • seleccionar dimensiones, columnas y mediciones mediante casillas de verificación;
  • personalizar el alias de cada campo, inicialmente igual al nombre del campo;
  • consultar las diferencias cuando el modelo publica una nueva versión.

Crear una Fuente Relacional​

  1. Seleccionar Datos y luego Fuentes de Datos Privadas.
  2. Inserir un nombre reconocible.
  3. Elegir el tipo de conexión.
  4. Seleccionar una conexión autorizada.
  5. Usar Probar Conexión.
  6. Cargar el catálogo disponible; el indicador animado confirma que la lectura está en curso.
  7. Configurar la consulta.
  8. Guardar y usar Vista Previa de Datos. La vista previa puede ser cerrada con el comando correspondiente y se cierra automáticamente pasando a otra fuente.
  9. Asociar la fuente al widget seleccionado.

El catálogo muestra todos los esquemas que contienen tablas o vistas legibles, hasta 500 objetos por esquema.

Si el cargado supera el tiempo máximo del servidor, el Editor muestra un mensaje explícito: reintentar y, si el problema persiste, contactar al administrador indicando la hora del intento.

Con una conexión SAP HANA, el catálogo muestra las tablas, las vistas y las columnas visibles al usuario configurado en la conexión. Los objetos seleccionados pueden ser usados en el Query Builder y en la Vista Previa de Datos. Si un objeto esperado no aparece, verificar con el administrador los permisos asignados en la base de datos.

Query Builder​

El Query Builder permite configurar una lectura sin escribir SQL. Se dispone de:

  • esquema y tabla de partida;
  • dimensiones y columnas;
  • mediciones y agregaciones;
  • alias;
  • join;
  • condiciones organizadas en grupos AND/OR;
  • ordenamientos;
  • límite opcional de filas.

Verificar la Vista Previa después de cada modificación relevante, especialmente cuando están presentes join o condiciones anidadas.

SQL Personalizado​

El modo SQL personalizado acepta exclusivamente interrogaciones de lectura. Usar parámetros declarados en lugar de concatenar valores insertados por los usuarios.

Al pasar del Query Builder a SQL personalizado, Sybot genera la sintaxis coherente con la conexión seleccionada. Para SAP HANA, los identificadores están delimitados con dobles comillas; una consulta modificada manualmente permanece bajo el control del usuario.

El editor permite:

  • formatear la interrogación;
  • declarar parámetros y valores iniciales;
  • usar los parámetros en los filtros de la vista;
  • verificar el resultado en Vista Previa.

Las interrogaciones no admitidas son rechazadas con un mensaje; no intentar eludir los controles.

Asociar los Datos a los Widgets​

En el panel Datos y Visualización del widget:

  1. seleccionar la fuente;
  2. elegir dimensión, categoría o jerarquía; las menús desplegables muestran nome_entità.nome_campo en orden alfabético;
  3. seleccionar las mediciones a visualizar;
  4. configurar agregación y formato;
  5. controlar el resultado en Vista Previa.

Las configuraciones de un solo widget no modifican la definición de la fuente compartida.

Cuando los datos están en carga, cada widget muestra en el centro un indicador animado sobre el texto Cargando…. El indicador permanece visible hasta que se completa la solicitud; con fuentes LIVE, la espera también depende de los tiempos de respuesta del sistema interrogado.

Ordenar un gráfico​

Para cada gráfico, es posible elegir en el Editor un ordenamiento predeterminado creciente o decreciente en la categoría o en una de las medidas mostradas. Este es el orden inicial usado en Vista Previa y en la vista publicada; cuando el gráfico usa una jerarquía, el ordenamiento en la categoría sigue el nivel mostrado.

Durante la consulta, abrir el menú de los tres puntos o el menú contextual del gráfico y elegir Ordenamiento. Es posible aplicar temporalmente un orden diferente o seleccionar Predeterminado de la vista. La elección temporal no modifica la Vista de Usuario y se pierde recargando la página.

En los gráficos de pastel y donut, los colores configurados están asociados al valor de la categoría. Cambiar ordenamiento modifica la disposición de las categorías, pero no su color: la correspondencia visual permanece estable.

Colores e imágenes de las categorías​

Los gráficos usan una paleta estándar extendida, modificable desde el panel Propiedades. En los gráficos de pastel, donut y barras, es posible sustituir el color de una categoría con una imagen elegida del Catálogo de imágenes de la vista.

Imagen y color son alternativos:

  • seleccionando una imagen, el color y el comando fx de la misma categoría se desactivan;
  • durante la carga del activo no se muestra un color provisional;
  • eliminando la imagen vuelve disponible la configuración del color;
  • para cada imagen se puede elegir Rellenar, Contener o Repetir.

Verificar en Vista Previa que el recorte y la legibilidad de la imagen sean adecuados al tamaño y la forma de los elementos del gráfico.

Filtros​

Hay filtros disponibles para:

  • categoría;
  • valor libre;
  • rango de fechas;
  • rango numérico.

Cada filtro puede estar conectado a uno o más widgets objetivo. Los widgets Filtros activos y Restablecer filtros hacen visibles y anulables las selecciones del usuario.

Cuando Filtro categorías usa una fuente derivada de un Modelo Semántico, el filtro se aplica como campo del modelo: Sybot usa entonces las relaciones definidas en el modelo para alcanzar los widgets objetivo alimentados por el mismo modelo, incluso si las respectivas fuentes seleccionan campos diferentes.

En el panel Propiedades, Selección categorías permite elegir entre:

  • Simple, para aplicar un valor a la vez;
  • Múltiple, para abrir una lista desplegable con casillas de verificación y aplicar juntos hasta cien valores.

El resumen de la lista indica cuántos valores están seleccionados. El widget Filtros activos los muestra en el mismo filtro y Restablecer filtros los elimina en una sola operación. La lista no se filtra por sí sola: después de la primera selección, las otras categorías compatibles quedan disponibles para agregar más casillas de verificación.

El panel Filtros avanzados, cuando se habilita en las propiedades de la vista, recopila los campos filtrables de la página incluso sin un widget dedicado.

Interacciones entre widgets​

Gráficos y tablas pueden enviar una selección a otros widgets.

Ejemplos:

  • seleccionar una barra para filtrar una tabla;
  • elegir una fila para mostrar su detalle en un cajón;
  • usar una jerarquía para pasar de una categoría general a un nivel más específico;
  • mostrar o ocultar un grupo de widgets mediante Visibilidad de widgets.

La selección es un contexto de la interfaz y no sustituye los controles de autorización ejecutados por Sybot.

En la Tabla de datos, la selección simple ocurre haciendo clic directamente en la fila y no muestra botones de radio. La selección múltiple mantiene en cambio las casillas de verificación, útiles para verificar qué filas participan en una acción masiva.

Mapas​

La Mapa de puntos cluster usa coordenadas geográficas y agrupa automáticamente los puntos durante zoom y redimensionamiento.

La Mappa coropletica colore áreas en función de un valor agregado. Están disponibles ámbitos geográficos predefinidos; para necesidades específicas se puede usar un mapa personalizado compatible. Los presets reconocen códigos geográficos y nombres tanto italianos como ingleses. Las umbrales se configuran a través de límite, etiqueta y selector de color; solo el último puede ser sin límite superior.

Verificar siempre en Vista Previa que claves geográficas, coordenadas y umbrales correspondan a los datos disponibles.

Flujo de Widget​

Los widgets de Flujo permiten, según los permisos:

  • Iniciar un Flujo;
  • Pasar parámetros estáticos o valores del registro seleccionado;
  • Ejecutar una acción en uno o más registros;
  • Mostrar estado, progreso y registro;
  • Interrumpir una ejecución activa;
  • Actualizar otros widgets después de la finalización.

Para los widgets que inician un Flujo, el Editor carga los parámetros configurados en el Flujo, excluidos los de tipo archivo. Es posible:

  • Establecer un valor predeterminado directamente en las propiedades del widget;
  • Activar fx para calcular el valor predeterminado a partir de filtros y contextos disponibles;
  • Elegir si mostrar el panel de parámetros antes del inicio y en Vista Previa;
  • Dejar el panel desactivado para usar directamente los valores predeterminados y mapeados configurados.

Cuando está habilitado, el panel aparece como una superposición compacta: el usuario puede controlar y modificar los valores editables en un solo paso. En Vista Previa, el panel muestra el resultado de la configuración, pero no inicia el Flujo. Los valores protegidos no se almacenan en la Vista; dejándolos vacíos se mantiene el valor predeterminado protegido del Flujo.

Antes de publicar:

  1. Seleccionar el Flujo autorizado;
  2. Configurar valores predeterminados, fórmulas o mapeados de parámetros;
  3. Agregar un texto de confirmación para las acciones relevantes;
  4. Verificar en Vista Previa el panel de parámetros;
  5. Probar inicio, error y parada desde la versión publicada;
  6. Verificar el comportamiento con un usuario no propietario.

Diagnóstico​

Cuando una fuente falla, la vista muestra un mensaje seguro y, si está disponible, una referencia para comunicárselo al administrador.

Verificar:

  • Que la fuente esté aún activa;
  • Que el Modelo Semántico esté publicado;
  • Que los parámetros requeridos tengan un valor;
  • Que el usuario disponga de los proyectos y roles necesarios;
  • Que la estructura de datos no haya cambiado.