> 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/action-node.md).

# Действие устройства

Используйте узлы «Действие устройства» в IoT Logic для отправки автоматических команд GPS-устройствам, например для переключения выходов или отправки команд GPRS при срабатывании потоков данных.

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

{% columns %}
{% column width="58.333333333333336%" %}
**Действие устройства** Узлы в IoT Logic обеспечивают автоматическое управление устройствами, выполняя определенные команды при срабатывании на входящие потоки данных. Эти узлы превращают пассивный мониторинг автопарка в системы активной автоматизации, выполняя критические операции, такие как переключение выходов и передача GPRS-команд.
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-27fd0fcd59006fe239613efa78b54104a09ef845%2Fiot-logic-action-node-tile.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Хотя узлы «Действие устройства» могут получать данные от любого типа узла, чаще всего их подключают к [IF/THEN Логика](/docs/user/ru/guide/account/iot-logic/nodes/logic-node.md) узлам, которые оценивают условия и запускают действия только при выполнении заданных критериев, например при достижении порогов температуры, несанкционированном движении или инцидентах опасного вождения.

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

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-5d9dcc9b57c4508e018fe783c48f11bd5eaa4d65%2Fiot-logic-action-node-in-flow.png?alt=media" alt=""><figcaption></figcaption></figure>

### Как работают узлы «Действие устройства»

