> 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/es/guide/account/iot-logic/nodes/initiate-attribute-node.md).

# Iniciar atributo

Cree nuevos atributos de datos a partir de la telemetría entrante usando Navixy Expression Language. Renombre parámetros, aplique fórmulas y enriquezca los datos antes de reenviarlos.

## Visión general técnica y capacidades

{% columns %}
{% column %}
En IoT Logic, **Iniciar atributo** el nodo transforma las lecturas del dispositivo mediante la creación de nuevos atributos de datos basados en la telemetría entrante. Este nodo le permite manipular datos mediante fórmulas matemáticas, cambiar el nombre de parámetros existentes y realizar operaciones a nivel de bits usando el [Lenguaje de expresiones de Navixy](/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md). El nodo sirve como un componente clave en un flujo, lo que le permite enriquecer los datos antes de enviarlos a sus sistemas de destino.
{% endcolumn %}

{% column %}
![](https://1900701122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-7e96978455ec9e7da74b1a6f2224ad0d7fcf15e0%2Fiot-logic-initiate-attribute-tile.png?alt=media)
{% endcolumn %}
{% endcolumns %}

**Iniciar atributo** el nodo se configura para cada flujo en la interfaz de usuario de la plataforma Navixy. Para conocer opciones de sintaxis específicas y una referencia detallada del lenguaje de expresiones, consulte [Lenguaje de expresiones de Navixy](/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md) en la documentación del usuario.

<figure><img src="https://1900701122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-65ef89cf366fb6c4e53d07f6aa05c617d0e3d1e1%2Fiot-logic-initiate-attribute-in-flow.png?alt=media" alt="Initiate attribute node in the flow workspace showing the node connected to other nodes in the flow"><figcaption></figcaption></figure>

### Integración en la arquitectura del flujo

**Iniciar atributo** el nodo funciona dentro de la arquitectura del flujo al proporcionar capacidades de transformación de datos y permitir:

* Procesamiento de datos brutos de telemetría en métricas empresariales significativas
* Creación de campos calculados a partir de múltiples valores de parámetros
* Conversión de unidades de medida (por ejemplo, de kilómetros a millas)
* Cálculo de diferencias entre las lecturas actuales y las anteriores
* Generación de análisis basados en el tiempo sobre el comportamiento del dispositivo

{% hint style="info" %}
El nodo Iniciar atributo requiere al menos una **fuente de datos** nodo que se conecte a él. No se realizarán cálculos sin conexiones de datos de entrada.
{% endhint %}

### Capacidades del nodo

El **Iniciar atributo** nodo por sí mismo ofrece:

* **Transformación de atributos de datos**: Cree atributos completamente nuevos aplicando operaciones matemáticas a los que provienen de las fuentes de datos
* **Conversión de unidades**: Convierta unidades de medida (por ejemplo, velocidad de *km/h* a *mph*, o temperatura de *°C* a *°F*)
* **Cálculos basados en el tiempo**: Compare las lecturas actuales con los valores anteriores para determinar los cambios
* **Manipulación del tiempo**: Personalice las marcas de tiempo de cuándo se generó el atributo en un dispositivo y cuándo lo recibió el servidor para evitar inconsistencias en el tiempo y unificar los formatos de hora
* **Búsqueda de zona**: Escriba el nombre de la zona en la que se encuentra un dispositivo en un atributo con `geofenceName()`, una opción de pago. Consulte [Funciones de zona](/docs/user/es/guide/account/iot-logic/nodes/geofence-functions.md)

## Opciones de configuración

{% columns %}
{% column valign="middle" %}
**Iniciar atributo** el nodo le permite definir cómo se transforman los parámetros del dispositivo en atributos, que estarán disponibles para un procesamiento posterior en su flujo de datos.
{% endcolumn %}

{% column %}

<figure><img src="https://1900701122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-1d6dbc91c7863368a349129f700135f56c46e5cb%2FInitiate_Attribute_node_edit.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Veamos qué elementos utiliza este nodo y qué puede configurar al trabajar con él:

### Pasos de configuración

{% stepper %}
{% step %}

#### Especificar el nombre del nodo

Introduzca un nombre descriptivo para destacar el propósito del nodo. Use un nombre que le ayude a identificar los cálculos que se realizarán dentro de este nodo; se mostrará en el diagrama de flujo para facilitar su identificación.
{% endstep %}

{% step %}

#### Definir el nombre del atributo

Agregue un identificador distintivo del atributo.

* Este nombre se mostrará en [Analizador de datos](/docs/user/es/guide/account/iot-logic/data-stream-analyzer.md),
* También puede usar este nombre para crear sensores personalizados en el [Seguimiento](/docs/user/es/guide/tracking.md) módulo. Para hacerlo, el **Iniciar atributo** nodo que contiene este atributo debe estar conectado a un **Nodo de Salida** nodo configurado en modo **Nodo de salida predeterminado** .
  {% endstep %}

{% step %}

#### Definir la fórmula

Agregue expresiones matemáticas para calcular los valores de los atributos.

* Use `value('parameter_name' 0, 'valid')` como formato para referenciar parámetros existentes del dispositivo.\
  **Nota**. Haga clic ![image-20250605-115154.png](https://1900701122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3ae9e98cb2dff10c13a5b062c8b6c161b9b038df%2Fimage-20250605-115154.png?alt=media) dentro del **campo Fórmula** para abrir la lista de atributos disponibles y seleccionar el que necesite. Se agregará al campo automáticamente en un formato listo para usar. Para obtener detalles sobre el autocompletado de nombres de atributos, consulte [Autocompletar nombres de atributos](/docs/user/es/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names).
* Aplique operaciones matemáticas basadas en [Lenguaje de expresiones de Navixy IoT Logic](/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md) para transformar valores.
* Use distintos valores de índice de profundidad para acceder a valores históricos (el valor predeterminado es 0).
* Maneje los valores que puedan faltar. Si falta un valor que necesita la fórmula, la fórmula no produce nada y el atributo entonces no tiene valor para ese paquete. Consulte [Valores faltantes en las expresiones](/docs/user/es/guide/account/iot-logic/nodes/missing-values-in-expressions.md).
  {% endstep %}

{% step %}

#### (opcional) Agregar más atributos

Haga clic en **Agregar atributo** para abrir un nuevo cuadro de diálogo de configuración de atributos. Aquí puede crear un nuevo atributo de datos si necesita que se realicen varios cálculos dentro del mismo nodo.
{% endstep %}

{% step %}

#### Guardar la configuración del nodo

Haga clic en **Aplicar cambios** para completar la creación del nodo.
{% endstep %}
{% endstepper %}

Veamos un ejemplo práctico de configuración de atributos:

{% columns %}
{% column valign="middle" %}
Este ejemplo crea un atributo que convierte la velocidad de kilómetros a millas por hora dividiendo el parámetro de velocidad CAN entre 1.609.

Para obtener detalles sobre los cálculos de nuevos atributos, consulte [Ejemplos de cálculo](/docs/user/es/guide/account/iot-logic/nodes/initiate-attribute-node/calculation-examples.md).

Además, puede encontrar un ejemplo detallado del uso de atributos calculados en un flujo en [Ejemplo de configuración del flujo → pasos 3 y 4](/docs/user/es/guide/account/iot-logic/flow-management/flow-configuration-example.md#flow-configuration-steps).
{% endcolumn %}

{% column %}

<figure><img src="https://1900701122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-ff0ba6cd28d37a00e2036a38e7dddc67526114b8%2FIitiate_Attribute_example.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

## Opciones de visualización

Los nuevos atributos calculados dentro de **Iniciar atributo** el nodo pueden supervisarse igual que los atributos de datos reales que provienen de los dispositivos en **Analizador de datos (DSA)** y el **Seguimiento** módulo.

Para obtener más información sobre las opciones de visualización, consulte [Visualización de nuevos atributos calculados en la plataforma Navixy](/docs/user/es/guide/account/iot-logic/nodes/initiate-attribute-node/displaying-new-calculated-attributes-on-the-navixy-platform.md).

## Consideraciones sobre el flujo de datos

Después de configurar su **Iniciar atributo** nodo, asegúrese de:

1. Conecte el nodo a por lo menos una **fuente de datos** nodo como entrada
2. Conecte la salida a un **Nodo de Salida** nodo para enviar los datos transformados

Dentro del **Iniciar atributo** nodo, los valores de los parámetros se procesan según sus expresiones cada vez que el dispositivo proporciona datos. En la salida, recibirá:

* Todos los parámetros originales del dispositivo
* Todos los atributos calculados con sus valores
* Los valores actualizados de la hora de generación y la hora del servidor, según lo configurado

Si usa el mismo nombre para un atributo calculado que para un parámetro existente, el atributo reemplaza al parámetro original en el paquete de datos de salida.

Un atributo cuya fórmula no se pudo calcular no tiene valor para ese paquete. Nada lo marca como un error. Si el atributo usa el mismo nombre que un parámetro del dispositivo, el valor original del parámetro se mantiene en el paquete, por lo que el paquete parece normal y el cálculo simplemente no ocurrió. Consulte [Valores faltantes en las expresiones](/docs/user/es/guide/account/iot-logic/nodes/missing-values-in-expressions.md).

## Preguntas frecuentes

#### ¿Puedo referenciar valores que no sean los más recientes en mis cálculos?

Sí. Use el parámetro de índice en la función value para acceder a valores históricos. Por ejemplo, `value('temperature', 1, 'valid')` se refiere al valor válido anterior del parámetro de temperatura.

#### ¿Cómo realizo cálculos que involucren tiempo?

Use las `genTime()` y `srvTime()` funciones para trabajar con marcas de tiempo. Puede calcular diferencias de tiempo, agregar desfases temporales o dar formato a las marcas de tiempo para su visualización.

#### ¿Qué ocurre si elimino un atributo?

El atributo ya no se calcula para los datos recibidos recientemente, pero los datos históricos permanecen sin cambios. El atributo no aparece en ningún paquete de datos nuevo después de la eliminación.

#### ¿Puedo usar atributos creados en un nodo Iniciar atributo en otro?

Sí. Los atributos creados anteriormente en el flujo pueden referenciarse en nodos posteriores **Iniciar atributo** nodos, lo que permite realizar cálculos de varias etapas. Todos los atributos creados también están disponibles mediante la [función de autocompletado](/docs/user/es/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names) para garantizar una nomenclatura correcta.

<figure><img src="https://1900701122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-283b0e91f8050910026eb2295c18845b6d485b20%2Fiot-logic-initiate-attribute-chained.png?alt=media" alt="Example of a complete flow with two Initiate attribute nodes consecutively"><figcaption></figcaption></figure>

#### ¿Cómo evito errores tipográficos al referenciar nombres de atributos en las fórmulas?

Use la función de autocompletado en el campo Fórmula para seleccionar entre los atributos disponibles. Para obtener instrucciones detalladas, consulte [Autocompletar nombres de atributos](/docs/user/es/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names).

#### ¿Por qué a veces falta uno de mis atributos calculados?

La fórmula no se pudo calcular para esos paquetes, por lo general porque faltaba en el paquete un valor que lee. El atributo entonces no tiene valor y no se informa ningún error. Consulte [Valores faltantes en las expresiones](/docs/user/es/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/es/guide/account/iot-logic/nodes/initiate-attribute-node.md?ask=<question>&goal=<endgoal>
```

`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.
