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

# IF/THEN Логика

Маршрутизируйте потоки данных IoT Logic по условиям с помощью узла IF/THEN Логика. Оценивайте значения телеметрии, запускайте действия для подходящих записей и пропускайте остальные.

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

{% columns %}
{% column %}
Этот **IF/THEN Логика** Узел создаёт интеллектуальные точки ветвления, которые направляют входящие данные по разным путям в зависимости от логических условий. Он получает данные от других узлов, проверяет их на соответствие заданным вами условиям и направляет результаты по разным путям в зависимости от того, прошла проверка или нет. Узел позволяет строить рабочие процессы IF->THEN/ELSE, в которых разные действия выполняются автоматически на основе условий данных в реальном времени.
{% endcolumn %}

{% column %}

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

{% hint style="info" %}
Этот **IF/THEN Логика** Узлы настраиваются отдельно для каждого потока в интерфейсе платформы Navixy. Каждый узел содержит только одну логическую формулу, используя [язык выражений Navixy IoT Logic](/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md).\
Для конкретных вариантов синтаксиса, связанных с логическими выражениями, см. [Выражения и синтаксис IF/THEN Логика](/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md).
{% endhint %}

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-4501f0ee515603cadec633c0b982378708c29190%2Fiot-logic-logic-node-in-flow.png?alt=media" alt="IF/THEN Logic node positioning in the flow architecture (with inbound and outbound connections)"><figcaption></figcaption></figure>

### Как работают узлы IF/THEN Логика

Когда данные впервые поступают в **IF/THEN Логика** узел, IoT Logic создаёт пользовательский булевый атрибут, который хранит результаты вычисления. Каждый последующий пакет данных проверяется по вашему логическому выражению, обновляя значение этого атрибута и направляя данные соответствующим образом:

