Nó Iniciar Atributo

Visão geral técnica e capacidades

No IoT Logic, Iniciar Atributo o nó transforma leituras do dispositivo criando novos atributos de dados com base na telemetria recebida. Este nó permite manipular dados por meio de fórmulas matemáticas, renomear parâmetros existentes e executar operações em nível de bit usando o Navixy Expression Language. O nó serve como um componente chave em um fluxo, permitindo enriquecer os dados antes de enviá-los aos seus sistemas de destino.

Iniciar Atributo o nó é configurado para cada fluxo na interface da plataforma Navixy. Para opções de sintaxe específicas e referência detalhada da linguagem de expressão, veja Navixy Expression Language na documentação do usuário.

Initiate attribute node in the flow workspace showing the node connected to other nodes in the flow

Integração na arquitetura do fluxo

Iniciar Atributo o nó funciona dentro da arquitetura de fluxo proporcionando capacidades de transformação de dados e permitindo:

  • Processar dados brutos de telemetria em métricas de negócio significativas

  • Criar campos calculados com base em múltiplos valores de parâmetros

  • Converter unidades de medida (por exemplo, quilômetros para milhas)

  • Calcular diferenças entre leituras atuais e anteriores

  • Gerar análises temporais sobre o comportamento do dispositivo

O nó Iniciar atributo requer pelo menos um Data Source nó conectado a ele. Nenhum cálculo será realizado sem conexões de entrada de dados.

Capacidades do nó

O Iniciar Atributo nó por si só oferece:

  • Transformação de atributo de dados: Crie atributos completamente novos aplicando operações matemáticas sobre os que vêm das fontes de dados

  • Conversão de unidade: Converter unidades de medida (por exemplo, velocidade de km/h para mph, ou temperatura de °C para °F)

  • Cálculos baseados em tempo: Comparar leituras atuais com valores anteriores para determinar variações

  • Manipulação de tempo: Personalizar timestamps referentes à geração do atributo no dispositivo e quando foi recebido pelo servidor para evitar inconsistências na linha do tempo e unificar formatos de tempo

Opções de configuração

Iniciar Atributo o nó permite definir como os parâmetros do dispositivo são transformados em atributos, que estarão disponíveis para processamento adicional em seu fluxo de dados.

Initiate attribute node configuration panel showing the list of attributes and the Add New Attribute button

Vamos ver quais elementos este nó utiliza e o que você pode configurar ao trabalhar com ele:

Etapas de configuração

1

Especifique Nome do nó

Insira um nome descritivo para destacar o propósito do nó. Use um nome que ajude a identificar os cálculos que serão feitos dentro deste nó; ele será exibido no diagrama do fluxo para fácil identificação.

2

Ativar Especificar atributos de tempo

se precisar manipular timestamps de eventos, isso habilita mais duas opções:

  • Hora de geração: Quando os dados foram criados (padrão para now())

  • Hora do servidor: Quando os dados foram recebidos pelo IoT Logic (padrão para now())

3

Defina Nome do atributo

Adicione um identificador distintivo do atributo.

  • Este nome será exibido em Data Stream Analyzer,

  • Você também pode usar este nome para criar sensores personalizados no módulo Tracking Para fazer isso, o Iniciar Atributo nó contendo este atributo deve estar conectado ao Default Output Endpoint nó.

4

Defina Fórmula

Adicione expressões matemáticas para calcular os valores dos atributos.

  • Use value('parameter_name' 0, 'valid') formato para referenciar parâmetros existentes do dispositivo. Observação. Clique image-20250605-115154.png dentro do Fórmula campo para abrir a lista de atributos disponíveis e selecionar o necessário. Ele será adicionado ao campo automaticamente no formato pronto para uso. Para detalhes sobre preenchimento automático de nomes de atributos, veja Autofill attribute names.

  • Aplique operações matemáticas com base na Navixy IoT Logic Expression Language para transformar valores.

  • Use diferentes valores de índice de profundidade para acessar valores históricos (o padrão é 0).

5

(opcional) Clique Add Attribute

Abra um novo diálogo de configuração de atributo. Aqui você pode criar um novo atributo de dados caso precise que múltiplos cálculos sejam realizados dentro do mesmo nó.

Vamos ver um exemplo prático de configuração de atributos:

Iniatiate attribute node configuration window with node name Speed conversions, Attribute name KMPH to MPH and formula

Neste exemplo, estamos criando um atributo que converte velocidade de quilômetros para milhas por hora dividindo o parâmetro de velocidade CAN por 1.609.

Para detalhes sobre cálculos para novos atributos, veja Calculation examples.

Além disso, você pode encontrar um exemplo detalhado de uso de atributos calculados em um fluxo em Flow configuration example → steps 3 and 4.

Opções de exibição

Novos atributos calculados dentro do Iniciar Atributo nó podem ser monitorados assim como os atributos de dados reais vindos dos dispositivos no Data Stream Analyzer (DSA) e no módulo Tracking .

Para mais informações sobre as opções de exibição, veja Exibindo novos atributos calculados na plataforma Navixy.

Considerações sobre o fluxo de dados

Após configurar seu Iniciar Atributo nó, certifique-se de:

  1. Conectar o nó a pelo menos um Data Source nó como entrada

  2. Conectar a saída a um Output Endpoint nó para enviar os dados transformados

Dentro do Iniciar Atributo nó, os valores dos parâmetros são processados de acordo com suas expressões cada vez que o dispositivo fornece dados. Na saída, você receberá:

  • Todos os parâmetros originais do dispositivo

  • Todos os atributos calculados com seus valores

  • Valores atualizados de hora de geração e hora do servidor conforme configurado

Se você usar o mesmo nome para um atributo calculado que coincida com um parâmetro existente, o atributo substituirá o parâmetro original no pacote de dados de saída.

Perguntas frequentes

Posso referenciar valores não mais recentes em meus cálculos?

Sim. Use o parâmetro de índice na função value para acessar valores históricos. Por exemplo, value('temperature', 1, 'valid') refere-se ao valor válido anterior do parâmetro temperature.

Como faço cálculos envolvendo tempo?

Use as funções genTime() e srvTime() para trabalhar com timestamps. Você pode calcular diferenças de tempo, adicionar offsets de tempo ou formatar timestamps para exibição.

O que acontece se eu excluir um atributo?

O atributo deixará de ser calculado para dados recebidos posteriormente, mas os dados históricos permanecem inalterados. O atributo não aparecerá em nenhum novo pacote de dados após a exclusão.

Posso usar atributos criados em um nó Iniciar atributo em outro?

Sim. Atributos criados anteriormente no fluxo podem ser referenciados em Iniciar Atributo nós subsequentes, permitindo cálculos em múltiplas etapas. Todos os atributos criados também estão disponíveis usando o recurso de preenchimento automático para garantir a nomenclatura correta.

Example of a complete flow with two Initiate attribute nodes consecutively

Como evito erros de digitação ao referenciar nomes de atributos em fórmulas?

Use o recurso de preenchimento automático no campo Fórmula para selecionar entre os atributos disponíveis. Para instruções detalhadas, veja Autofill attribute names.

Atualizado

Isto foi útil?