Perfis de acionamento

Um perfil de acionamento organiza “quando verificar, quais condições avaliar e quais ações executar” em regras reutilizáveis.

Estrutura do perfil

Um perfil pode conter vários gatilhos; cada gatilho contém condições e ações, e as condições podem ser combinadas com AND / OR. O perfil pode ser habilitado ou desabilitado e ter um período geral de vigência.

Condição	Finalidade
CRON	Executa conforme um agendamento de calendário
TIME_POINT	Executa em horários diários especificados, podendo ser combinado com o período de vigência do perfil
TIME_PERIOD	Verifica dentro de um intervalo de tempo especificado
INTERVAL	Verifica em intervalos fixos
DATA_CHANGE	Avalia a condição quando um ponto muda, com suporte a dados compartilhados

Scripts de condições de dados retornam um valor booleano. Trate explicitamente os dados ausentes ou converta-os primeiro com tonumber, evitando interpretá-los como observações válidas.

Ações e valores de retorno

As ações podem gravar em pontos graváveis, planos por faixa de horário, variáveis agregadas ou dispositivos remotos, além de registrar alarmes, enviar observações de alarmes e publicar por MQTT.

Perfil ou cenário	Retorno do script
Perfil EXPRESSION	Array de ações com índices a partir de 1
Gravação de ponto único MIXED	Um único valor correspondente ao ponto
Condição de alteração de dados	true / false

Por exemplo, para atualizar uma variável agregada de execução em uma ação EXPRESSION:

return {buildGeneralWriteMap("Aggregation", "demo_state", "ready", false)}

Antes de usar, substitua os pontos de exemplo pelos pontos realmente configurados. As funções apenas constroem ações a executar; isso não significa que o dispositivo já as executou com sucesso.

Regras de alarme

Notificações simples podem gerar registros individuais de alarme. Quando for necessário um fluxo de recuperação e tratamento, use eventos de alarme: informe continuamente observações ACTIVE, NORMAL ou UNKNOWN, sem acionar apenas em caso de anomalia.

Pós-processamento e registros de execução

As ações permitem configurar pós-processamento por needPostProcess / postProcessContent. A validação de scripts pode verificar a estrutura de retorno, mas a expressão será avaliada; confira previamente os efeitos colaterais de scripts que contêm chamadas diretas.

Os registros de acionamento permitem verificar condições, resultados de execução e erros. Ao controlar dispositivos, consulte também os logs de controle de dispositivos e a leitura de retorno dos pontos, distinguindo o envio da solicitação de sua execução real.

Dispositivos dinâmicos e habilitação dos perfis

Consultas por prefixo, sufixo e outros padrões permitem lidar com uma quantidade variável de dispositivos. Consultas em lote retornam tabelas indexadas por dataKey; use pairs(). Para padrões de consulta montados dinamicamente, verifique se as dependências estão completas. Os pontos afetados podem ser configurados no perfil, e seus valores atuais aparecem nos detalhes para facilitar a compreensão da estratégia.

Perfis desabilitados, excluídos ou fora de vigência têm suas tarefas de execução descarregadas, e o estado do perfil pai é verificado antes da execução. Comandos já enviados aos dispositivos ainda exigem verificação dos resultados reais. Limite a frequência de estratégias de alta frequência conforme necessário para reduzir envios repetidos.

Para scripts detalhados, consulte a Referência de ações de gatilho e a Referência Lua. Para configurar pelo Agent, use a Skill de perfis de acionamento.