Gerenciar atributos

Crie, edite e exclua atributos no nó Iniciar Atributo. Use o preenchimento automático para montar expressões de fórmula rapidamente a partir dos campos de telemetria disponíveis.

O Iniciar Atributo O nó permite que você crie, edite e gerencie atributos de dados em todo o seu fluxo do IoT Logic. Este guia aborda as ações básicas de gerenciamento de atributos (criar, editar, excluir) e as operações essenciais, incluindo a funcionalidade de preenchimento automático para criação de fórmulas.

Criar atributos

Veja como criar um novo atributo no nó Iniciar Atributo:

1

Adicionar novo atributo

Enviar Adicionar atributo botão

2

Nomear o atributo

Digite um nome para o seu atributo (por exemplo, "Speed mph"). Esse nome será exibido em Analisador de dados e atuará como um nome personalizado de sensor na Navixy.

3

Definir fórmula

Defina a expressão de valor. Para criar fórmulas mais rapidamente, use preenchimento automático.

A sintaxe curta é o padrão para nomes de atributos preenchidos automaticamente em fórmulas, e você também pode usá-la na entrada manual de fórmulas. Ao referenciar apenas o valor válido mais recente de um atributo, você pode omitir a sintaxe completa value() da função e as aspas. Por exemplo, a fórmula de conversão de temperatura pode ser escrita como temperature*1.8 + 32 em vez de value('temperature', 0, 'valid').

4

Finalizar a configuração

Salvar para salvar o comando. Clique em para confirmar a configuração do nó

O novo atributo é salvo no nó e o cálculo configurado é aplicado imediatamente no fluxo.

Configurações de tempo para atributos

As configurações de tempo permitem controlar os carimbos de data e hora associados aos seus atributos:

• Tempo de geração: Quando os dados foram criados

  • Use now() para definir a hora atual em milissegundos

  • Use genTime('parameter_name', 0, 'valid') para usar o próprio tempo de geração do parâmetro

• Tempo do servidor: Quando os dados foram recebidos pelo IoT Logic

  • Use now() para definir a hora atual em milissegundos

  • Use srvTime('parameter_name', 0, 'valid') para usar o tempo de servidor do parâmetro

  • Adicione deslocamentos para ajustar os fusos horários (por exemplo, srvTime('can_speed', 0, 'valid') + 120000 adiciona 2 minutos)

As configurações de tempo são importantes para a análise e a sincronização de dados. A configuração correta de tempo garante que seus dados mantenham a integridade cronológica em todo o fluxo.

Preenchimento automático de nomes de atributos

Ao criar fórmulas de cálculo, você precisa referenciar nomes de atributos existentes de dispositivos físicos ou atributos calculados de outros nós. Para simplificar esse processo e evitar erros de digitação, o IoT Logic fornece a funcionalidade de preenchimento automático para nomes de atributos.

Para usar o preenchimento automático ao criar fórmulas:

1. Salvar em Fórmula campo.

2. Selecione o atributo desejado na lista exibida; ela também aceita entrada manual de texto para fins de pesquisa.

3. Clique no nome do atributo para inseri-lo na sua fórmula.

O atributo selecionado é inserido automaticamente no formato pronto para uso, usando a sintaxe curta da linguagem de expressões do IoT Logic da Navixy. Isso significa que as entradas preenchidas automaticamente acessam o valor mais recente de qualquer atributo selecionado.

Você pode modificar os parâmetros conforme necessário - altere o número do índice para valores históricos ou ajuste o sinalizador de validade. Para fazer isso, você precisa definir a fórmula usando a sintaxe completa explicitamente, dentro da value() função.

A lista é filtrada com base nas fontes de dados do seu fluxo e corresponde ao que está visível em Analisador de dados.

A lista de preenchimento automático exibe apenas atributos que atendem todos os critérios a seguir simultaneamente:

• Compatível com dispositivos - O atributo deve ter suporte de pelo menos um dispositivo atualmente adicionado ao seu fluxo

• Efetivamente transmitido - O dispositivo deve ter enviado dados reais para esse atributo (não apenas oferecer suporte a ele em teoria)

• Disponível no fluxo - Isso inclui tanto parâmetros do dispositivo quanto atributos calculados de outros Iniciar Atributo nós dentro do mesmo fluxo

Exemplo: Se o seu dispositivo oferece suporte tanto a sensores de velocidade quanto de temperatura, mas só transmitiu dados de velocidade (talvez devido a um sensor de temperatura com defeito), a lista de preenchimento automático mostrará o atributo 'speed', mas não 'temperature'. O atributo de temperatura só aparecerá quando o dispositivo realmente enviar leituras de temperatura, mesmo que tecnicamente ele ofereça suporte a isso.

Atributos indexados no preenchimento automático

Alguns atributos de dados contêm vários valores indexados em um único atributo, como leituras de vários sensores analógicos conectados a um dispositivo telemático principal. Para usar esses atributos nos cálculos, você precisa especificar o número exato do índice correspondente ao sensor ou à entrada específica que deseja referenciar.

Por exemplo, se você precisar trabalhar com leituras de tensão da terceira entrada analógica do seu dispositivo, esses dados chegam por meio do atributo analog_2 (usando indexação baseada em zero, em que a primeira entrada é o índice 0). Na sua fórmula, isso apareceria como value('analog_2', 0, 'valid').

