# Руководство по быстрому запуску

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

## Требования

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

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

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

## Конфигурация потока

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

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2FGAVD9gNxaRYpHDSAlOmf%2FIot%20Logic%20Demo%20Screencast.mp4?alt=media&token=94fd4cf6-bd45-4953-9263-52863288d9b9>" %}
Процесс создания нового потока с вычислениями атрибутов данных и добавлением пользовательских атрибутов к устройствам на платформе
{% endembed %}

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

{% stepper %}
{% step %}

### Шаг 1: Доступ к рабочей области IoT Logic

1. Войдите в вашу учетную запись Navixy
2. Нажмите на значок профиля в верхнем левом углу экрана, чтобы перейти в **Настройки аккаунта**
3. Выберите **IoT Logic** в боковой панели настроек

Рабочая область IoT Logic содержит три основных секции:

* **Панель настроек потока** - Содержит элементы управления для управления потоками
* **Панель узлов** - Перечисляет доступные узлы для построения вашего потока
* **Холст** - Основное рабочее пространство, где вы проектируете поток

Для подробностей о рабочей области см. [Рабочее пространство и поток по умолчанию](https://www.navixy.com/docs/user/ru/guide/account/iot-logic/workspace-and-default-flow).
{% endstep %}

{% step %}

### Шаг 2: Создайте новый поток

1. Нажмите **New flow** кнопка на панели настроек потока
2. В **New flow** диалоговом окне:

* Введите описательное имя для вашего потока (например, «Fleet Telemetry Processing»)
* Добавьте краткое описание, объясняющее назначение потока
* Убедитесь, что переключатель **Flow enabled** переключатель включен

3. Нажмите **Сохранить** чтобы создать поток

Для дополнительной информации о настройке потока см. [Управление потоками -> Создание нового потока](https://www.navixy.com/docs/user/ru/guide/account/flow-management#creating-a-new-flow).

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

{% step %}

### Шаг 3: Настройте узел источника данных

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

* **Имя узла** - Введите описательное имя, указывающее происхождение отправляемых данных (например, *Служебные автомобили*)
* **Источники** - Выберите устройства, показания которых вы хотите отправлять в этот поток. Вы можете отфильтровать доступные устройства по данным **Производитель** и модели **Модель**.

4. Нажмите **Сохранить** для применения конфигурации

Для подробностей о конфигурации узла см. [Узел Data Source](https://www.navixy.com/docs/user/ru/guide/account/iot-logic/flow-management/data-source-node).
{% endstep %}

{% step %}

### Шаг 4: Добавьте обогащение данных (необязательно)

1. Перетащите ещё один **Initiate Attribute** узел на холст
2. Наведите курсор на узел, чтобы отобразить быстрые действия, или дважды щелкните узел, чтобы открыть панель его конфигурации
3. Добавьте описательный **Имя узла** чтобы указать его назначение и выполняемые вычисления (например, *Температура °F в °C*)
4. Определите ваш атрибут:
   1. **Имя атрибута** - Четкое, описательное имя (например, «speed\_mph»)
   2. **Formula** - Выражение вычисления (например, `value('speed')/1.609` для преобразования км/ч в миль/ч)\
      :bulb:**Примечание**: Имена атрибутов [могут заполняться автоматически](https://www.navixy.com/docs/user/ru/guide/account/flow-management/initiate-attribute-node/managing-attributes#autofill-attribute-names) чтобы обеспечить корректное именование. Автозаполнение по умолчанию использует короткий синтаксис, который обращается к последнему значению атрибута.
   3. **Время генерации** - Когда запись данных была создана на устройстве (по умолчанию `now()`)
   4. **Серверное время** - Когда данные были получены сервером (по умолчанию `now()`)
5. Добавьте дополнительные атрибуты при необходимости, нажав **Add attribute**\
   :bulb:**Примечание**: Кнопка **Сбросить форму** откидывает все созданные атрибуты внутри узла. Если вы хотите удалить определенный атрибут, нажмите три точки справа от строки атрибута и выберите **Delete**.
6. Нажмите **Сохранить** для применения конфигурации
7. Создать соединение:
   1. Нажмите выходной разъем у **Источник данных** узлу
   2. Перетащите переход к входному разъему у **Initiate Attribute** узлу

Для подробностей о конфигурации узла см. [Узел Initiate Attribute](https://www.navixy.com/docs/user/ru/guide/account/iot-logic/flow-management/initiate-attribute-node).

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

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

{% step %}

### Шаг 5: Настройте вывод данных

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

* **Конечная точка Navixy** - стандартная конечная точка для отправки обработанных данных на платформу Navixy. Она предварительно настроена и не допускает изменений
* **MQTT endpoint** - конечная точка для отправки данных в сторонние назначения с использованием MQTT в качестве транспортного протокола. Требует ручной настройки, описанной в последующих шагах

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

4. Настройте следующие параметры:
   1. **Имя конечной точки** - Введите описательное имя, чтобы указать назначение, куда отправляются данные
   2. **Протокол** - Выберите протокол передачи данных (в настоящее время доступен только «Navixy Generic Protocol (JSON)»)
   3. **IP/Домен** - Введите адрес назначения
   4. **Порт** - Укажите номер порта (по умолчанию: 1883 для стандартного MQTT, 8883 для SSL)
   5. (необязательно) **Включить SSL** - Переключите ВКЛ для защищенных соединений
   6. **Версия MQTT** - Выберите соответствующую версию (**3.1.1** или 5.0)
   7. **Идентификатор клиента** - Введите идентификатор для вашего клиента, чтобы обеспечить принятие данных принимающей стороной
   8. (необязательно) **Темы** - Укажите MQTT-темы для передачи данных
   9. **QoS** - Выберите уровень качества обслуживания, чтобы определить логику передачи данных (**0**, **1**, или **2**)
5. Если на стороне получателя требуется аутентификация, включите **Аутентификация MQTT** ВКЛ\
   Появившиеся поля заполняются автоматически учетными данными вашей платформенной учетной записи

{% hint style="danger" %}
Узел **Сбросить форму** откидывает все созданные атрибуты внутри узла. Если вы хотите удалить определенный атрибут, нажмите три точки справа от строки атрибута и выберите **Delete**.
{% endhint %}

6. Нажмите **Создавать** для применения конфигурации
7. Подключите другие узлы к этому выходному узлу в нужном порядке, чтобы завершить структуру потока

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

Для подробностей о конфигурации узла см. [Узел Output Endpoint](https://www.navixy.com/docs/user/ru/guide/account/iot-logic/flow-management/output-endpoint-node).
{% endstep %}

{% step %}

### Шаг 6: Сохраните и активируйте ваш поток

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

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

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

Чтобы подтвердить правильную работу потока, используйте **Data Stream Analyzer** инструмент:

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

Для подробностей по использованию инструмента см. [Data Stream Analyzer](https://www.navixy.com/docs/user/ru/guide/account/iot-logic/data-stream-analyzer).

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

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

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

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

### Адаптация этого примера

Этот пример можно адаптировать для различных отраслевых сценариев, изменяя:

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

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

## Доступ через API

Функциональностью IoT Logic также можно управлять программно через API Navixy. Это позволяет разработчикам автоматизировать создание потоков, их управление и мониторинг.

{% hint style="info" %}
По соображениям безопасности доступ к API требует соответствующих разрешений. Свяжитесь с администратором вашей учетной записи, чтобы убедиться, что у вас есть необходимые права доступа.
{% endhint %}

Для полной документации по API, параметрам, форматам запросов/ответов и примерам кода обратитесь к [Документация API Navixy IoT Logic](https://app.gitbook.com/o/YVLWhgAwCZPoU5vlRsCs/s/tx3J5BxnWyPV0nP2xr0z/).

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

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

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

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

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

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

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

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

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

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

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