> 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/missing-values-in-expressions.md).

# Отсутствующие значения в выражениях

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

Формулы и условия в IoT Logic работают со значениями, которые отправляет GPS-устройство. Когда значение, необходимое формуле, отсутствует, большинство операторов не может сформировать результат, и формула не возвращает ничего: не `false`, и не ноль. Эта страница объясняет, когда значение пропадает, как выглядит сбой и как писать формулы и условия, которые продолжают работать. Она предназначена для всех, кто настраивает поток IoT Logic, и не предполагает опыта программирования.

Эта страница относится к обоим местам, где вы пишете выражение: к **Формула** полю [Вычисление атрибута](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node.md) узла, и **Условное выражение (JEXL)** полю [IF/THEN Логика](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/logic-node.md) узле.

## Когда выражение не может вернуть значение

Пустое значение останавливает всё выражение. Это относится к любой стороне вычисления, сравнения размеров, проверки текстового префикса или логического `!`, `&&`, или `||`. В формуле и в Анализ данных пустое значение отображается как `null`.

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

## Что вы видите, когда выражение ничего не возвращает

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

| Где выполняется выражение                                  | Что происходит для этого пакета данных                                                                     |
| ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Формула** полю **Вычисление атрибута** узел              | У атрибута нет значения для этого пакета, и Анализ данных показывает его как `null`.                       |
| **Условное выражение (JEXL)** полю **IF/THEN Логика** узел | Данные выходят через соединение ELSE, а узел сохраняет свой атрибут как пустое значение, а не как `false`. |

{% hint style="warning" %}
Ничто не сообщает о сбое. В потоке не появляется ошибка, счётчик не меняется, а все остальные атрибуты по-прежнему вычисляются нормально. Единственный признак — само отсутствующее значение, поэтому поток может выглядеть исправным, хотя один атрибут неделями не возвращает значение.

Сохранение потока тоже не доказывает, что формула работает. Проверка, которая выполняется при сохранении, подтверждает только, что выражение записано правильно. Она не запускает выражение на данных вашего GPS-устройства, поэтому формула, которая ничего не возвращает для каждого пакета, всё равно сохраняется без предупреждения.
{% endhint %}

## Как каждый оператор обрабатывает пустое значение

Четыре оператора всегда продолжают работать с пустым значением: `==`, `!=`, `=~`, и `!~`. Операторы `&&` и `||` продолжают работать только тогда, когда сторона, считанная первой, сама определяет ответ. Все остальные операторы останавливаются.

