Pular para o conteúdo
JelinaJelina DocumentationDocumentação técnica
Voltar ao site oficial

Modelo de dados e agrupamento

O Edge-EMS Builder divide os pontos em quatro categorias e usa dataKey para conectar aquisição, cálculo, estratégias e compartilhamento, sem que os scripts de negócio precisem operar diretamente os registradores dos dispositivos.

Tipo Origem Usos comuns
Dados originais (Collection) Valores adquiridos pelo CommBridge e estado de comunicação Tensão, temperatura e estado do dispositivo; pontos graváveis também podem ser usados para controle
Dados agregados (Aggregation) Expressões Lua ou valores de execução armazenados Soma de potências, avaliação de estados e variáveis de execução
Dados por faixa de horário (Customization) Configurações manuais ou de estratégias com intervalos de vigência Tarifas de energia, modos de operação e curvas programadas
Dados compartilhados (Share) Outros nós EMS Builder Cálculo e controle entre nós

Os pontos compartilhados são endereçados pelo código do dispositivo de origem e pelo dataKey. A gravação de dados originais ou compartilhados depende, em última instância, da capacidade de gravação e das permissões do dispositivo de destino; nem todo ponto de aquisição é um ponto de controle.

Os pontos têm nome, alias e unidade, e essas propriedades são sincronizadas no compartilhamento. Os pontos originais podem sincronizar o coeficiente de leitura do CommBridge; quando não há coeficiente configurado e para pontos de estado, o retorno pode ser nulo.

A conversão inversa pelo coeficiente na gravação da aquisição é realizada pelo CommBridge; os scripts ou chamadores do Edge-EMS Builder não precisam repeti-la. Os valores lidos e os valores de destino enviados devem usar unidades de engenharia previamente confirmadas.

  • DAILY_CHANGE: cada valor entra em vigor em um intervalo completo de data e hora.
  • DAILY_REPEAT: cada valor usa uma faixa de horário diária, e a configuração define separadamente o intervalo geral de datas de vigência.

Por exemplo, uma tarifa com repetição diária pode definir o preço das 08:00 às 12:00 e as datas em que todo o plano se aplica. Antes de substituir um plano completo, confira os períodos existentes e suas sobreposições.

Um ponto agregado pode ser calculado por uma expressão ou usar useLatestValue para armazenar e ler um valor de execução. Ao criar uma variável de execução, é possível definir um valor inicial; quando gerada por UDE, também é possível usar um template de valor inicial.

Em fórmulas, dados ausentes são representados pela string __Null__. Para cálculos numéricos, use tonumber e trate explicitamente os dados ausentes, evitando interpretá-los como zero. Consulte as funções e os exemplos em Mecanismo de expressões.

As quatro categorias de pontos podem ser adicionadas a grupos com relações entre pais e filhos. É possível definir a ordem dos subgrupos e dos pontos de cada grupo, alterar informações básicas e escolher como tratar subgrupos durante a exclusão. Consulte ou assine dados por grupo para organizar a interface por dispositivo, área ou finalidade.

Quando houver muitos dispositivos semelhantes, use templates UDE para gerar grupos e mapeamentos automaticamente.

Próximos passos: Consulta ao histórico, Perfis de acionamento, Compartilhamento entre dispositivos e Leitura e gravação pelo frontend.