# Nodo Iniciar Atributo

## Descripción técnica y capacidades

{% columns %}
{% column %}
En IoT Logic, **Iniciar Atributo** el nodo transforma las lecturas del dispositivo creando nuevos atributos de datos basados en la telemetría entrante. Este nodo le permite manipular datos mediante fórmulas matemáticas, renombrar parámetros existentes y realizar operaciones a nivel de bits usando el [Navixy Expression Language](https://app.gitbook.com/s/tx3J5BxnWyPV0nP2xr0z/technologies/navixy-iot-logic-expression-language). El nodo actúa como un componente clave en un flujo, permitiéndole enriquecer los datos antes de enviarlos a sus sistemas de destino.
{% endcolumn %}

{% column %}
![](https://3876955220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-27f841121a339221e8e1d543e6ccde8db193c395%2Fimage-20250404-083140.png?alt=media)
{% endcolumn %}
{% endcolumns %}

**Iniciar Atributo** el nodo se configura para cada flujo en la interfaz de la plataforma Navixy. Para opciones de sintaxis específicas y la referencia detallada del lenguaje de expresiones, consulte [Navixy Expression Language](https://app.gitbook.com/s/tx3J5BxnWyPV0nP2xr0z/technologies/navixy-iot-logic-expression-language) en la documentación del usuario.

<figure><img src="https://3876955220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-00bdf7c0a1b63de41d4ed076b0a5cdefcb943ccd%2FInitiate-attribute-in-flow.webp?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 de flujos

**Iniciar Atributo** el nodo funciona dentro de la arquitectura de flujo proporcionando capacidades de transformación de datos y permitiendo:

* Procesar datos de telemetría cruda en métricas comerciales significativas
* Crear campos calculados basados en múltiples valores de parámetros
* Convertir unidades de medida (p. ej., kilómetros a millas)
* Calcular diferencias entre lecturas actuales y anteriores
* Generar análisis temporales sobre el comportamiento del dispositivo

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

### Capacidades del nodo

El **Iniciar Atributo** nodo por sí solo 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 (p. ej., velocidad de *km/h* a *mph*, o temperatura de *°C* a *°F*)
* **Cálculos basados en el tiempo**: Compare lecturas actuales con valores anteriores para determinar cambios
* **Manipulación de tiempo**: Personalice las marcas de tiempo para cuándo se generó el atributo en un dispositivo y cuándo fue recibido por el servidor para evitar inconsistencias en la línea temporal y unificar los formatos de tiempo

## Opciones de configuración

**Iniciar Atributo** el nodo le permite definir cómo los parámetros del dispositivo se transforman en atributos, que estarán disponibles para su procesamiento posterior en su flujo de datos.

<figure><img src="https://3876955220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-2fd9360360cfe5c656aad630f4bcf1f57937f1ea%2Fimage-20250606-091235.png?alt=media" alt="Initiate attribute node configuration panel showing the list of attributes and the Add New Attribute button"><figcaption></figcaption></figure>

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

### Pasos de configuración

{% stepper %}
{% step %}
Especifique **Nombre del nodo**

Ingrese un nombre descriptivo para resaltar 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 la identificación.
{% endstep %}

{% step %}
Active **Especificar atributos de tiempo**

si necesita manipular las marcas de tiempo de los eventos, habilita dos opciones más:

* **Hora de generación**: Cuando se creó el dato (por defecto `now()`)
* **Hora del servidor**: Cuando el dato fue recibido por IoT Logic (por defecto `now()`)
  {% endstep %}

{% step %}
Definir **Nombre del atributo**

Agregue un identificador distintivo del atributo.

* Este nombre se mostrará en [Data Stream Analyzer](https://www.navixy.com/docs/user/es/guide/account/iot-logic/data-stream-analyzer),
* También puede usar este nombre para crear sensores personalizados en el módulo de [Seguimiento](https://www.navixy.com/docs/user/es/guide/tracking) Para hacerlo, el **Iniciar Atributo** nodo que contiene este atributo debe estar conectado al **Punto de salida predeterminado** nodo.
  {% endstep %}

{% step %}
Definir **Fórmula**

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

* Use `value('parameter_name' 0, 'valid')` formato para referenciar parámetros de dispositivo existentes.\
  **Nota**. Haga clic ![image-20250605-115154.png](https://3876955220-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 **Fórmula** campo para abrir la lista de atributos disponibles y seleccionar el necesario. Se añadirá al campo automáticamente en el formato listo para usar. Para detalles sobre el autocompletado de nombres de atributos, consulte [Autocompletar nombres de atributos](https://www.navixy.com/docs/user/es/guide/account/iot-logic/flow-management/managing-attributes#autofill-attribute-names).
* Aplique operaciones matemáticas basadas en [Navixy IoT Logic Expression Language](https://app.gitbook.com/s/tx3J5BxnWyPV0nP2xr0z/technologies/navixy-iot-logic-expression-language) para transformar valores.
* Use diferentes valores de índice de profundidad para acceder a valores históricos (el valor predeterminado es 0).
  {% endstep %}

{% step %}
(opcional) Haga clic en **Agregar atributo**

Abra un nuevo diálogo de configuración de atributo. Aquí puede crear un nuevo atributo de datos si necesita que se realicen múltiples cálculos dentro del mismo nodo.
{% endstep %}
{% endstepper %}

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

<figure><img src="https://3876955220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-15ef02a75483a563545b4d4ba662faaffd9abd67%2Fimage-20250606-090926.png?alt=media" alt="Iniatiate attribute node configuration window with node name Speed conversions, Attribute name KMPH to MPH and formula"><figcaption></figcaption></figure>

En este ejemplo, creamos un atributo que convierte la velocidad de kilómetros a millas por hora dividiendo el parámetro de velocidad CAN por 1.609.

Para detalles sobre cálculos para nuevos atributos, consulte [Ejemplos de cálculos](https://www.navixy.com/docs/user/es/guide/account/iot-logic/flow-management/initiate-attribute-node/calculation-examples).

Además, puede encontrar un ejemplo detallado de uso de atributos calculados en un flujo en [Ejemplo de configuración de flujo → pasos 3 y 4](https://www.navixy.com/docs/user/es/guide/account/iot-logic/flow-configuration-example#flow-configuration-steps).

## Opciones de visualización

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

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

## Consideraciones sobre el flujo de datos

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

1. Conectar el nodo a al menos un **Fuente de datos** nodo como entrada
2. Conectar la salida a un **Punto de salida** nodo para enviar los datos transformados

Dentro del **Iniciar Atributo** nodo, los valores de los parámetros se procesan de acuerdo con 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
* Valores actualizados de hora de generación y hora del servidor según la configuración

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

## 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 funciones `genTime()` y `srvTime()` para trabajar con marcas de tiempo. Puede calcular diferencias de tiempo, añadir compensaciones de tiempo o formatear marcas de tiempo para su visualización.

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

El atributo ya no se calculará para los datos recién recibidos, pero los datos históricos permanecen sin cambios. El atributo no aparecerá 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 ser referenciados en **Iniciar Atributo** nodos posteriores, permitiendo cálculos en varias etapas. Todos los atributos creados también están disponibles usando la [función de autocompletar](https://www.navixy.com/docs/user/es/guide/account/iot-logic/flow-management/broken-reference) para garantizar una nomenclatura correcta.

<figure><img src="https://3876955220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3387096d8cdd678b4e422a31889e3fba96ebed62%2Fimage-20250404-084039.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 autocompletar en el campo Fórmula para seleccionar entre los atributos disponibles. Para instrucciones detalladas, consulte [Autocompletar nombres de atributos](https://www.navixy.com/docs/user/es/guide/account/iot-logic/flow-management/managing-attributes#autofill-attribute-names).
