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

# Вычисление атрибута

Создавайте новые атрибуты данных из входящей телеметрии с помощью языка выражений Navixy. Переименовывайте параметры, применяйте формулы и обогащайте данные перед отправкой.

## Технический обзор и возможности

{% columns %}
{% column %}
В IoT Logic, **Вычисление атрибута** узел преобразует показания устройства, создавая новые атрибуты данных на основе входящей телеметрии. Этот узел позволяет изменять данные с помощью математических формул, переименовывать существующие параметры и выполнять побитовые операции с помощью [языка выражений Navixy](https://navixy.com/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md). Узел служит ключевым компонентом потока, позволяя обогащать данные перед отправкой в целевые системы.
{% endcolumn %}

{% column %}
![](https://2388694493-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 %}

**Вычисление атрибута** узел настраивается для каждого потока в пользовательском интерфейсе платформы Navixy. О вариантах синтаксиса и подробной справке по языку выражений см. [языка выражений Navixy](https://navixy.com/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md) в пользовательской документации.

<figure><img src="https://2388694493-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>

### Интеграция с архитектурой потока

**Вычисление атрибута** узел работает в архитектуре потока, предоставляя возможности преобразования данных и позволяя:

* обрабатывать необработанные данные телеметрии и преобразовывать их в значимые бизнес-метрики
* создавать вычисляемые поля на основе значений нескольких параметров
* переводить единицы измерения (например, километры в мили)
* вычислять разницу между текущими и предыдущими показаниями
* строить временную аналитику поведения устройства

{% hint style="info" %}
Узел «Вычисление атрибута» требует подключения как минимум одного **Источник данных** узла. Без подключений к входным данным вычисления выполняться не будут.
{% endhint %}

### Возможности узла

Этот **Вычисление атрибута** узел сам по себе предоставляет:

* **Преобразование атрибутов данных**: Создавайте полностью новые атрибуты, применяя математические операции к тем, что поступают из источников данных
* **Преобразование единиц измерения**: Преобразовывайте единицы измерения (например, скорость из *км/ч* в *mph*, или температуру из *°C* в *°F*)
* **Вычисления по времени**: Сравнивайте текущие показания с предыдущими значениями, чтобы определить изменения
* **Манипуляции со временем**: Настраивайте метки времени для момента, когда атрибут был сгенерирован на устройстве и когда его получил сервер, чтобы избежать несоответствий во времени и унифицировать форматы времени
* **Поиск зоны**: Записывайте название зоны, в которой находится устройство, в атрибут с `geofenceName()`, платную опцию. См. [Функции зон](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/geofence-functions.md)

## Параметры конфигурации

{% columns %}
{% column valign="middle" %}
**Вычисление атрибута** узел позволяет определить, как параметры устройства преобразуются в атрибуты, которые будут доступны для дальнейшей обработки в вашем потоке данных.
{% endcolumn %}

{% column %}

<figure><img src="https://2388694493-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 %}

Давайте посмотрим, какие элементы использует этот узел и что можно настраивать при работе с ним:

### Этапы настройки

{% stepper %}
{% step %}

#### Укажите имя узла

Введите описательное имя, чтобы подчеркнуть назначение узла. Используйте имя, которое поможет вам определить вычисления, выполняемые в этом узле; оно будет отображаться на схеме потока для удобной идентификации.
{% endstep %}

{% step %}

#### Задайте имя атрибута

Добавьте отличительный идентификатор атрибута.

* Это имя будет отображаться в [Анализ данных](https://navixy.com/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md),
* Вы также можете использовать это имя для создания пользовательских датчиков в [разделе Мониторинг](https://navixy.com/docs/user/ru/guide/tracking.md) модуле. Для этого **Вычисление атрибута** узел, содержащий этот атрибут, должен быть подключен к **Узел передачи данных** узлу, настроенному в **Узел передачи данных по умолчанию** режиме.
  {% endstep %}

{% step %}

#### Определите формулу

Добавляйте математические выражения для расчета значений атрибутов.

* Используйте `value('parameter_name' 0, 'valid')` формат для ссылки на существующие параметры устройства.\
  **Примечание**. Нажмите ![image-20250605-115154.png](https://2388694493-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) внутри **Формула** поле, чтобы открыть список доступных атрибутов и выбрать нужный. Он будет автоматически добавлен в поле в готовом к использованию формате. Подробнее об автозаполнении имен атрибутов см. [Автозаполнение имен атрибутов](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names).
* Применяйте математические операции на основе [язык выражений Navixy IoT Logic](https://navixy.com/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md) для преобразования значений.
* Используйте разные значения индекса глубины для доступа к историческим значениям (по умолчанию 0).
* Обрабатывайте значения, которые могут отсутствовать. Если значение, необходимое для формулы, отсутствует, формула ничего не возвращает, и у атрибута тогда нет значения для этого пакета. См. [Отсутствующие значения в выражениях](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/missing-values-in-expressions.md).
  {% endstep %}

{% step %}

#### (необязательно) Добавьте еще атрибуты

Нажмите **Добавить атрибут** чтобы открыть диалог настройки нового атрибута. Здесь вы можете создать новый атрибут данных, если требуется выполнить несколько вычислений в рамках одного и того же узла.
{% endstep %}

{% step %}

#### Сохраните конфигурацию узла

Нажмите **Примените изменения** чтобы завершить создание узла.
{% endstep %}
{% endstepper %}

Давайте рассмотрим практический пример настройки атрибутов:

{% columns %}
{% column valign="middle" %}
В этом примере создается атрибут, который преобразует скорость из километров в мили в час, деля параметр CAN speed на 1,609.

Подробнее о вычислениях для новых атрибутов см. [Примеры вычислений](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/calculation-examples.md).

Также вы можете найти подробный пример использования вычисляемых атрибутов в потоке в [примере настройки потока → шаги 3 и 4](https://navixy.com/docs/user/ru/guide/account/iot-logic/flow-management/flow-configuration-example.md#flow-configuration-steps).
{% endcolumn %}

{% column %}

<figure><img src="https://2388694493-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 %}

## Параметры отображения

Новые атрибуты, вычисленные в **Вычисление атрибута** узле, можно отслеживать так же, как и фактические атрибуты данных, поступающие с устройств в **Анализ данных (DSA)** и **разделе Мониторинг** модуля.

Подробнее о параметрах отображения см. [Отображение новых вычисляемых атрибутов на платформе Navixy](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/displaying-new-calculated-attributes-on-the-navixy-platform.md).

## Особенности потока данных

После настройки **Вычисление атрибута** узла обязательно:

1. Подключите узел хотя бы к одному **Источник данных** входному узлу
2. Подключите выход к **Узел передачи данных** узлу, чтобы отправить преобразованные данные

Внутри **Вычисление атрибута** узла значения параметров обрабатываются в соответствии с вашими выражениями каждый раз, когда устройство передает данные. На выходе вы получите:

* Все исходные параметры устройства
* Все вычисленные атрибуты с их значениями
* Обновленные значения времени генерации и времени сервера, как настроено

Если вы используете для вычисляемого атрибута то же имя, что и у существующего параметра, атрибут заменяет исходный параметр в выходном пакете данных.

У атрибута, формулу которого не удалось вычислить, нет значения для этого пакета. Ничто не помечает это как ошибку. Если атрибут использует то же имя, что и параметр устройства, в пакете вместо него сохраняется исходное значение параметра, поэтому пакет выглядит нормально, а вычисление просто не произошло. См. [Отсутствующие значения в выражениях](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/missing-values-in-expressions.md).

## Часто задаваемые вопросы

#### Могу ли я ссылаться в вычислениях не на последние значения?

Да. Используйте параметр index в функции value, чтобы получить доступ к историческим значениям. Например, `value('temperature', 1, 'valid')` ссылается на предыдущее действительное значение параметра температуры.

#### Как выполнять вычисления, связанные со временем?

Используйте `genTime()` и `srvTime()` для работы с метками времени. Вы можете вычислять разницу во времени, добавлять временные смещения или форматировать метки времени для отображения.

#### Что произойдет, если я удалю атрибут?

Атрибут больше не вычисляется для вновь получаемых данных, но исторические данные остаются без изменений. После удаления атрибут не появляется ни в одном новом пакете данных.

#### Могу ли я использовать атрибуты, созданные в одном узле «Вычисление атрибута», в другом?

Да. Атрибуты, созданные раньше в потоке, можно использовать в последующих **Вычисление атрибута** узлах, что позволяет выполнять многоэтапные вычисления. Все созданные атрибуты также доступны с помощью [функции автозаполнения](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names) для обеспечения корректного именования.

<figure><img src="https://2388694493-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>

#### Как избежать опечаток при ссылке на имена атрибутов в формулах?

Используйте функцию автозаполнения в поле Formula, чтобы выбрать из доступных атрибутов. Подробные инструкции см. [Автозаполнение имен атрибутов](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names).

#### Почему один из моих вычисляемых атрибутов иногда отсутствует?

Формулу не удалось вычислить для этих пакетов, чаще всего потому, что значение, которое она считывает, отсутствовало в пакете. Тогда у атрибута нет значения, и ошибка не сообщается. См. [Отсутствующие значения в выражениях](https://navixy.com/docs/user/ru/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/ru/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.
