Novedad: el cortafuegos de IA supervisa toda la plataforma y explica cada incidente con palabras sencillas. Vea cómo funciona

Fuentes de datos y parámetros

Vincule tarjetas a datos de dispositivos, alarmas y sitios, elija agregados y ventanas de tiempo, y use parámetros y filtros de clave para que un mismo panel sirva a muchos dispositivos.

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:

  1. Elige la fuente y la consulta, por ejemplo Un valor de un dispositivo (en vivo).
  2. Completa sus campos: el dispositivo (o Tomarlo del tablero, ver más abajo) y el valor.
  3. 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

ConsultaDevuelveEn vivo
Un valor de un dispositivo (en vivo)Una clave de un dispositivo, elegida entre los valores que envía el dispositivoSí
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 filasSondeado
Últimos valores de un dispositivo como un único registroHasta 20 claves de un dispositivo como un registro (para Atributos o un Formulario)Sondeado
Todos los últimos valores de un dispositivoUna 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 3DUna 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 personaLa fila de un elemento, su tendencia o sus lecturas por nombreMixto
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 filasSí
Un atributo del dispositivo en una posición de un conjuntoUn atributo de servidor o compartido, por ejemplo la dirección en vivo de una cámaraSondeado
Alarmas (en vivo)Alarmas por estado (Activa, Abierta, Reconocida, Resuelta, Todos los estados) y gravedad; como máximo 500 filasSí
Recuento de alarmas por gravedad (en vivo)Un recuento por gravedadSí
Sitios y activos (el árbol como filas), Activos de un alias, Dispositivos bajo un activoEl árbol de activos, los activos de un parámetro, los dispositivos bajo un activoSondeado
Estado bajo un activoUna fila por hijo: peor estado, dispositivos, alarmas abiertasSondeado
Un sitio para la cabecera de una páginaNombre, ubicación, estado, dispositivos, alarmas abiertas, última vez vistoSondeado

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.

AjusteValores
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 calendarioEsta 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 larga366 días
Intervalo de agrupaciónauto, 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 ventana500 (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ónPor intervalo
avg, min, maxValor medio, más bajo, más alto
lastEl último valor
sum, countTotal, número de lecturas
increasePara 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.

TipoEjemplo
Valor: texto, Valor: número, Valor: fecha, Valor: sí o no, Valor: lista fija, Valor: lista desde una direcciónUn 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:

AjusteOpciones
Cómo se eligeEl 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 variasUna entidad o Varias entidades
En la barra de filtrosVisible, 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.