Эта таблица охватывает атрибут, на который вы ссылаетесь по имени, то есть форму, которую [автозаполнение](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names) вставляет. Четыре оператора ведут себя иначе, когда значение поступает из `value()` вместо этого. См. [Чтение по имени или с помощью value()](#reading-by-name-or-with-value).

| Оператор                                                          | При пустом значении с любой стороны                                                                                     |
| ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `==`, `!=` (равно, не равно)                                      | Даёт истинный ответ «да» или «нет». `null == null` есть `true`, и `null != null` есть `false`.                          |
| `=~`, `!~` (входит в список или соответствует текстовому шаблону) | Даёт истинный ответ «да» или «нет». Пустое значение никогда не совпадает, поэтому `=~` даёт `false` и `!~` даёт `true`. |
| `??` (используйте запасное значение)                              | Даёт значение справа. Подставляет только вместо пустого значения.                                                       |
| `?:` (используйте запасное значение)                              | Даёт значение справа. Также подставляет вместо `false`, для `0`, а также для пустого текста.                            |
| `a ? b : c` (выбор между двумя значениями)                        | Берёт `c` ветвь, так же, как и для `false`.                                                                             |
| `=^`, `!^`, `=$`, `!$` (начинается с, заканчивается на)           | Выражение ничего не возвращает.                                                                                         |
| `<`, `<=`, `>`, `>=` (сравнения размеров)                         | Выражение ничего не возвращает.                                                                                         |
| `+`, `-`, `*`, `/`, `%` (арифметические операции)                 | Выражение ничего не возвращает.                                                                                         |
| `&`, `\|`, `^` (битовые операции)                                 | Выражение ничего не возвращает.                                                                                         |
| `!` (не)                                                          | Выражение ничего не возвращает.                                                                                         |
| `&&`, `\|\|` (и, или)                                             | Выражение ничего не возвращает, если только сторона, прочитанная первой, сама не определяет ответ.                      |

Шесть текстовых операторов делятся на две группы. `=~` и `!~` обрабатывают пустое значение, но `=^`, `!^`, `=$`, и `!$` не делают этого, когда атрибут указан по имени. Условие вроде `hardware_key !^ 'AB'` кажется безопасным способом исключить префикс, но ничего не возвращает для каждого пакета без `hardware_key`.

Этот `math:` функции ничего не возвращают, когда получают пустое значение, поэтому `math:round(engine_temp)` ничего не возвращает, когда `engine_temp` отсутствует. Эти `util:` функции более терпимы и вместо этого возвращают пустое значение, поэтому `util:join` и `util:joinNonNull` всё равно дают результат, когда один из их аргументов отсутствует. Объединение текста с `+` не терпит отсутствия аргументов: `'Zone: ' + zone_label` ничего не выводит.

## Логические операторы с пустым значением

Порядок важен для обоих `&&` и `||`. Каждый оператор сначала читает левую часть и останавливается на ней, когда левая часть уже определяет результат. А `false` левая часть определяет результат `&&`, а `true` левая часть определяет результат `||`.

| Выражение                 | Результат                                                                                                    |
| ------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `false && (пусто)`        | `false`. Ложная левая часть определяет результат операции И, поэтому правая часть никогда не вычисляется.    |
| `true && (пусто)`         | Ничего не возвращает.                                                                                        |
| `(пусто) && что угодно`   | Ничего не возвращает. Левая часть вычисляется первой.                                                        |
| `true \|\| (пусто)`       | `true`. Истинная левая часть определяет результат операции ИЛИ, поэтому правая часть никогда не вычисляется. |
| `ложь \|\| (пусто)`       | Ничего не возвращает.                                                                                        |
| `(пусто) \|\| что угодно` | Ничего не возвращает. Левая часть вычисляется первой.                                                        |

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

## Чтение по имени или с помощью value()

Четыре оператора дают разные результаты для одного и того же отсутствующего значения в зависимости от того, как формула его интерпретирует. Эти операторы: `=^`, `!^`, `=$` и `!$`, те, которые проверяют начало или конец текстового значения.

| Формула                                | Результат при `водитель_id` никогда не было отправлено |
| -------------------------------------- | ------------------------------------------------------ |
| `id_водителя !^ 'AB'`                  | Ничего не производит                                   |
| `value('driver_id', 0, 'all') !^ 'AB'` | `true`                                                 |

Указание атрибута по имени — это форма, при которой [автозаполнение](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names) вставки, поэтому условие, созданное с помощью выбора атрибутов, выбирает первый путь. Запишите сравнение с `value()` когда вам нужно `!^` или `!$` сообщать `true` в пакете, который не содержит атрибут.

Все остальные операторы ведут себя одинаково в обеих формах. Сравнение размеров, арифметика и `!` в любом случае все равно ничего не дают, и `==`, `!=`, `=~` и `!~` В любом случае все дают однозначный ответ «да» или «нет».

То же разбиение применяется к двум резервным формам. `??` и `? :` может содержать ошибочный расчёт, когда значение поступает из `value()`, и не может, если оно приходит из имени:

| Формула                                 | Результат при `одометр` никогда не было отправлено |
| --------------------------------------- | -------------------------------------------------- |
| `(одометр + 1) ?? 0`                    | Ничего не производит                               |
| `(value('одометр', 0, 'all') + 1) ?? 0` | `0`                                                |

Обычное `??` для имени по-прежнему работает, потому что до этого не выполняется вычисление. Только вычисление, заключённое внутри `??` или `? :` работает иначе.

## Явное сравнение значения

Чтобы сделать значение, которое может быть пустым, безопасным в условии, сравните его с `== true` или `== false` вместо того чтобы использовать его отдельно. Оба `==` и `!=` дают для пустого значения настоящий «да» или «нет», поэтому один операнд без данных больше не останавливает всё условие.

Это условие останавливается на любом пакете, где отсутствует один из двух атрибутов:

```jexl
door_open || hood_open
```

Это условие продолжает работать и возвращает да, когда открыта хотя бы одна дверь:

```jexl
door_open == true || hood_open == true
```

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

```jexl
leaveGeofence(51577 /* Austin Warehouse */) || leaveGeofence(85269 /* Construction site 1 */)
```

Это условие проверяет обе зоны в каждом пакете:

```jexl
leaveGeofence(51577 /* Склад в Остине */) == true || leaveGeofence(85269 /* Стройплощадка 1 */) == true
```

Выберите сравнение, которое соответствует тому, как следует считать пакет без данных:

* `== true` означает «известно, что да». Пустое значение дает `false`, поэтому пакет без данных не подходит.
* `== false` означает «известно, что нет». Пустое значение дает `false`, поэтому пакет без данных не подходит.
* `!= true` означает «неизвестно, что это да». Пустое значение дает `true`, так что пакет без данных действительно соответствует условию.

{% hint style="warning" %}
Не используйте `!` со значением, которое может быть пустым. `!inGeofence(35229)` ничего не дает, когда положение неизвестно, поэтому не может определить устройство вне зоны. Запишите `inGeofence(35229) == false` для «известно, что устройство вне зоны», или `inGeofence(35229) != true` для «неизвестно, находится ли внутри».
{% endhint %}

## Откуда берутся пустые значения

Атрибут в формуле принимает пустое значение в следующих случаях:

* Этот атрибут никогда не отправлялся для этого GPS-устройства.
* Текущий пакет не содержит атрибут, хотя в более раннем пакете он был.
* Историческая позиция, которую вы запросили с `value()` ещё не существует, потому что устройство отправило меньше пакетов, чем требует позиция.
* Устройство не отправляло ничего более 30 дней, поэтому Navixy удалил сохранённую историю. См. [Полный синтаксис](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#full-syntax).
* `inGeofence()`, `enterGeofence()`, или `leaveGeofence()` не может ответить, потому что пакет не содержит координат или Зона больше не существует в аккаунте. См. [Когда функция зоны не дает ответа](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/geofence-functions.md#when-a-geofence-function-gives-no-answer).
* `geofenceName()` не имеет имени, которое можно вернуть. См. [Что вы получите в ответ](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/geofence-functions.md#what-you-get-back).

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

## Формулы, которые всегда должны возвращать значение

Защитите расчет с помощью `!= null`, и сначала установите защиту. Защита использует `!=`, что даёт настоящий ответ «да» или «нет» для пустого значения, поэтому сама проверка никогда не останавливается:

```jexl
value('odometer', 0, 'all') != null && value('odometer', 0, 'all') > 100
```

Именно порядок обеспечивает работу проверки. Если поменять термины местами, сравнение выполнится до проверки, и всё условие ничего не вернёт.

Чтобы вместо этого подставить резервное значение, используйте `??`. Он возвращает правую сторону только тогда, когда левая сторона пуста:

```jexl
can_speed ?? 0
```

`??` подставляет значение вместо отсутствующего значения, а не вместо неудачного вычисления. `(can_speed * 1.1) ?? 0` ничего не возвращает, когда `can_speed` отсутствует, потому что умножение останавливается до `??` достижения. Поместите `??` скобки вокруг атрибута, а не вокруг вычисления:

```jexl
(can_speed ?? 0) * 1.1
```

{% hint style="warning" %}
`?:` и `??` выглядят похоже, но ведут себя по-разному. `??` подставляет правую часть только вместо пустого значения. `?:` подставляет его вместо пустого значения, а также для `false`, для `0`, а также для пустого текста. Формула `зажигание ?: true` следовательно, отчеты `true` когда зажигание действительно выключено. Используйте `??` когда вы имеете в виду «если значение отсутствует».
{% endhint %}

Вы также можете управлять запуском вычисления за пределами формулы. Разместите **IF/THEN Логика** узел перед **Вычисление атрибута** узлом и проверьте наличие атрибутов в его условии. Подключите ветвь THEN к вычисляющему узлу, чтобы он получал только пакеты, содержащие необходимые ему значения.

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

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

## Проверьте, не возвращает ли выражение ничего

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

1. Выберите поток, затем GPS-устройство и вычисляемый атрибут.
2. Отключите **Исключать null** переключатель. Неудачный расчёт отображается как `null` значение. Когда переключатель включён, он скрывает эти значения.
3. Увеличьте глубину, если пакет, который вы ищете, старше значений на экране.
4. Сравните атрибут с атрибутами, которые читает его формула. Пакет, в котором входные данные формулы имеют значения, а вычисляемый атрибут — `null` указывает на формулу.
5. Проверьте каждый оператор в формуле на соответствие [Как каждый оператор обрабатывает пустое значение](#how-each-operator-handles-an-empty-value).
6. Перепишите каждую часть, которая может быть пустой. Используйте `== true`, `== false`, или `??` резервный вариант.

{% hint style="warning" %}
Когда **Исключать null** включен, последнее значение, которое сформула вычислила, остаётся на экране со своей более ранней меткой времени. Показание выглядит актуальным, но относится к более раннему пакету. Отключите переключатель, прежде чем оценивать, продолжает ли IoT Logic вычислять атрибут.
{% endhint %}

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

#### Пустое значение — это то же самое, что и `false`?

Нет. Условие, которое действительно `false` сохраняет `false`, а условие, которое не удалось вычислить, сохраняет пустое значение. Оба передают данные через соединение ELSE узла **IF/THEN Логика** узел, так что одна ветка сама по себе не говорит вам, что произошло. Более позднее выражение, которое проверяет атрибут с `my_flag == false` совпадает только с первым случаем.

#### Почему одно GPS-устройство перестало соответствовать условию, которое всё ещё работает для остальных?

Устройства разных моделей не всегда отправляют одни и те же атрибуты, и одно устройство может перестать передавать атрибут, который другие по-прежнему отправляют. Тогда условие, которое читает этот атрибут без сравнения, не возвращает ничего только для этого устройства. Сравнивайте каждый термин явно с `== true` или `== false`.

## См. также

* [Выражения и синтаксис IF/THEN Логика](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/logic-node/logic-node-expressions-and-syntax.md#missing-values-and-null-routing) для того, какую ветку выбирает узел Logic и что он сохраняет.
* [Функции зон](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/geofence-functions.md) для случаев, когда функция Зона не может дать ответ.
* [Управление атрибутами](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#expression-language) для `value()` функции и двух вариантов синтаксиса.
* [Примеры вычислений](https://navixy.com/docs/user/ru/guide/account/iot-logic/nodes/initiate-attribute-node/calculation-examples.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/missing-values-in-expressions.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.
