Expansão dinâmica de unidades de dispositivo (UDE)

A UDE usa um conjunto de templates para gerenciar dispositivos semelhantes. Ao adicionar um dispositivo, gera automaticamente pontos agregados, grupos e configurações de compartilhamento. Após alterações nos templates, a “reconciliação” permite atualizar as instâncias existentes.

Templates e instâncias

Objeto	Função
Tipo de unidade de dispositivo	Define regras de nomenclatura e templates para dispositivos semelhantes
Instância de unidade de dispositivo	Uma unidade específica em um dispositivo, como METER#1
Template de agregação	Gera pontos de cálculo, unidades, expressões e valores iniciais
Template de agrupamento	Gera grupos com relações entre pais e filhos, mapeamentos de pontos e ordenação
Template de compartilhamento	Gera listas de pontos compartilhados e vincula destinos de compartilhamento

O sistema processa na ordem Agregação → Agrupamento → Compartilhamento, permitindo que uma etapa referencie os resultados da anterior. Os templates de agrupamento permitem consultas em árvore e a definição de um grupo pai; uma instância individual também pode substituir o grupo pai raiz.

Nomenclatura e reconhecimento automático

Por exemplo, em METER#1_power, METER#1 é o prefixo da instância e power é o sufixo do ponto. O prefixo da instância não pode conter sublinhados, deve ser exclusivo no mesmo dispositivo, e dispositivos semelhantes devem seguir a mesma regra de sufixos.

Durante a sincronização das configurações do CommBridge e a chegada de dados compartilhados, o sistema identifica instâncias que correspondem às regras. Também é possível varrer dados existentes para incluir dispositivos cujos templates foram configurados posteriormente.

Placeholders dinâmicos

Dispositivos diferentes podem ter nomes, posições de agrupamento ou origens diferentes. Use placeholders {token} para reutilizar o mesmo template:

• Conjunto de regras: organiza um grupo de placeholders e pode ser vinculado a um tipo de unidade de dispositivo.
• Regra de correspondência: gera valores de placeholders com base no código do dispositivo, prefixo da instância ou número de série.
• Escopo de aplicação: agrupamento, dispositivo de origem, expressão, valor inicial ou configuração de compartilhamento.
• Simulação e prévia de impacto: confira o resultado renderizado antes de salvar e consulte o escopo afetado antes de desabilitar ou excluir uma regra.

Os placeholders {token} da UDE são processados durante a geração do template; os ${dataKey} de Lua leem pontos durante a execução da expressão. Como têm finalidades diferentes, após simular o template também é necessário validar as expressões Lua geradas.

Como a reconciliação atualiza as configurações

A reconciliação cria configurações ausentes e atualiza campos gerenciados pelos templates, mapeamentos de grupos e vínculos de compartilhamento. Ela não se limita a “adicionar sem alterar”.

1. Defina tipos e templates e prepare os grupos pais e destinos de compartilhamento a referenciar.
2. Execute a reconciliação para uma instância de teste e confira os resultados gerados.
3. Após confirmar, execute a reconciliação em lote para esse tipo ou para todos os tipos.
4. Consulte o estado de materialização e os erros das instâncias. Quando a interface informa “Agendado”, o processamento em segundo plano pode ainda estar em andamento.

Na versão atual, salvar ou excluir um template valida a alteração e agenda as instâncias existentes afetadas. Confirme o escopo de impacto antes de publicar. Se o grupo pai ainda não estiver pronto, consulte o estado e as informações de novas tentativas, corrija as dependências e confira novamente os resultados.

As configurações geradas incluem informações de propriedade e impressões digitais para identificar alterações dos templates e conflitos com edições manuais. Quando o valor inicial do template de agregação não muda, repetir a reconciliação não redefine valores normais de execução para o padrão. Após excluir um template ou alterar um código, não presuma que todos os objetos de negócio anteriores serão excluídos automaticamente; confira as referências e os resultados da limpeza.

Cenários de uso

A UDE reduz configurações repetitivas quando há expansão de dispositivos do mesmo modelo, reutilização entre instalações ou muitos dispositivos. Para poucos dispositivos fixos, também é possível gerenciar os pontos diretamente.

Recursos relacionados: Modelo de dados e Compartilhamento entre dispositivos. Para configurar pelo Agent, use as Skills de UDE e placeholders dinâmicos, que permitem configurar templates e instâncias, simular regras, analisar impactos e publicar.