Когда данные поступают в **Действие устройства** узел, система определяет, какие устройства предоставили входящие данные, и выполняет настроенные действия только для этих устройств. Подробности о порядке выполнения и выборе целей см. в [Выполнение действий и выбор целей](#action-execution-and-targeting) ниже.

{% hint style="info" %}
**Требование к подключению устройств**: действия отправляются только на устройства, подтверждённо находящиеся на связи (то есть предоставляющие недавние данные), что обеспечивает надежную доставку команд.
{% endhint %}

Каждый **Действие устройства** результат срабатывания узла появляется в [Анализ данных](/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md) в виде атрибута с именем, совпадающим с **ID узла** (показан в диалоге настройки узла, например `action_1a2b3c4d`). Значение равно `0` при несрабатывании узла и `1` при его срабатывании, что позволяет вам подтвердить выполнение и различать несколько узлов «Действие устройства» в одном потоке.

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

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

* **Условная автоматизация**: интеграция с [IF/THEN Логика](/docs/user/ru/guide/account/iot-logic/nodes/logic-node.md) узлами позволяет создавать сложные сценарии IF/THEN, в которых действия выполняются только при подтверждении заданных условий
* **Управление устройствами в реальном времени**: команды передаются в течение нескольких секунд после получения триггеров, что обеспечивает мгновенную реакцию на критические условия
* **Координация всего автопарка**: при подключении к нескольким источникам устройств действия могут координировать реакции одновременно по всему автопарку
* **Учет возможностей устройства**: индивидуальные ограничения устройств учитываются, а неподдерживаемые команды поступают, но не выполняются

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

{% 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-3f77e43d4a2477ef91c54020c2a1d25dcee7371a%2Faction-node-edit.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

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

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

{% stepper %}
{% step %}

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

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

1. Для ясности используйте названия вроде «Аварийная реакция на охлаждение» или «Действия при тревоге охраны»
2. Это имя отображается на схеме потока для удобства идентификации
   {% endstep %}

{% step %}

#### ID узла (генерируется автоматически)

Под полем «Имя» в диалоге отображается **ID узла** (например, `action_1a2b3c4d`). Это поле доступно только для чтения — вы не можете редактировать или задавать его значение.

1. ID генерируется автоматически при создании узла и остается неизменным на протяжении всего срока его существования
2. Используйте его, чтобы отличать результаты этого узла от результатов других узлов «Действие устройства» в [Анализ данных](/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md), где он отображается как атрибут со значением `0` (не сработал) или `1` (сработал)
   {% endstep %}

{% step %}

#### Выберите тип действия

В поле **Стандартная** на вкладке выберите тип автоматической реакции из выпадающего списка

1. **Переключение выхода**: управляйте выходами устройства, включая их или выключая
2. **Отправка GPRS-команды**: отправляйте пользовательские команды непосредственно на устройства
   {% endstep %}

{% step %}

#### Настройте параметры действия

Задайте конкретные детали в соответствии с выбранным типом действия:

<details>

<summary>Настройка переключения выхода</summary>

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-d9244e7ff7f15d31b6ad7f2f0c565102b4fd8856%2Faction-node-switch-output.png?alt=media" alt=""><figcaption></figcaption></figure>

При настройке действий «Переключение выхода»:

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

</details>

<details>

<summary>Настройка отправки GPRS-команды</summary>

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-fe1b0fa64db4572c41b21eaff3d76c7add2c5c03%2Faction-node-gprs.png?alt=media" alt=""><figcaption></figcaption></figure>

При настройке действий GPRS-команды:

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

</details>
{% endstep %}

{% step %}

#### Добавьте дополнительные действия (необязательно)

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

{% hint style="info" %}

* Команды действий отправляются при получении пакета данных от устройства в соответствии с конфигурацией потока
* Команды выполняются последовательно в том порядке, в котором они указаны в конфигурации
* Каждое действие может быть отдельного типа (Переключение выхода или GPRS-команда)
* Используйте значок корзины, чтобы удалить ненужные действия
  {% endhint %}
  {% endstep %}

{% step %}

#### Настройка сопоставления получателей (необязательно)

Откройте **Дополнительно** вкладку, чтобы определить, какие дополнительные устройства получат те же команды при срабатывании узла.

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-e918338f9aa10b70216ab071e7b77e77ae6202c8%2Faction-node-advanced-tab.png?alt=media" alt=""><figcaption></figcaption></figure>

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

{% hint style="info" %}
Вкладка «Дополнительно» необязательна. Без нее узел ведет себя точно так же, как и раньше — команды выполняются только для устройства, вызвавшего срабатывание.
{% endhint %}
{% endstep %}

{% step %}

#### Сохранить конфигурацию

Нажмите **Примените изменения** чтобы сохранить конфигурацию узла
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
**Примечание о совместимости устройств:** Выполнение действий зависит от возможностей отдельных устройств. Убедитесь, что ваши устройства поддерживают конкретные выходы или команды, которые вы настраиваете. Поддерживаемые команды ищите в ресурсах производителя, например в документации устройства. Список поддерживаемых устройств доступен на [Интегрированные устройства Navixy](https://www.navixy.com/devices/).
{% endhint %}

## Выполнение действий и выбор целей

Этот **Действие устройства** узел обеспечивает точное управление тем, когда и где выполняются команды, гарантируя эффективные и целевые реакции автоматизации.

### Порядок выполнения

При срабатывании **Действие устройства** узел следует такому порядку выполнения:

1. **Выбор устройств**: команды отправляются только на устройства, которые предоставили данные в текущем событии срабатывания
   1. Это гарантирует, что команды дойдут только до конкретных устройств, участвующих в условии
   2. Исключает ненужные команды для не затронутых ими устройств в автопарке
2. **Последовательная обработка**: несколько действий внутри узла выполняются в заданном порядке сверху вниз
   1. Каждое действие завершает передачу перед началом следующего
   2. Общее время выполнения обычно составляет несколько секунд после получения триггера
3. **Проверка устройств**: отдельные устройства обрабатывают полученные команды в соответствии со своими возможностями
   1. Поддерживаемые команды выполняются сразу после получения
   2. Устройство получает неподдерживаемые команды, но игнорирует их
   3. Механизмы безопасности устройства могут предотвращать неподходящие команды (например, выключение двигателя, когда устройство движется)

### Поведение при подключении

**Интеграция с узлом IF/THEN Логика**: при подключении к [IF/THEN Логика](/docs/user/ru/guide/account/iot-logic/nodes/logic-node.md) узлам, действия выполняются только для устройств, для которых логическое условие оценено как `true`. Это обеспечивает точную условную автоматизацию.

**Прямые соединения**: при прямом подключении к другим типам узлов («Источник данных», «Вычисление атрибута»), действия выполняются для всех устройств в потоке данных каждый раз, когда поступают данные.

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

#### Как узнать, успешно ли выполнены мои действия?

Проверьте [Анализ данных](/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md): выберите устройство, вызвавшее срабатывание, и найдите атрибут, соответствующий ID этого узла. См. [Как работают узлы «Действие устройства»](#how-device-action-nodes-work) подробности.

Команды отправляются на устройства, подтверждённо находящиеся на связи (то есть предоставляющие недавние данные), без задержки между срабатыванием и доставкой. Это исключает возможность перехода устройства в оффлайн между срабатыванием и выполнением.

#### Можно ли подключить несколько узлов к одному узлу «Действие устройства»?

Да. Узлы «Действие устройства» могут получать триггеры от нескольких вышестоящих узлов, но имейте в виду, что действия будут выполняться для любого устройства, которое вызовет срабатывание любого подключенного узла. При проектировании сложных потоков учитывайте совокупный эффект нескольких источников триггера, чтобы действия выполнялись только в нужных сценариях. Чтобы убедиться, что узел срабатывает только в нужных сценариях, следите за его атрибутом ID узла в [Анализ данных](/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md): он показывает `1` при каждом срабатывании и `0` в противном случае.

#### Что произойдет, если я подключу узел «Действие устройства» напрямую к «Источнику данных»?

Узел «Действие устройства» будет выполнять настроенные действия каждый раз, когда любое устройство в «Источнике данных» отправляет данные. Это приводит к непрерывному выполнению действий вместо условных реакций. Для большинства сценариев использования подключение узлов «Действие устройства» к [IF/THEN Логика](/docs/user/ru/guide/account/iot-logic/nodes/logic-node.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/action-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.