* **Истинные результаты**: Данные проходят по соединению THEN (зелёное), а булевый атрибут устанавливается в `true`.
* **Ложные результаты**: Данные проходят по соединению ELSE (красное), а булевый атрибут устанавливается в `false`. Это обычный случай, но не единственный: при отсутствии значения некоторые операторы направляют данные в ELSE, оставляя атрибут `null` вместо `false`. См. [Отсутствующие значения и маршрутизация null](/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md#missing-values-and-null-routing).

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

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

Булевы атрибуты, создаваемые **IF/THEN Логика** узлами, выходят за рамки маршрутизации потока и интегрируются с более широкими возможностями мониторинга Navixy. Поскольку это пользовательские настраиваемые атрибуты, их можно:

* **Отслеживать в реальном времени**: Просматривайте результаты вычисления в [Анализ данных](/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md) для устранения неполадок в условиях и проверки логики
* **Добавлять как пользовательские датчики**: Интегрировать с основным интерфейсом Navixy для постоянного мониторинга

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

* **Срабатывание оповещений**: Вы можете создавать пользовательские правила на основе значения датчика, чтобы получать уведомления при отклонениях. Подробности о создании правил см. в [Правила и уведомления](/docs/user/ru/guide/events-and-notifications.md).
* **Контролируемые сущности**: Вы можете добавить атрибут в [Список объектов](/docs/user/ru/guide/tracking/objects-list.md) виджет, чтобы отслеживать его значение вместе с другими показаниями устройства. Подробности о том, как создать пользовательский датчик на основе атрибута IoT Logic, см. в [Отображение новых вычисляемых атрибутов на платформе Navixy](/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/displaying-new-calculated-attributes-on-the-navixy-platform.md).

{% hint style="info" %}
Этот **IF/THEN Логика** Узел требует подключения хотя бы к одному предыдущему узлу (**Источник данных** или другим узлам обработки), чтобы получать входные данные для проверки.
{% endhint %}

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

Этот **IF/THEN Логика** Узел предлагает:

* **Условная маршрутизация данных**: Создавайте ветвящиеся рабочие процессы, которые автоматически направляют данные на основе логических выражений, возвращающих истинный или ложный результат.
* **Проверка в реальном времени**: Проверяйте входящие данные устройства по бизнес-правилам и операционным порогам по мере поступления данных.
* **Поддержка сложных условий**: Объединяйте несколько параметров с помощью логических операторов (AND, OR и т. д.) для более сложного принятия решений.
* **Условия на основе геозоны**: Ссылайтесь на именованные геозоны Navixy непосредственно в выражениях с помощью `inGeofence()`, `enterGeofence()`, и `leaveGeofence()` функций, без ручного сравнения координат. `geofenceName()` возвращает название геозоны, в которой находится устройство, так что одно условие может охватывать много областей. См. [Функции зон](/docs/user/ru/guide/account/iot-logic/nodes/geofence-functions.md).
* **Создание атрибута**: Создавайте булевы атрибуты, которые записывают результаты проверки для использования в других узлах, системах мониторинга Navixy и сторонних сервисах.
* **Гибкие выходные пути**: Направляйте данные по соединениям THEN (истина) и ELSE (ложь, или иногда null при отсутствии значения), чтобы вызывать разные последующие действия.

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

{% columns %}
{% column valign="middle" %}
Этот **IF/THEN Логика** Узел позволяет задавать условные выражения, которые оценивают входящие данные и создают ветвящиеся пути в вашем потоке на основе результатов.
{% endcolumn %}

{% column %}

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

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

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

{% stepper %}
{% step %}

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

Введите описательное имя для этого **IF/THEN Логика** узле.

* Используйте имя, которое чётко указывает назначение проверки (например, *Проверка тревоги по температуре*, *Обнаружение превышения скорости*).
* Это имя будет отображаться на схеме потока для удобной идентификации.
  {% endstep %}

{% step %}

#### Задайте имя выражения

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

* Этот атрибут появится в [Анализ данных](/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md) и станет доступен для использования в последующих узлах.
* Используйте описательные имена, например *high\_temperature\_alert* или speed\_violation\_detected.
* Система автоматически сгенерирует имена вроде *logic\_1*, *logic\_2* если имя не указано.
  {% endstep %}

{% step %}

#### Создайте условное выражение

Соберите своё логическое утверждение с помощью поля выражения.

* Используйте [логические операторы согласно синтаксису языка выражений Navixy](/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md) для ссылки на параметры устройства и вычисляемые атрибуты.
* Выражение должно возвращать булево значение (true/false) для корректной работы узла. Отсутствующее значение может вести себя иначе. См. [Отсутствующие значения и маршрутизация null](/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md#missing-values-and-null-routing).
* Используйте [функцию автодополнения](/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names) чтобы выбрать доступные атрибуты из подключённых источников данных.
* Чтобы сослаться на геозону Navixy как на условие, используйте [выбор геозоны](/docs/user/ru/guide/account/iot-logic/nodes/geofence-functions.md#how-to-add-a-geofence-condition) в поле выражения.
  {% endstep %}

{% step %}

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

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

{% step %}

#### Подключите выходные пути

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

* **Соединение THEN** (зелёное): Подключается к узлам, которые должны обрабатывать данные, когда выражение вычисляется как true.
* **Соединение ELSE** (красное): Подключается к узлам, которые должны обрабатывать данные всякий раз, когда выражение не вычисляется как true. Сюда входит результат false или отсутствующее значение, которое узел не смог вычислить.
* Соединение THEN обязательно, а соединение ELSE — необязательно.
  {% endstep %}
  {% endstepper %}

{% hint style="warning" %}
Отсутствующие данные часто направляются по пути ELSE, но не всегда. A `!=` Сравнение отсутствующего значения с не-null-литералом даёт `true` и направляется в THEN вместо этого, как и `!~`, и `!^` и `!$` когда значение поступает из `value()`. Синтаксические ошибки тоже направляются в ELSE, но сохраняют атрибут как `null`, а не `false`. См. [Отсутствующие значения и маршрутизация null](/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md#missing-values-and-null-routing) за полным набором шаблонов, безопасных к null, и таблицами операторов.
{% endhint %}

Подробную информацию о синтаксисе выражений, операторах и поведении потока данных см. в [Выражения и синтаксис IF/THEN Логика](/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md).

## Выходные соединения и поток данных

Этот **IF/THEN Логика** Узел создаёт два отдельных выходных пути на основе результатов вычисления выражения.

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-4501f0ee515603cadec633c0b982378708c29190%2Fiot-logic-logic-node-in-flow.png?alt=media" alt="IF/THEN Logic node showing THEN and ELSE connections with green and red color coding"><figcaption></figcaption></figure>

### Соединение THEN (<mark style="color:зелёный;">зелёный</mark>)

* **Активируется, когда**: логическое выражение возвращает `true`.
* **Требование к соединению**: Обязательно. Каждый узел IF/THEN Логика должен иметь как минимум один выход THEN.
* **Несколько соединений**: Может подключаться к нескольким последующим узлам для параллельной обработки.
* **Типичные случаи использования**: Срабатывание оповещений, специальная обработка, условные вычисления или направление данных к определённым конечным точкам.

### Соединение ELSE (<mark style="color:красное;">красное</mark>)

* **Активируется, когда**: логическое выражение возвращает `false`, вычисляется как `null`, или не может быть вычислено.
* **Исключения, на которые стоит обратить внимание**: Большинство сравнений с отсутствующим значением направляются сюда. A `!=` Сравнение отсутствующего значения с не-null-литералом направляется в THEN вместо этого, как и `!~`, и `!^` и `!$` при отсутствии `value()` результата.
* **Сохраняемое значение не всегда `false`**: Направление в ELSE не гарантирует, что булевый атрибут будет сохранён как `false`. Реляционные сравнения (`<`, `<=`, `>`, `>=`) и простая ссылка на отсутствующее значение попадают в ELSE, а атрибут остаётся `null`. См. [Отсутствующие значения и маршрутизация null](/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md#missing-values-and-null-routing).
* **Требование к соединению**: Необязательно. Используйте только тогда, когда нужно обрабатывать отрицательные результаты.
* **Обработка ошибок**: Обрабатывает случаи, когда выражения не могут быть вычислены из-за синтаксических ошибок или недопустимых типов данных. Маршрутизация при отсутствии данных зависит от оператора. См. [Отсутствующие значения и маршрутизация null](/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md#missing-values-and-null-routing).
* **Типичные случаи использования**: Запись неудачных проверок, направление данных по альтернативным путям обработки или продолжение обычной работы.

### **Требование к терминальному узлу**

При подключении к терминальным узлам ([Действие](/docs/user/ru/guide/account/iot-logic/nodes/action-node.md), [Вебхук](/docs/user/ru/guide/account/iot-logic/nodes/webhook-node.md)) которые не поддерживают исходящие соединения, создавайте параллельные соединения, чтобы и терминальный узел, и узел передачи данных получали данные:

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

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

* Обеспечивает сохранность данных и видимость системы
* Позволяет проверять поток
* Обе ветви могут использовать один и тот же узел передачи данных

{% hint style="danger" %}
**Ошибка проверки:** Потоки без узлов передачи данных во всех ветвях не будут сохранены из-за ошибки.
{% endhint %}

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

#### Могу ли я использовать атрибуты, созданные другими узлами, в выражениях IF/THEN Логика?

Да. **IF/THEN Логика** Узлы могут ссылаться на любые атрибуты, доступные из подключённых источников данных, включая исходные параметры устройства и атрибуты, вычисленные предыдущими **Вычисление атрибута** узлами. Функция автодополнения помогает выбирать из всех доступных атрибутов.

#### Что происходит, если в моём выражении есть синтаксические ошибки?

Если выражение содержит синтаксические ошибки или не может быть вычислено, узел **IF/THEN Логика** направляет данные через соединение ELSE и сохраняет атрибут как `null`, а не `false`. Проверьте синтаксис выражения и убедитесь, что все указанные атрибуты существуют в вашем потоке данных.

#### Могу ли я соединить несколько узлов с одним выходом узла IF/THEN Логика?

Да. И соединения THEN, и соединения ELSE поддерживают несколько исходящих соединений, что позволяет запускать несколько разных действий на основе одного и того же логического условия. Это обеспечивает параллельную обработку для сложных бизнес-процессов.

#### Как отслеживать результаты узла IF/THEN Логика?

Результаты узла IF/THEN Логика отображаются как булевы атрибуты в [Анализ данных](/docs/user/ru/guide/account/iot-logic/data-stream-analyzer.md) таблице. Выберите свои устройства и найдите имя атрибута, которое вы указали в поле имени выражения. Значения обычно отображаются как `true` или `false`, но при отсутствии значения атрибут может остаться `null` вместо этого, в зависимости от оператора. См. [Отсутствующие значения и маршрутизация null](/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md#missing-values-and-null-routing).

#### Почему моё условие сработало, хотя у атрибута ещё нет значения?

Скорее всего, условие использует `!=` по сравнению с не-null-литералом, или `!~`, для значения, которое ещё ни разу не поступало. Оба оператора трактуют «отсутствие значения» иначе, чем литерал, с которым вы сравниваете, поэтому они вычисляются как `true` и направляют в THEN. Безопасное значение по умолчанию дало бы противоположный результат. A `!^` и `!$` операторы делают то же самое при отсутствии `value()` результата и сводятся к `null` когда атрибут указан по имени. Добавьте проверку присутствия (`value('attr', 0, 'all') != null && ...`) или явную `== null` проверку, если условие должно срабатывать только после того, как у атрибута появится реальное значение. См. [Отсутствующие значения и маршрутизация null](/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md#missing-values-and-null-routing) за полным разбором по каждому оператору.

#### Могу ли я связать несколько узлов IF/THEN Логика в цепочку?

Да. Вы можете последовательно соединять **IF/THEN Логика** узлы, чтобы создавать сложные деревья принятия решений. Каждый **IF/THEN Логика** узел может ссылаться на булевы атрибуты, созданные предыдущими **IF/THEN Логика** узлами, что позволяет строить сложные многоэтапные рабочие процессы проверки.

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-ee4829400641ec381aa3dec65b7dbb1d01d6ebc1%2Fiot-logic-logic-node-chained.png?alt=media" alt="Example flow showing multiple IF/THEN Logic nodes connected in sequence for complex decision trees"><figcaption></figcaption></figure>

#### Почему ветви IF/THEN Логика должны подключаться к узлам передачи данных?

Каждая ветвь IF/THEN Логика должна завершаться в узле передачи данных для проверки потока данных и видимости системы. При использовании терминальных узлов (Действие, Вебхук), которые не поддерживают исходящие соединения, создайте параллельное соединение от узла IF/THEN Логика напрямую к узлу передачи данных. При необходимости обе ветви могут использовать один и тот же узел передачи данных.


---

# 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/logic-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.
