Iniciar Atributo

Crie novos atributos de dados a partir da telemetria recebida usando a Linguagem de Expressão da Navixy. Renomeie parâmetros, aplique fórmulas e enriqueça os dados antes do encaminhamento.

Visão geral técnica e recursos

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

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

Integração com a arquitetura do fluxo

Iniciar Atributo nó funciona na arquitetura do fluxo fornecendo recursos de transformação de dados e permitindo:

• Processar dados brutos de telemetria em métricas de negócios relevantes

• Criar campos calculados com base em vários valores de parâmetros

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

• Calcular diferenças entre leituras atuais e anteriores

• Gerar análises baseadas em tempo sobre o comportamento do dispositivo

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

Recursos do nó

O Iniciar Atributo nó, por si só, oferece:

• Transformação de atributos de dados: Crie atributos completamente novos aplicando operações matemáticas aos atributos provenientes de fontes de dados

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

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

• Manipulação de tempo: Personalize os registros de data e hora de quando o atributo foi gerado em um dispositivo e de quando foi recebido pelo servidor para evitar inconsistências na linha do tempo e unificar formatos de hora

• Consulta de geocerca: Grave o nome da geocerca em que um dispositivo está em um atributo com geofenceName(), uma opção paga. Consulte Funções de geocerca

Opções de configuração

Iniciar Atributo 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.

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

Etapas de configuração

1

Especificar o nome do nó

Insira um nome descritivo para destacar a finalidade do nó. Use um nome que ajude a identificar os cálculos que serão feitos nesse nó; ele será exibido no diagrama de fluxo para facilitar a identificação.

2

Definir o nome do atributo

Adicione um identificador exclusivo do atributo.

• Este nome será exibido no Analisador de dados,

• Você também pode usar esse nome para criar sensores personalizados no módulo Monitor módulo. Para isso, o Iniciar Atributo nó que contém esse atributo deve estar conectado a um Ponto de Extremidade de Saída nó definido para o modo Ponto de extremidade padrão .

3

Definir fórmula

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

• Use o formato value('parameter_name' 0, 'valid') para fazer referência a parâmetros existentes do dispositivo. Observação. Clique dentro do campo Fórmula 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 obter detalhes sobre o preenchimento automático de nomes de atributos, consulte Preenchimento automático de nomes de atributos.

• Aplique operações matemáticas com base na Linguagem de Expressões do Navixy IoT Logic para transformar valores.

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

• Trate valores que possam estar ausentes. Se um valor necessário para a fórmula estiver ausente, a fórmula não produzirá nada e o atributo não terá valor para esse pacote. Consulte Valores ausentes em expressões.

4

(opcional) Adicionar mais atributos

Clique em Adicionar atributo para abrir uma nova caixa de diálogo de configuração de atributo. Aqui você pode criar um novo atributo de dados se precisar realizar vários cálculos no mesmo nó.

5

Salvar a configuração do nó

Clique em Aplicar alterações para concluir a criação do nó.

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

Este exemplo cria um atributo que converte a velocidade de quilômetros por hora em milhas por hora, dividindo o parâmetro de velocidade CAN por 1,609.

Para obter detalhes sobre cálculos para novos atributos, consulte Exemplos de cálculo.

Além disso, você pode encontrar um exemplo detalhado de uso de atributos calculados em um fluxo em Exemplo de configuração de fluxo → etapas 3 e 4.

Opções de exibição

Novos atributos calculados no Iniciar Atributo nó podem ser monitorados da mesma forma que os atributos de dados reais provenientes de dispositivos no Analisador de dados (DSA) e no módulo Monitor .

Para mais informações sobre as opções de exibição, consulte Exibição de 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 uma Fonte de Dados Fonte de Dados como entrada

2. Conectar a saída a um Ponto de Extremidade de Saída 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 sempre 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 e para um parâmetro existente, o atributo substituirá o parâmetro original no pacote de dados de saída.

Um atributo cuja fórmula não pôde ser calculada não tem valor para esse pacote. Nada o identifica como um erro. Se o atributo usar o mesmo nome de um parâmetro do dispositivo, o valor do parâmetro original permanecerá no pacote, de modo que o pacote parecerá normal e o cálculo simplesmente não ocorrerá. Consulte Valores ausentes em expressões.

Perguntas frequentes

Posso fazer referência a valores que não são os 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 de temperatura.

Como realizo cálculos que envolvem tempo?

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

O que acontece se eu excluir um atributo?

O atributo deixa de ser calculado para dados recém-recebidos, mas os dados históricos permanecem inalterados. O atributo não aparece 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 vários estágios. Todos os atributos criados também estão disponíveis usando o recurso de preenchimento automático para garantir a nomenclatura correta.

Como evito erros de digitação ao fazer referência a 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 obter instruções detalhadas, consulte Preenchimento automático de nomes de atributos.

Por que um dos meus atributos calculados às vezes está ausente?

A fórmula não pôde ser calculada para esses pacotes, geralmente porque um valor lido por ela estava ausente do pacote. O atributo então não tem valor, e nenhum erro é informado. Consulte Valores ausentes em expressões.