> 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
* активированные устройства в Вашей учетной записи
* понимание того, какие источники данных Вы хотите обрабатывать

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

## Начало работы с шаблоном

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

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

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

{% stepper %}
{% step %}

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

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

<figure><img src="/files/2b77530726cb3e26d98003242855b57b834494d2" alt="IoT Logic start page showing Flow templates gallery and Created flows table"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

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

<figure><img src="/files/413f9b7890fb5ddff3587eaa73abd7fc102dc156" alt="Create Flow dialog with name, description, and enabled state fields"><figcaption></figcaption></figure>

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

{% step %}

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

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

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

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

{% step %}

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

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

1. Перетащите **Инициировать атрибут** узел на холст
2. Щелкните узел, чтобы показать быстрые действия, или дважды щелкните узел, чтобы открыть его панель настройки
3. Добавьте описательный **Имя узла** чтобы указать его назначение и выполняемые им вычисления (например, *Преобразование температуры °F в °C*)
4. Определите Ваш атрибут:
   1. **Имя атрибута** - Понятное, описательное имя (например, "speed\_mph")
   2. **Формула** - Выражение вычисления (например, `speed/1.609` для преобразования км/ч в миль/ч)\
      :bulb:**Примечание**: Краткий синтаксис является основным вариантом. Используйте полный синтаксис, когда Вам нужны исторические/индексированные значения или явные проверки валидности (например, `value('speed', 1, 'valid')`).\
      Имена атрибутов [могут быть заполнены автоматически](/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" %}
Подробности о настройке узла см. [Узел Initiate Attribute](/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node.md).

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

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

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

Подробности о настройке узла см. [узла Output Endpoint](/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. Убедитесь, что вычисляемые атрибуты отображают правильные значения

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

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

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

Теперь, когда Вы создали свой первый поток IoT Logic, Вы можете:

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

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

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

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

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

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

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

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

#### Как мне узнать, работает ли мой поток правильно?

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

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

Когда Вы отключаете поток, вся передача данных для назначенных ему устройств прекращается — включая доставку на платформу 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/user/ru/guide/account/iot-logic/quick-start-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
