> 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
## Visão geral técnica e recursos
{% columns %}
{% column %}
No IoT Logic, **Iniciar Atributo** o nó transforma as 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](/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md). O nó serve como um componente fundamental em um fluxo, permitindo enriquecer os dados antes de enviá-los aos seus sistemas de destino.
{% endcolumn %}
{% column %}
{% endcolumn %}
{% endcolumns %}
**Iniciar Atributo** o 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 [Navixy Expression Language](/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** o nó funciona dentro da arquitetura do fluxo, fornecendo recursos 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 vários 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 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 entrada de dados.
{% endhint %}
### Recursos do nó
O **Iniciar Atributo** O nó, por si só, oferece:
* **Transformação de atributos de dados**: Crie atributos totalmente 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 as leituras atuais com os valores anteriores para determinar alterações
* **Manipulação de tempo**: Personalize os carimbos de data e hora de quando o atributo foi gerado em um dispositivo e de quando foi recebido pelo servidor para evitar inconsistências de tempo e unificar os formatos de hora
## Opções de configuração
{% columns %}
{% column valign="middle" %}
**Iniciar Atributo** o nó permite definir como os parâmetros do dispositivo são transformados em atributos, que ficarão disponíveis para processamento adicional em seu fluxo de dados.
{% endcolumn %}
{% column %}
{% endcolumn %}
{% endcolumns %}
Vamos ver quais elementos este nó usa e o que você pode configurar ao trabalhar com ele:
### Etapas de configuração
{% stepper %}
{% step %}
#### Especifique o nome do nó
Insira um nome descritivo para destacar a finalidade do nó. Use um nome que ajude você a identificar os cálculos que serão realizados dentro deste nó; ele será exibido no diagrama do fluxo para facilitar a identificação.
{% endstep %}
{% step %}
#### Definir nome do atributo
Adicione um identificador distinto do atributo.
* Este nome será exibido em [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 [Monitor](/docs/user/pt-br/guide/tracking.md) módulo. Para isso, o **Iniciar Atributo** nó que contém este atributo deve ser conectado a um **Ponto de Extremidade de Saída** nó configurado no modo **Ponto de extremidade padrão** responsável.
{% endstep %}
{% step %}
#### Definir fórmula
Adicione expressões matemáticas para calcular os valores dos atributos.
* Use `value('parameter_name' 0, 'valid')` para referenciar parâmetros existentes do dispositivo.\
**Observação**. Clique  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 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 em [Linguagem de Expressão 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).
{% endstep %}
{% step %}
#### (opcional) Adicione 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 que vários cálculos sejam realizados no mesmo nó.
{% endstep %}
{% step %}
#### Salve a configuração do nó
Clique em **Aplicar alterações** para concluir a criação do nó.
{% endstep %}
{% endstepper %}
Vamos ver 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 para milhas por hora dividindo o parâmetro de velocidade do CAN por 1,609.
Para 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 do 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 dentro do **Iniciar Atributo** nó podem ser monitorados assim como os atributos de dados reais provenientes dos dispositivos no **Analisador de dados (DSA)** e o gráfico de rosca **Monitor** módulo.
Para mais informações sobre as opções de exibição, consulte [Exibindo 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
Depois de configurar seu **Iniciar Atributo** nó, certifique-se de:
1. Conecte o nó a pelo menos um **Fonte de Dados** nó como entrada
2. Conecte 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 tempo de geração e tempo do servidor, conforme configurado
Se você usar o mesmo nome para um atributo calculado e para um parâmetro existente, o atributo substitui o parâmetro original no pacote de dados de saída.
## Perguntas frequentes
#### Posso referenciar valores que não sejam 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')` se refere ao valor válido anterior do parâmetro de temperatura.
#### Como faço cálculos envolvendo tempo?
Use o cabeçalho `genTime()` e `srvTime()` funções para trabalhar com carimbos de data e hora. Você pode calcular diferenças de tempo, adicionar deslocamentos de tempo ou formatar carimbos de data e hora para exibição.
#### O que acontece se eu excluir um atributo?
O atributo não é mais 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 nós subsequentes **Iniciar Atributo** nós, permitindo cálculos em várias etapas. 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 faço para evitar erros de digitação ao referenciar nomes de atributos nas fórmulas?
Use o recurso de preenchimento automático no campo Fórmula para selecionar entre os atributos disponíveis. Para 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).
---
# 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.