> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node.md).
# Iniciar Atributo
Crie novos atributos de dados a partir da telemetria recebida usando a Navixy Expression Language. Renomeie parâmetros, aplique fórmulas e enriqueça os dados antes de encaminhá-los.
## Visão geral técnica e recursos
{% columns %}
{% column %}
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](/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md). O nó funciona como um componente essencial em um fluxo, permitindo enriquecer os dados antes de enviá-los aos seus sistemas de destino.
{% endcolumn %}
{% column %}
{% endcolumn %}
{% endcolumns %}
**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](/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md) 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
{% hint style="info" %}
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.
{% endhint %}
### 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](/docs/user/pt-br/guide/account/iot-logic/nodes/geofence-functions.md)
## Opções de configuração
{% columns %}
{% column valign="middle" %}
**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.
{% endcolumn %}
{% column %}
{% endcolumn %}
{% endcolumns %}
Veja quais elementos este nó utiliza e o que você pode configurar ao trabalhar com ele:
### Etapas de configuração
{% stepper %}
{% step %}
#### 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.
{% endstep %}
{% step %}
#### Definir o nome do atributo
Adicione um identificador exclusivo do atributo.
* Este nome será exibido no [Analisador de dados](/docs/user/pt-br/guide/account/iot-logic/data-stream-analyzer.md),
* Você também pode usar esse nome para criar sensores personalizados no módulo [Monitor](/docs/user/pt-br/guide/tracking.md) 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** .
{% endstep %}
{% step %}
#### 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](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names).
* Aplique operações matemáticas com base na [Linguagem de Expressões do Navixy IoT Logic](/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md) 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](/docs/user/pt-br/guide/account/iot-logic/nodes/missing-values-in-expressions.md).
{% endstep %}
{% step %}
#### (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ó.
{% endstep %}
{% step %}
#### Salvar a configuração do nó
Clique em **Aplicar alterações** para concluir a criação do nó.
{% endstep %}
{% endstepper %}
Veja um exemplo prático de configuração de atributos:
{% columns %}
{% column valign="middle" %}
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](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node/calculation-examples.md).
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](/docs/user/pt-br/guide/account/iot-logic/flow-management/flow-configuration-example.md#flow-configuration-steps).
{% endcolumn %}
{% column %}
{% endcolumn %}
{% endcolumns %}
## 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](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node/displaying-new-calculated-attributes-on-the-navixy-platform.md).
## 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](/docs/user/pt-br/guide/account/iot-logic/nodes/missing-values-in-expressions.md).
## 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](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names) 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](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names).
#### 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](/docs/user/pt-br/guide/account/iot-logic/nodes/missing-values-in-expressions.md).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://navixy.com/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
