Cada tarjeta de datos lee una fuente de datos: una consulta que devuelve un valor, una serie, una tabla o un registro. Los parámetros hacen que un mismo tablero funcione para muchos dispositivos o sitios. Los filtros de clave reducen un conjunto de dispositivos según sus valores. Esta página enumera las fuentes de IoT, explica cómo funcionan la ventana temporal y las agregaciones, y muestra cómo crear un tablero que sigue el dispositivo o sitio que elija el visualizador.
Cómo obtiene datos una tarjeta
Un widget declara slots: lo que necesita, nunca de dónde viene. Un medidor necesita un valor; un gráfico de líneas necesita una serie; una tabla necesita filas. En la pestaña Datos de la tarjeta, rellena cada slot:
- Elige la fuente y la consulta, por ejemplo Un valor de un dispositivo (en vivo).
- Completa sus campos: el dispositivo (o Tomarlo del tablero, ver más abajo) y el valor.
- Selecciona Guardar.
El slot de serie de un gráfico de líneas, de barras o de áreas admite hasta 8 fuentes (+ Añadir otra fuente), así que un mismo gráfico puede mostrar valores de varios dispositivos.
Incluir también los datos de muestra y las fuentes de desarrollador muestra fuentes pensadas para pruebas. Desactívalo en los tableros de producción.
Fuentes de datos IoT
| Consulta | Devuelve | En vivo |
|---|---|---|
| Un valor de un dispositivo (en vivo) | Una clave de un dispositivo, elegida entre los valores que envía el dispositivo | Sí |
| Lecturas de un dispositivo a lo largo del tiempo (en vivo) | Hasta 20 claves de un dispositivo en la ventana temporal, agregadas por intervalo. auto sigue los primeros números que envía el dispositivo. | Sí |
| Últimos valores de muchos dispositivos (una fila por dispositivo) | Una fila por dispositivo (todos, un perfil o los dispositivos de un parámetro) con hasta 20 claves; como máximo 500 filas | Sondeado |
| Últimos valores de un dispositivo como un único registro | Hasta 20 claves de un dispositivo como un registro (para Atributos o un Formulario) | Sondeado |
| Todos los últimos valores de un dispositivo | Una fila por clave con su nombre y su unidad (como máximo 500) | Sondeado |
| Los valores en vivo de un dispositivo, para su plano o vista 3D | Una fila por elemento de un dispositivo que envía claves <element>.<field> | Sondeado |
| Un elemento del diagrama de proceso de un dispositivo, Un elemento de un dispositivo a lo largo del tiempo (en vivo), Las lecturas de un elemento, con nombre para una persona | La fila de un elemento, su tendencia o sus lecturas por nombre | Mixto |
| Dispositivos (estado de conexión en vivo) | Tus dispositivos con conexión, estado, perfil y última vez visto; filtros por perfil, estado y conexión; como máximo 500 filas | Sí |
| Un atributo del dispositivo en una posición de un conjunto | Un atributo de servidor o compartido, por ejemplo la dirección en vivo de una cámara | Sondeado |
| Alarmas (en vivo) | Alarmas por estado (Activa, Abierta, Reconocida, Resuelta, Todos los estados) y gravedad; como máximo 500 filas | Sí |
| Recuento de alarmas por gravedad (en vivo) | Un recuento por gravedad | Sí |
| Sitios y activos (el árbol como filas), Activos de un alias, Dispositivos bajo un activo | El árbol de activos, los activos de un parámetro, los dispositivos bajo un activo | Sondeado |
| Estado bajo un activo | Una fila por hijo: peor estado, dispositivos, alarmas abiertas | Sondeado |
| Un sitio para la cabecera de una página | Nombre, ubicación, estado, dispositivos, alarmas abiertas, última vez visto | Sondeado |
Los nombres, unidades, decimales y rangos de valores proceden de las claves de telemetría del perfil del dispositivo. Cada consulta comprueba tus permisos: un dispositivo que no puedes leer responde como vacío, igual que uno que no existe.
Ventana temporal y agregaciones
Un gráfico que sigue la ventana del tablero (Usar la ventana temporal del tablero) muestra el periodo que el visualizador elija en la barra de herramientas. Una tarjeta también puede fijar su propia ventana (Fijar: últimos …) o mostrar el periodo inmediatamente anterior (misma duración) para comparar.
| Ajuste | Valores |
|---|---|
| Ventanas relativas | Últimos 5, 15 o 30 minutos; 1, 6, 12 o 24 horas; 3, 7, 14, 30, 90 o 365 días; cualquier otro «últimos N minutos, horas o días» |
| Periodos de calendario | Esta hora, Hoy, Esta semana, Esta semana (lun.), Este mes, Este trimestre, Este semestre, Este año, y el anterior de cada uno; Ayer, Anteayer, Este día la semana pasada |
| Ventana más larga | 366 días |
| Intervalo de agrupación | auto, 1, 5, 10, 15 o 30 minutos, 1, 2, 6 o 12 horas, 1 o 7 días |
| Número máximo de intervalos en una ventana | 500 (un intervalo más fino se agrupa con menos detalle) |
Con auto, una ventana de hasta 1 hora se agrupa por minuto, hasta 1 día por 5 minutos, hasta 7 días por hora, y las ventanas más largas por día.
La agregación de Lecturas de un dispositivo a lo largo del tiempo es una de las siguientes:
| Agregación | Por intervalo |
|---|---|
avg, min, max | Valor medio, más bajo, más alto |
last | El último valor |
sum, count | Total, número de lecturas |
increase | Para contadores (contadores de energía o de agua): el aumento desde el intervalo anterior. Una bajada se toma como un reinicio del contador y se cuenta desde cero. El primer intervalo cuenta lo que subió dentro de él. |
Las ventanas de más de 24 horas se responden a partir de agregados almacenados, no de lecturas en bruto. Las lecturas en bruto se conservan de 7 a 90 días según la clase de retención de su organización (definida por su plan); los agregados por minuto hasta 31 días; los agregados horarios y diarios durante toda la clase (hasta 1.095 días). Consulte Cuánto tiempo se conservan los datos y Agregados y consolidaciones.
Una ventana sin zona horaria usa la zona horaria del navegador del visualizador. Los ajustes del tablero pueden permitir a los visualizadores cambiar el Intervalo de agrupación, la Agregación (Media, Mínimo, Máximo, Suma, Recuento, Ninguna (valores en bruto)) y la Zona horaria. Guardar como predeterminado (solo editores) mantiene la ventana para todos.
Parámetros
Un parámetro es un valor o una entidad que leen las tarjetas. Abre Gestionar parámetros… mientras personalizas. Un tablero admite hasta 16 parámetros de valor y 48 parámetros en total; la barra de filtros muestra como máximo 16.
| Tipo | Ejemplo |
|---|---|
| Valor: texto, Valor: número, Valor: fecha, Valor: sí o no, Valor: lista fija, Valor: lista desde una dirección | Un umbral, un turno, un producto |
| Entidad (un dispositivo, un activo…) | El dispositivo del que trata la página |
Para un parámetro de entidad eliges:
| Ajuste | Opciones |
|---|---|
| Cómo se elige | El visualizador elige; La página o un enlace lo define; Fijo: una entidad; Fijo: una lista; Todos del tipo; Por nombre; Por subtipo o perfil; Relacionado con otro parámetro o entidad |
| Una o varias | Una entidad o Varias entidades |
| En la barra de filtros | Visible, el visualizador puede cambiarlo, Visible, no modificable, Oculto |
La clave de un parámetro empieza por una letra minúscula y tiene como máximo 40 letras, dígitos o guiones bajos. Renombrar una clave rompe las tarjetas y los enlaces que usan la anterior. No puedes eliminar un parámetro que tarjetas, páginas, filtros u otros parámetros siguen usando; la ventana los nombra.
Vincular una tarjeta a un parámetro
En el campo de datos de la tarjeta, elige Tomarlo del tablero y selecciona el parámetro, o El dispositivo que muestra esta página. Cuando una tarjeta toma un dispositivo y el parámetro contiene un sitio, la tarjeta toma los dispositivos bajo el sitio; si hay varios, indica «North plant tiene 4 dispositivos; elige uno». Las elecciones del visualizador se guardan en la dirección de la página (?p.device=…), de modo que un enlace copiado abre la misma vista.
Límites: un conjunto resuelto contiene como máximo 500 entidades (las primeras 500 por nombre); una lista fija contiene como máximo 100; profundidad de relación de 1 a 10 niveles.
Filtros de clave
Un filtro de clave acota un parámetro de entidad por valores, por ejemplo «dispositivos cuya temperature es superior a 30″. Abra Manage key filters….
- Una clave es un Entity field, un Attribute (con ámbito any, client, shared o server) o Latest telemetry.
- Tipos de valor: Text, Number, Boolean, Date and time.
- Operaciones: equal, not equal, greater, greater or equal, less, less or equal, between, in, not in, is set, is not set, is true, is false, starts with, ends with, contains, does not contain.
- Una las condiciones con And: all of them match o Or: any of them matches.
- Marque un filtro como editable para que los visualizadores puedan cambiarlo.
Límites: 16 filtros por panel, 8 filtros de clave por filtro, 4 condiciones por filtro de clave.
Datos en vivo
Las tarjetas marcadas como en vivo se actualizan mientras el panel está abierto. Un panel usa una única conexión para todas sus tarjetas. Las tarjetas que no pueden actualizarse en vivo se refrescan según su intervalo; una tabla que pagina siempre se refresca según su intervalo. Cuando la conexión en vivo no está disponible, el panel muestra «Live updates unavailable — polling».
Lecturas en registros de negocio
Una clave de dispositivo también puede alimentar un campo de un registro de negocio, por ejemplo el contador de un activo. Configúrelo en Readings mapping dentro del menú ⋯ de Devices, o en la pestaña Feeds de un dispositivo.

