> 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 el Lenguaje de Expresiones de Navixy. Cambie el nombre de los 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 utilizando el [Lenguaje de expresiones de Navixy](https://navixy.com/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\&token=98a0e52b-69fd-4199-96dd-374a0e751abd)
{% endcolumn %}
{% endcolumns %}

**Iniciar atributo** El nodo se configura para cada flujo en la interfaz de usuario de la plataforma Navixy. Para conocer opciones específicas de sintaxis y una referencia detallada del lenguaje de expresiones, consulte [Lenguaje de expresiones de Navixy](https://navixy.com/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 con la arquitectura de flujos

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

* Procesar datos de telemetría sin procesar para convertirlos en métricas empresariales significativas
* Crear campos calculados basados en varios valores de parámetros
* Convertir unidades de medida (por ejemplo, de kilómetros a millas)
* Calcular diferencias entre las lecturas actuales y anteriores
* Generar análisis basados en el tiempo sobre el comportamiento del dispositivo

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

### Capacidades del nodo

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

* **Transformación de atributos de datos**: Cree atributos completamente nuevos aplicando operaciones matemáticas a los que provienen de fuentes de datos
* **Conversión de unidades**: Convierta unidades de medida (por ejemplo, la velocidad de *km/h* a *mph*, o la 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 tiempo
* **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](https://navixy.com/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 su posterior procesamiento 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

Añada un identificador distintivo para el atributo.

* Este nombre se mostrará en [Analizador de datos](https://navixy.com/docs/user/es/guide/account/iot-logic/data-stream-analyzer.md),
* También puede usar este nombre para crear sensores personalizados en el [Seguimiento](https://navixy.com/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 fórmula

Añada expresiones matemáticas para calcular valores de atributos.

* Usar `value('parameter_name' 0, 'valid')` formato para hacer referencia a parámetros existentes del dispositivo.\
  **Nota**. Haga clic en el ![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\&token=2de2cfe6-4d78-49fd-9179-f6fc96a7fd33) 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 obtener detalles sobre el autocompletado de nombres de atributos, consulte [Autocompletar nombres de atributos](https://navixy.com/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](https://navixy.com/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).
* Gestione los valores que puedan faltar. Si falta un valor que la fórmula necesita, la fórmula no produce ningún resultado y el atributo no tendrá valor para ese paquete. Consulte [Valores faltantes en expresiones](https://navixy.com/docs/user/es/guide/account/iot-logic/nodes/missing-values-in-expressions.md).
  {% endstep %}

{% step %}

#### (opcional) Añadir más atributos

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

{% step %}

#### Guarde 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 al dividir el parámetro de velocidad CAN entre 1,609.

Para obtener detalles sobre los cálculos para nuevos atributos, consulte [Ejemplos de cálculos](https://navixy.com/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 de flujo → pasos 3 y 4](https://navixy.com/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 del **Iniciar atributo** nodo se pueden supervisar igual que los atributos de datos reales provenientes de los dispositivos en **Analizador de datos (DSA)** y el **Seguimiento** .

Para obtener más información sobre las opciones de visualización, consulte [Mostrar nuevos atributos calculados en la plataforma Navixy](https://navixy.com/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. Conectar el nodo a al menos un **Fuente de datos** nodo como entrada
2. Conectar 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. Como resultado, recibirá:

* Todos los parámetros originales del dispositivo
* Todos los atributos calculados con sus valores
* Valores actualizados de tiempo de generación y tiempo del servidor según la configuración

Si usa el mismo nombre para un atributo calculado que para un parámetro existente, el atributo reemplaza el 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 del parámetro original permanece en el paquete, por lo que el paquete parece normal y el cálculo no se realizó sin notificación. Consulte [Valores faltantes en expresiones](https://navixy.com/docs/user/es/guide/account/iot-logic/nodes/missing-values-in-expressions.md).

## Preguntas frecuentes

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

Sí. Use el parámetro de índice en la función de valor 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 relacionados con el tiempo?

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

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

El atributo deja de calcularse para los datos recién recibidos, pero los datos históricos permanecen sin cambios. El atributo no aparece en ningún paquete de datos nuevo después de eliminarse.

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

Sí. Se puede hacer referencia a los atributos creados anteriormente en el flujo en los **Iniciar atributo** nodos posteriores, lo que permite realizar cálculos en varias etapas. Todos los atributos creados también están disponibles mediante la función de [autocompletado](https://navixy.com/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 hacer referencia a nombres de atributos en 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](https://navixy.com/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, generalmente porque faltaba en el paquete un valor que lee. El atributo no tiene valor y no se informa ningún error. Consulte [Valores faltantes en expresiones](https://navixy.com/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/es/guide/account/iot-logic/nodes/initiate-attribute-node.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
