> 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/managing-attributes.md).

# Administrar atributos

Cree, edite y elimine atributos en el nodo Iniciar atributo. Use el autocompletado para construir rápidamente expresiones de fórmula a partir de los campos de telemetría disponibles.

El **Iniciar atributo** El nodo le permite crear, editar y gestionar atributos de datos a lo largo de su flujo de IoT Logic. Esta guía cubre las acciones básicas de gestión de atributos (crear, editar, eliminar) y las operaciones esenciales, incluida la funcionalidad de autorrelleno para la creación de fórmulas.

## Crear atributos

Así puede crear un nuevo atributo en el nodo Iniciar atributo:

{% stepper %}
{% step %}

### Agregar nuevo atributo

Haga clic en el **Agregar atributo** botón
{% endstep %}

{% step %}

### Nombrar el atributo

Introduzca un nombre para su atributo (por ejemplo, "Speed mph"). Este nombre se mostrará en [Analizador de datos](https://navixy.com/docs/user/es/guide/account/iot-logic/data-stream-analyzer.md) y actuará como un [nombre personalizado del sensor en Navixy](https://navixy.com/docs/user/es/guide/account/iot-logic/nodes/initiate-attribute-node/displaying-new-calculated-attributes-on-the-navixy-platform.md).
{% endstep %}

{% step %}

### Definir fórmula

Defina la expresión del valor. Para crear fórmulas más rápido, use [autorrelleno](#autofill-attribute-names).

{% hint style="info" %}
La sintaxis corta es la predeterminada para los nombres de atributos autorrellenados en las fórmulas, y también puede usarla para introducir fórmulas manualmente. Cuando solo haga referencia al valor válido más reciente de un atributo, puede omitir la sintaxis completa de la función y las comillas. Por ejemplo, la fórmula de conversión de temperatura puede escribirse como `value()` sintaxis de la función `temperature*1.8 + 32` en lugar de `value('temperature', 0, 'valid')*1.8 + 32`.
{% endhint %}
{% endstep %}

{% step %}

### Finalizar configuración

Haga clic en **Guardar** para confirmar la configuración del nodo
{% endstep %}
{% endstepper %}

El nuevo atributo se guarda en el nodo y el cálculo configurado se aplica de inmediato en el flujo.

### Configuración de tiempo para atributos

La configuración de tiempo le permite controlar las marcas de tiempo asociadas con sus atributos:

* **Tiempo de generación**: Cuándo se creó el dato
  * Usar `now()` para establecer la hora actual en milisegundos
  * Usar `genTime('parameter_name', 0, 'valid')` para usar el tiempo de generación propio del parámetro
* **Tiempo del servidor**: Cuando IoT Logic recibió los datos
  * Usar `now()` para establecer la hora actual en milisegundos
  * Usar `srvTime('parameter_name', 0, 'valid')` para usar el tiempo del servidor del parámetro
  * Agregue desplazamientos para ajustar las zonas horarias (por ejemplo, `srvTime('can_speed', 0, 'valid') + 120000` agrega 2 minutos)

{% hint style="info" %}
La configuración de tiempo es importante para el análisis y la sincronización de los datos. Una configuración de tiempo correcta garantiza que sus datos mantengan la integridad cronológica a lo largo del flujo.
{% endhint %}

### Autocompletar nombres de atributos

Cuando crea fórmulas de cálculo, necesita hacer referencia a nombres de atributos existentes de dispositivos físicos o a atributos calculados de otros nodos. Para simplificar este proceso y evitar errores de escritura, IoT Logic proporciona la funcionalidad de autorrelleno para los nombres de atributos.

Para usar el autorrelleno al crear fórmulas:

1. Haga clic en ![image-20250605-130755.png](https://1900701122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-246f310d842a27356a230db8e06eb7dfa5d87a8a%2Fimage-20250605-130755.png?alt=media\&token=078e31dc-ae4d-4c00-9619-3bce091f728d) en la **Fórmula** campo.
2. Seleccione el atributo deseado de la lista que aparece; admite la entrada manual de texto para buscar.
3. Haga clic en el nombre del atributo para insertarlo en su fórmula.

El atributo seleccionado se inserta automáticamente en un formato listo para usar, usando la [sintaxis corta](#short-syntax) del Lenguaje de expresiones de Navixy IoT Logic. Esto significa que las entradas autorrellenadas acceden al valor más reciente del atributo seleccionado.

Puede modificar los parámetros según sea necesario: cambie el número de índice para los valores históricos o ajuste la marca de validez. Para hacerlo, necesita definir la fórmula usando la [sintaxis completa](#full-syntax) explícitamente, dentro de la `value()` función.

La lista se filtra según las fuentes de datos de su flujo y coincide con lo que es visible en [Analizador de datos](https://navixy.com/docs/user/es/guide/account/iot-logic/data-stream-analyzer.md).

{% hint style="info" %}
La lista de autorrelleno muestra solo los atributos que cumplen **todos** los siguientes criterios simultáneamente:

* **Compatible con dispositivos** - El atributo debe ser compatible con al menos un dispositivo actualmente agregado a su flujo
* **Transmitido realmente** - El dispositivo debe haber enviado datos reales para este atributo (no solo admitirlo teóricamente)
* **Disponible en el flujo** - Esto incluye tanto los parámetros del dispositivo como los atributos calculados de otros **Iniciar atributo** nodos dentro del mismo flujo

**Ejemplo**: Si su dispositivo es compatible con sensores de velocidad y temperatura, pero solo ha transmitido datos de velocidad (quizás debido a un sensor de temperatura defectuoso), la lista de autorrelleno mostrará el atributo 'speed' pero no 'temperature'. El atributo de temperatura solo aparecerá una vez que el dispositivo realmente envíe lecturas de temperatura, aunque técnicamente lo admita.
{% endhint %}

#### Atributos indexados en el autorrelleno

Algunos atributos de datos contienen varios valores indexados dentro de un solo atributo, como lecturas de varios sensores analógicos conectados a un dispositivo telemático principal. Para usar estos atributos en los cálculos, necesita especificar el número de índice exacto que corresponde al sensor o la entrada específicos que desea referenciar.

Por ejemplo, si necesita trabajar con lecturas de voltaje del tercer sensor analógico de su dispositivo, estos datos llegan a través del atributo `analog_2` (usando indexación basada en cero, donde la primera entrada es el índice 0). En su fórmula, esto aparecería como `value('analog_2', 0, 'valid')`.

El autorrelleno también maneja este escenario por usted:

* Los atributos indexados se marcan con ![image-20250606-123725.png](https://1900701122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-65afe9be52f6e729d0e1cc25714ef6f5dbd39294%2Fimage-20250606-123725.png?alt=media\&token=3cb340b7-1825-47d6-bdf3-6c767023721e) un ícono en la lista de autorrelleno.
* Estas entradas muestran el rango de índices disponible entre corchetes, como `analog_[1..4]` para atributos que admiten cinco valores indexados (índices del 1 al 4).
* Cuando selecciona un atributo indexado, el cursor se posiciona automáticamente al final del nombre del atributo dentro de las comillas, lo que le permite escribir de inmediato el número de índice específico que necesita.

## Lenguaje de expresiones

Todas las fórmulas en IoT Logic siguen las especificaciones de [Lenguaje de expresiones de Navixy IoT Logic](https://navixy.com/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md). A continuación, encuentra una breve referencia de las dos opciones de sintaxis del lenguaje. La elección de la sintaxis depende del caso particular y está diseñada para facilitar su uso:

* La sintaxis corta es fácil de escribir y funciona mejor cuando solo necesita los datos más recientes.
* La sintaxis completa es ligeramente más compleja, pero ofrece más control sobre la profundidad de los datos cuando necesita manejar valores históricos.

{% hint style="success" %}
¡La opción de sintaxis no afecta la fórmula en sí! También puede combinar la sintaxis corta y la completa en la misma fórmula.
{% endhint %}

Las fórmulas también pueden llamar a las funciones de zona, que leen la posición del dispositivo frente a las zonas de su cuenta. `geofenceName()` devuelve el nombre de la zona en la que está el dispositivo, como texto, por lo que encaja directamente como valor de un atributo. Consulte [Funciones de Zona](https://navixy.com/docs/user/es/guide/account/iot-logic/nodes/geofence-functions.md).

Ambas opciones de sintaxis pueden leer un valor que no existe. Una fórmula que luego calcule con ese valor no produce nada, y el atributo se omite del paquete de datos. Consulte [Valores faltantes en expresiones](https://navixy.com/docs/user/es/guide/account/iot-logic/nodes/missing-values-in-expressions.md).

### Sintaxis corta

La opción de fórmula corta accede al valor más reciente del atributo, sin comprobar la validez. Úsela cuando no necesite valores históricos en una fórmula. El valor que lee puede estar vacío, y la mayoría de los operadores no pueden calcular con un valor vacío.

{% hint style="info" %}
[Autorrelleno ](#autofill-attribute-names)siempre usa la sintaxis corta.
{% endhint %}

**Sintaxis:** `attribute_name`

**Predeterminados:**

* Índice: `0` (valor actual)
* Validación: `'todos'` (incluye valores nulos)

Por ejemplo, la forma corta `temperature` equivale a la fórmula completa `value('temperature', 0, 'all')`. Esto significa que puede crear cálculos fácilmente sin agregar explícitamente los parámetros predeterminados:

```jexl
temperature * 1.8 + 32
```

### Sintaxis completa

Usar la sintaxis completa de fórmulas le permite acceder a valores históricos o al modo de validación explícita. Esto ayuda cuando necesita usar valores que no sean los más recientes y manejar nulos. En el caso de la sintaxis completa, necesita definir la completa `value()` función.

**Función:** `value(attribute_name, index, validation)`

**Parámetros:**

<table><thead><tr><th width="152.54547119140625">Parámetro</th><th width="176.45452880859375">Rango/Valores</th><th>Descripción</th></tr></thead><tbody><tr><td><code>attribute_name</code></td><td>Cualquier atributo válido</td><td>Nombre exacto de la telemetría del dispositivo (puede ser <a href="#autofill-attribute-names">autorrellenado</a>)</td></tr><tr><td><code>index</code></td><td>0-11</td><td>Posición histórica: 0=actual, 1=anterior, 11=valor almacenado más antiguo</td></tr><tr><td><code>validation</code></td><td><code>'todos'</code> o <code>'válido'</code></td><td><code>'todos'</code>=incluye nulos (índice exacto), <code>'válido'</code>=excluye nulos (n-ésima lectura válida)</td></tr></tbody></table>

Navixy almacena 12 lecturas por atributo para cada dispositivo y las conserva hasta por 30 días después del mensaje más reciente de ese dispositivo. Un dispositivo que regresa después de más de 30 días de silencio comienza sin historial. En el primer mensaje posterior, `value('temperature', 1, 'valid')` se resuelve como null. Para comprobar qué historial tiene actualmente un dispositivo, abra [Analizador de datos](https://navixy.com/docs/user/es/guide/account/iot-logic/data-stream-analyzer.md).

**Ejemplos:**

* Cualquier lectura anterior

```jexl
value('temperature', 1, 'all')
```

* La quinta lectura válida hacia atrás

```jexl
value('speed', 5, 'valid')
```

* Cambio de temperatura (se usan la sintaxis corta y la completa en la misma fórmula)

```jexl
temperature - value('temperature', 1, 'all')
```

{% hint style="info" %}
Para más ejemplos de fórmulas, consulte [Ejemplos de cálculos](https://navixy.com/docs/user/es/guide/account/iot-logic/nodes/initiate-attribute-node/calculation-examples.md).
{% endhint %}

## Editar atributos existentes

Para modificar un atributo existente:

1. Abra la ventana de configuración del nodo pasando el cursor sobre el nodo para mostrar las acciones rápidas, o haciendo doble clic en el nodo
2. Busque el atributo que desea editar en la lista de atributos
3. Haga los cambios necesarios en los campos de texto de las propiedades del atributo: **Nombre del atributo**, **Fórmula** o la configuración de tiempo
4. Si necesita editar otros atributos en este nodo, repita el paso 3 para ellos
5. Haga clic en **Guardar** para aplicar sus cambios a la configuración del nodo

{% hint style="info" %}
Cuando edita un atributo, los cambios solo se aplicarán a los datos nuevos recibidos después de guardar. Los datos históricos ya recopilados no se volverán a calcular.
{% endhint %}

## Eliminar atributos

Para eliminar un atributo que ya no necesita:

1. Abra la ventana de configuración del nodo pasando el cursor sobre el nodo para mostrar las acciones rápidas, o haciendo doble clic en el nodo
2. Busque el atributo que desea eliminar y haga clic en <img src="https://1900701122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-91fdf4a5f67bca3919ef3bde451fbd50678ef82e%2Fimage.png?alt=media" alt="" data-size="line">
3. Haga clic en **Aplicar cambios** para confirmar la configuración del nodo

{% hint style="info" %}
Cuando elimina un atributo, ya no se calculará para los datos nuevos, pero los datos históricos que contengan este atributo permanecerán sin cambios en la base de datos.
{% endhint %}


---

# 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/managing-attributes.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.