O preenchimento automático também lida com esse cenário para você:

• Os atributos indexados são marcados com o ícone na lista de preenchimento automático.

• Essas entradas exibem o intervalo de índices disponível entre colchetes, como analog_[1..4] para atributos que suportam cinco valores indexados (índices 1 a 4).

• Quando você seleciona um atributo indexado, o cursor é posicionado automaticamente no final do nome do atributo dentro das aspas, permitindo que você digite imediatamente o número específico do índice de que precisa.

Linguagem de expressões

Todas as fórmulas no IoT Logic seguem as especificações de Linguagem de Expressão do Navixy IoT Logic. Abaixo, você encontra uma breve referência às duas opções de sintaxe da linguagem. A escolha da sintaxe depende do caso específico e foi pensada para oferecer praticidade:

• A sintaxe curta é fácil de escrever e funciona melhor quando você precisa apenas dos dados mais recentes.

• A sintaxe longa é um pouco mais complexa, mas oferece mais controle sobre a profundidade dos dados quando você precisa lidar com valores históricos.

A opção de sintaxe não afeta a fórmula em si! Você também pode combinar sintaxe curta e longa na mesma fórmula.

As fórmulas também podem chamar as funções de geocerca, que leem a posição do dispositivo em relação às geocercas da sua conta. geofenceName() retorna o nome da geocerca em que o dispositivo está, como texto, de modo que se encaixa diretamente em um valor de atributo. Veja Funções de geocerca.

Ambas as opções de sintaxe podem ler um valor que não existe. Uma fórmula que então calcula com esse valor não produz nada, e o atributo é omitido do pacote de dados. Veja Valores ausentes em expressões.

Sintaxe curta

A opção de fórmula curta acessa o valor mais recente do atributo, sem verificar a validade. Use-a quando você não precisar de valores históricos em uma fórmula. O valor lido pode estar vazio, e a maioria dos operadores não consegue calcular com um valor vazio.

A funcionalidade de preenchimento automático sempre usa a sintaxe curta. funcionalidade de preenchimento automático sempre usa a sintaxe curta.

Sintaxe: attribute_name

Padrões:

• Índice: 0 (valor atual)

• Validação: 'todos' (inclui valores nulos)

Por exemplo, a forma curta temperature equivale à fórmula completa value('temperature', 0, 'all'). Isso significa que você pode criar cálculos facilmente sem adicionar explicitamente os parâmetros padrão:

temperature * 1.8 + 32

Sintaxe completa

Usar a sintaxe completa da fórmula permite acessar valores históricos ou um modo de validação explícito. Isso ajuda quando você precisa usar valores que não são os mais recentes e lidar com nulos. No caso da sintaxe completa, você precisa definir a value() função.

Função: value(attribute_name, index, validation)

Parâmetros:

Parâmetro	Intervalo/Valores	Descrição
attribute_name	Qualquer atributo válido	Nome exato da telemetria do dispositivo (pode ser preenchido automaticamente)
índice	0-11	Posição histórica: 0=atual, 1=anterior, 11=valor armazenado mais antigo
validação	'todos' https://api.eu.navixy.com/v2/... 'válido'	'todos'=inclui nulos (índice exato), 'válido'=exclui nulos (N-ésima leitura válida)

A Navixy armazena 12 leituras por atributo para cada dispositivo e as mantém por até 30 dias após a mensagem mais recente desse dispositivo. Um dispositivo que retorna após mais de 30 dias de silêncio começa sem histórico. Na primeira mensagem após o retorno, value('temperature', 1, 'valid') isso resulta em null. Para verificar qual histórico um dispositivo tem atualmente, abra Analisador de dados.

Exemplos:

• Qualquer leitura anterior

value('temperature', 1, 'all')

• 5ª leitura válida anterior

value('speed', 5, 'valid')

• Variação de temperatura (sintaxes curta e completa usadas na mesma fórmula)

temperature - value('temperature', 1, 'all')

Para mais exemplos de fórmulas, veja Exemplos de cálculo.

Editar atributos existentes

Para modificar um atributo existente:

1. Abra a janela de configuração do nó passando o mouse sobre o nó para exibir as ações rápidas, ou clicando duas vezes no nó

2. Localize o atributo que você deseja editar na lista de atributos

3. Faça as alterações necessárias nos campos de texto das propriedades do atributo: Nome do atributo, Fórmula ou configurações de tempo

4. Se precisar editar outros atributos neste nó, repita o passo 3 para eles

5. Salvar para salvar o comando. Clique em para aplicar suas alterações à configuração do nó

Ao editar um atributo, as alterações só serão aplicadas aos novos dados recebidos após o salvamento. Os dados históricos já coletados não serão recalculados.

Excluir atributos

Para remover um atributo que não é mais necessário:

1. Abra a janela de configuração do nó passando o mouse sobre o nó para exibir as ações rápidas, ou clicando duas vezes no nó

2. Localize o atributo que você deseja remover e clique em

3. Salvar Aplicar alterações para confirmar a configuração do nó

Ao excluir um atributo, ele não será mais calculado para novos dados, mas os dados históricos que contêm esse atributo permanecerão inalterados no banco de dados.