Documentação > Key concepts > Entidades e Relacionamentos
Primeiros Passos
Arquitetura API FAQ

Entidades e Relacionamentos

Visão Geral das Entidades

A RETINA fornece a interface do usuário e APIs REST para provisionar e gerenciar vários tipos de entidade e suas relações em seu aplicativo IoT. As entidades com suporte são:

  • Administrador de locatários - você pode tratar o inquilino como uma entidade comercial separada: é um indivíduo ou uma organização que possui ou produz dispositivos e ativos; O locatário pode ter vários usuários administradores locatários e milhões de clientes, dispositivos e ativos;
  • Clientes - o cliente também é uma entidade comercial separada: indivíduo ou organização que compra ou usa dispositivos e / ou ativos de locatário; O cliente pode ter vários usuários e milhões de dispositivos e / ou ativos;
  • Users - os usuários podem navegar pelos painéis e gerenciar entidades;
  • Devices - entidades IoT básicas que podem produzir dados de telemetria e manipular comandos RPC. Por exemplo, sensores, atuadores, switches;
  • Ativos - entidades IoT abstratas que podem estar relacionadas a outros dispositivos e ativos. Por exemplo, fábrica, campo, veículo;
  • Visualização de entidades - útil se você gostaria de compartilhar apenas parte dos dados do dispositivo ou ativos para os clientes;
  • Alarms - eventos que identificam problemas com seus ativos, dispositivos ou outras entidades;
  • Dashboards - visualização de seus dados de IoT e capacidade de controlar dispositivos específicos por meio da interface do usuário;
  • Regra de Nó - unidades de processamento para mensagens recebidas, eventos de ciclo de vida de entidades, etc;
  • Cadeia de Regras - define o fluxo do processamento no Mecanismo de Regras. Pode conter muitos nós de regras e links para outras cadeias de regras;

Cada entidade suporta:

  • Atributos - pares de valores-chave estáticos e semiestáticos associados a entidades. Por exemplo, número de série, modelo, versão de firmware;
  • Dados de série temporal -pontos de dados de série temporal disponíveis para armazenamento, consulta e visualização. Por exemplo, temperatura, umidade, nível da bateria;
  • Relacionamentos - conexões dirigidas a outras entidades. Por exemplo, contém, gerencia, possui, produz.

Alfgumas entidades suportam perfis:

  • Administrador de locatários -contém configurações comuns para vários inquilinos: entidade, API e limites de taxa, etc. Cada inquilino tem o único perfil em um único momento.
  • Perfis de Dispositivos - contém configurações comuns para vários dispositivos: configuração de processamento e transporte, etc. Cada dispositivo tem o único perfil em um único ponto no tempo.

Grupo de Entidades:

A RETINA permite configurar Grupos de Entidades para Clientes, Usuários, Dispositivos, Ativos, Visualizações de Entidades e Painéis. Cada entidade pode pertencer a vários grupos simultaneamente. O Grupo de Entidades sempre tem um proprietário - Locatário ou Cliente específico. Todas as entidades do grupo devem ter o mesmo tipo de entidade (ou seja, você não pode colocar o dispositivo e o ativo em um grupo). Grupos de entidades são úteis para painéis e processamento de dados, mas o principal motivo de sua existência é para oferecer suportecontrole de acesso baseado em funções avançadas (RBAC)para IoT.

Integrações e Conversão de dados:

O recurso de integração da plataforma RETINA foi projetado para dois casos de uso / opções de implantação principais:

  • Conecte NB IoT, LoRaWAN, SigFox e outros dispositivos existentes com formatos de carga útil específicos diretamente à plataforma RETINA.
  • Transmita dados de dispositivos conectados a plataformas IoT existentes para permitir painéis interativos em tempo real e processamento de dados eficiente.

Conversores de dados são parte do recurso Integrações de plataforma. Seu objetivo é transformar a carga útil bruta do dispositivo para o formato que o RETINA usa e vice-versa.

Este guia fornece uma visão geral dos recursos listados acima, alguns links úteis para obter mais detalhes e exemplos da vida real de seu uso.

Relacionamentos

A relação de entidade define a conexão entre duas entidades RETINA que pertencem ao mesmo Administrador de locatários. A relação tem um tipo arbitrário: Contém, Gerencia, Suporta, etc. A relação também é direcional. Você pode tratar as relações RETINA como um Tem-um relacionamento da programação orientada a objetos.

Relações ajudam a modelar objetos do mundo físico em RETINA. A maneira mais fácil de entendê-los é usando o exemplo. Vamos supor que queremos construir um aplicativo que coleta dados de sensores de umidade e temperatura do solo, visualize esses dados no dashboard, detectar problemas, aumentar alarmes e controlar a irrigação. Suponhamos também que queremos oferecer suporte a vários campos com centenas de sensores. Os campos também podem ser agrupados nas regiões geográficas.

O diagrama a seguir explica como essas entidades são configuradas e armazenadas em RETINA:

image

See “add and delete assets” e “manage asset relations” to learn how to configure this entities via Administration UI. You may also use REST API to create Entidades e Relacionamentos programmatically.

Assign attributes to the assets and devices

ThingsBoard provides the ability to assign attributes to entities and manage them. You are welcome to learn how to do it here:

Working with device attributes

Upload telemetry data from devices

ThingsBoard provides the ability to work with telemetry data for devices and other entities. You are welcome to learn how to do it here:

Working with telemetry data

Creating Rules for Alarms

ThingsBoard provides the ability to raise alarms using rule engine for devices and other entities. You are welcome to learn how to do it here:

Working with alarms

Design your dashboard

Please import the following dashboard that demonstrates Map, Alarm, Entity Table and Charts widgets.