> 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/quick-start-guide.md).

# Руководство по быстрому началу работы

Настройте свой первый поток данных IoT Logic, чтобы начать обработку телематических данных. Требуется роль Владелец и как минимум одно активированное устройство в вашей учетной записи Navixy.

Это руководство поможет вам быстро настроить свой первый поток данных в IoT Logic и начать обрабатывать телематические данные.

## Предварительные требования

Перед тем как приступить к созданию своего первого потока, убедитесь, что у вас есть:

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

{% hint style="info" %}
Рабочее пространство IoT Logic доступно только для учетной записи **владельцам учетной записи** и не отображается для обычных **Пользователи**. Подробнее о ролях пользователей см. [Пользователи и роли](https://navixy.com/docs/user/ru/guide/account/users-and-roles.md).
{% endhint %}

## Начать с шаблона

Шаблоны — это альтернатива созданию потока вручную с нуля. Каждый шаблон представляет собой предварительно настроенную структуру потока для распространённого сценария обработки данных, которую можно выбрать на стартовой странице IoT Logic и адаптировать под свои нужды. Подробнее о доступных шаблонах и о том, как их использовать, см. [Шаблоны](https://navixy.com/docs/user/ru/guide/account/iot-logic/quick-start-guide/templates.md).

## Настройка потока

Теперь разберём базовый процесс настройки потока шаг за шагом.

{% stepper %}
{% step %}

### Откройте IoT Logic

В главном меню перейдите в **IoT Logic**. На стартовой странице откроются два раздела: **Шаблоны потоков**, галерея предварительно настроенных структур потока и **Созданные потоки**, таблица со списком всех существующих потоков в вашей учетной записи.

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3d526f4774594125a65fa4fac2b94012de69e2bc%2Fiot-logic-start.png?alt=media" alt="IoT Logic start page showing Flow templates gallery and Created flows table"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Создайте новый поток

1. Нажмите **Создать поток**. В открывшемся диалоговом окне введите имя и описание потока и задайте его состояние включения.
2. Нажмите **Подтвердить** чтобы открыть холст и начать создавать поток.

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3bb4a6bc33fd29a6ff2500ebcaa0f1ff887ef87e%2Fnew-flow.png?alt=media" alt="Create Flow dialog with name, description, and enabled state fields"><figcaption></figcaption></figure>

{% hint style="info" %}
Если вы предпочитаете начать с предварительно настроенной структуры, вместо создания потока с нуля можно использовать шаблон. Шаблоны — это предварительно настроенные потоки для распространённых сценариев обработки данных. См. [Шаблоны](https://navixy.com/docs/user/ru/guide/account/iot-logic/quick-start-guide/templates.md) полный список и инструкции по настройке.
{% endhint %}
{% endstep %}

{% step %}

### Настройте узел «Источник данных»

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

1. Из **Узлы** панель, которая группирует доступные узлы по **Начало**, **Обработка**, **Действие**, и **Конец** разделам, перетащите **Источник данных** узел на холст
2. Нажмите на узел, чтобы отобразить быстрые действия, или дважды щёлкните узел, чтобы сразу открыть панель его настройки
3. Настройте следующие параметры:
   1. **Имя узла**: Введите описательное имя, указывающее источник отправляемых данных (например, *Транспорт сотрудников*)
   2. **Источники**: Выберите устройства, показания которых вы хотите отправлять в этот поток.
4. Нажмите **Примените изменения** чтобы применить конфигурацию

{% hint style="info" %}
Подробнее о настройке узла см. [узле «Источник данных»](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/data-source-node.md).
{% endhint %}
{% endstep %}

{% step %}

### Добавьте обогащение данных

На этом шаге настройте вычисления, чтобы обогатить сырые данные или даже математически создать совершенно новые атрибуты данных.

1. Перетащите **Вычисление атрибута** узел на холст
2. Нажмите на узел, чтобы отобразить быстрые действия, или дважды щёлкните узел, чтобы открыть панель его настройки
3. Добавьте описательное имя **Имя узла** чтобы указать его назначение и выполняемые вычисления (например, *Temperature °F to °C*)
4. Задайте атрибут:
   1. **Имя атрибута**: понятное описательное имя (например, "speed\_mph")
   2. **Формула**: выражение вычисления (например, `speed/1.609` для преобразования км/ч в mph)\
      :bulb:**Примечание**: Краткий синтаксис — основной вариант. Используйте полный синтаксис, если вам нужны исторические/индексированные значения или явные проверки валидности (например, `value('speed', 1, 'valid')`).\
      Имена атрибутов [могут заполняться автоматически](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names) чтобы избежать опечаток.
5. Добавьте дополнительные атрибуты при необходимости, нажав **Добавить атрибут**.
6. Нажмите **Примените изменения** чтобы применить конфигурацию
7. Создайте соединение:
   1. Нажмите на выходной разъём **Источник данных** узел
   2. Перетащите переход к входному разъёму **Вычисление атрибута** узел

{% hint style="info" %}
Подробнее о настройке узла см. [узел Вычисление атрибута](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node.md).

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

См. примеры формул вычисления. [Примеры вычислений](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/calculation-examples.md).
{% endhint %}
{% endstep %}

{% step %}

### Настройте вывод данных

Этот шаг определяет, куда данные отправляются из этого потока. Вы можете направить их в Navixy или стороннюю систему через MQTT.

1. Перетащите **Узел передачи данных** узел на холст
2. Наведите курсор на узел, чтобы отобразить быстрые действия, или дважды щёлкните узел, чтобы открыть панель его настройки
3. Выберите конечную точку **Режим**:

* **Узел передачи данных по умолчанию**: стандартный вывод для отправки данных потока на платформу Navixy. Он предварительно настроен и не подлежит редактированию.
* **Узел передачи по MQTT**: пользовательский вывод для отправки данных потока во внешние системы через MQTT.

4. Настройте параметры, специфичные для предустановки. Выход по умолчанию предварительно настроен; инструкции по настройке других предустановок и параметров см. [Настройки в зависимости от режима](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/output-endpoint-node.md#mode-specific-configurations).
5. Нажмите **Примените изменения** чтобы применить конфигурацию
6. Соедините остальные узлы с этим в нужном порядке, чтобы завершить структуру потока

{% hint style="info" %}
Каждый поток должен включать **Узел передачи данных по умолчанию** узел, чтобы данные отправлялись на платформу. Без этого соединения данные устройства не отображаются в интерфейсе Navixy.

Подробнее о настройке узла см. [Узел передачи данных](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/output-endpoint-node.md).
{% endhint %}
{% endstep %}

{% step %}

### Сохраните и активируйте поток

1. Проверьте, что все узлы в вашем потоке правильно соединены
2. Нажмите кнопку **Сохранить поток** кнопки в **Узлы** панель

{% hint style="success" %}
Теперь ваш поток активен и обрабатывает данные в реальном времени!
{% endhint %}
{% endstep %}
{% endstepper %}

## Проверка потока

Структура потока и формулы автоматически проверяются IoT Logic, при этом отображаются предупреждения и сообщения об ошибках, если конфигурация неполная или содержит ошибки.

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

1. Нажмите кнопку **вкладку «Анализ данных»** вкладку в верхней части холста
2. Выберите устройства, за которыми хотите наблюдать, из раскрывающегося списка
3. Наблюдайте входящие атрибуты данных и их значения
4. Используйте параметры фильтрации, чтобы сосредоточиться на конкретных параметрах
5. Проверьте, что все вычисляемые атрибуты отображают правильные значения

Подробнее об использовании инструмента см. [Анализ данных](https://navixy.com/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md).

{% hint style="success" %}
Поздравляем! Ваш первый поток данных IoT Logic уже работает.
{% endhint %}

## Следующие шаги

После создания первого потока IoT Logic вы можете:

* Адаптировать этот быстрый пример под потребности вашего бизнеса
* Создавать более сложные преобразования данных с несколькими [узлах «Вычисление атрибута»](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node.md)
* Настроить дополнительные [точки вывода](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/output-endpoint-node.md) для ваших данных, которые могут стать повторно используемыми профилями для единообразной настройки
* [Управлять уже созданными потоками](https://navixy.com/docs/user/ru/guide/account/iot-logic/flow-management.md) чтобы адаптировать обработку данных к любым изменениям, с которыми вы столкнётесь
* [Проектировать сложные потоки](https://navixy.com/docs/user/ru/guide/account/iot-logic/flow-management/flow-configuration-example.md) для конкретных бизнес-сценариев, используя различные комбинации и настройки узлов

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

### Что происходит с устройствами, не назначенными пользовательскому потоку?

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

### Могу ли я использовать одно и то же устройство в нескольких потоках?

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

### Продолжит ли мой поток работать, если я выйду из системы?

Да, после активации потоки работают независимо от вашей пользовательской сессии. Пока поток включён, он обрабатывает данные даже тогда, когда вы не вошли в систему.

### Как понять, что мой поток работает корректно?

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

### Что произойдёт, если я отключу поток?

Когда вы отключаете поток, вся передача данных для устройств, назначенных ему, останавливается, включая доставку на платформу Navixy. Устройства больше не отображаются и не обновляются в интерфейсе, пока поток не будет снова включён. Отключайте поток только тогда, когда вы намеренно хотите полностью остановить передачу данных для затронутых устройств.


---

# 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/quick-start-guide.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.
