[comment]: # translation:outdated

[comment]: # ({2224a200-e8992262})
# 8. Преобразование значений

[comment]: # ({/2224a200-e8992262})

[comment]: # ({cb8222c8-2d2da55e})
#### Обзор

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

Например, элемент данных, который имеет значения «0» или «1», может использовать преобразование значений для представления этих значений в более читабельном виде:

-   0 → Недоступен
-   1 → Доступен

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

-   F → Полный
-   D → Дифференциальный
-   I → Инкрементный

Диапазоны значений напряжения можно отображать так:

-   \<=209 → Низкое
-   210-230 → ОК
-   \>=231 → Высокое

Преобразования значений используются в веб-интерфейсе Zabbix и в оповещениях, отсылаемых по каналам оповещений.

::: noteimportant
Подстановка полученного значения его настроенным представлением выполняется как веб-интерфейсом Zabbix, так и сервером;
однако, сервер обрабатывает подстановки только в следующих случаях:<br><br>

- при заполнении [инвентарных данных узла сети](/manual/config/hosts/inventory#просмотр-инвентарных-данных);
- при раскрытии [поддерживаемых макросов](/manual/appendix/macros/supported_by_location) {ITEM.VALUE}, {ITEM.LASTVALUE}, {EVENT.OPDATA} и {EVENT.CAUSE.OPDATA}.
:::

Преобразования значений настраиваются на уровне шаблонов или узлов сети. Сразу после добавления, эти преобразования значений становятся доступными для всех элементов данных соответствующего шаблона или узла сети. 
При [настройке элементов данных](/manual/config/items/item#настройка) выберите в параметре *Преобразование значений (Value mapping)* имя ранее добавленного преобразования значений.

::: noteclassic
Наследование преобразований значений отсутствует — узлы сети и шаблоны не наследуют преобразования значений от присоединённых шаблонов.
Элементы данных шаблона на узле сети продолжат использовать преобразования значений, настроенные в своём шаблоне.
:::

::: noteclassic
Преобразования значений можно использовать с элементами данных, которые имеют типы информации *Числовой (целое положительное)*, *Числовой (с плавающей точкой)* и *Символ*.
:::

Преобразования значений экспортируются/импортируются вместе с соответствующим шаблоном или узлом сети.
Их можно обновлять массово, используя диалоги массового обновления [узла сети](/manual/config/hosts/hostupdate) и [шаблона](/manual/config/templates/mass).

[comment]: # ({/cb8222c8-2d2da55e})

[comment]: # ({158cd610-18d7ef55})
#### Настройка

Для того чтобы настроить преобразование значений:

1\. Откройте диалог настройки узла сети или шаблона.
2\. На вкладке *Преобразование значений (Value mapping)* нажмите на *Добавить (Add)*, чтобы добавить новое преобразование, или нажмите на имя существующего преобразования, чтобы его модифицировать.

![](../../../../assets/en/manual/config/items/value_mapping.png)

Параметры преобразования значений:

|Параметр|<|Описание|
|-|----------|----------------------------------------|
|*Имя (Name)*|<|Уникальное имя набора преобразований значений.|
|*Преобразования*<br>*(Mappings)*|<|Отдельные правила преобразования для преобразования числовых/строковых значений в строковые представления.<br><br>Сопоставление применяется в соответствии с порядком правил преобразования, которые можно переупорядочить перетаскиванием.|
| |*Тип*<br>*(Type)*|Тип преобразования:<br>**равно** — будут преобразованы совпадающие значения<br>**больше чем или равно** — будут преобразованы равные или большие значения<br>**меньше чем или равно** — будут преобразованы равные или меньшие значения<br>**в диапазоне** — будут преобразованы значения в диапазоне; диапазон указывается в виде <число1>-<число2>, или <число>; поддерживаются несколько диапазонов (например: 1-10,101-110,201);<br>**регулярное выражение** — будут преобразованы значения, соответствующие [регулярному выражению](/manual/regular_expressions) (глобальные регулярные выражения не поддерживаются)<br>**по умолчанию** — будут преобразованы все оставшиеся значения, кроме тех, у которых имеются заданные преобразования.<br><br>В преобразованиях с учётом диапазона поддерживаются только числовые типы данных (типы преобразований *больше чем или равно*, *меньше чем или равно*, *в диапазоне*).|
|^|*Значение*<br>*(Value)*|Входящее значение (в зависимости от типа преобразования, может также содержать диапазон или регулярное выражение).|
|^|*Преобразование в*<br>*(Mapped to)*|Строковое представление (до 64 символов) для входящего значения.|

Все обязательные поля ввода отмечены красной звёздочкой.

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

![](../../../../assets/en/manual/config/items/value_map_list.png)

[comment]: # ({/158cd610-18d7ef55})

[comment]: # ({74c7cb6d-6241051d})
#### Пример преобразования значений

Один из предустановленных агентских элементов данных *Zabbix agent ping* для отображения своих значений использует существующее преобразование значений уровня шаблона, именуемое «Zabbix agent ping status».

![](../../../../assets/en/manual/config/items/value_mapping2.png)

В [диалоге настройки](/manual/config/items/item#настройка) элемента данных вы можете увидеть ссылку на это преобразование значений в поле *Преобразование значений (Value mapping)*:

![](../../../../assets/en/manual/config/items/item_value_mapping.png)

В разделе *Мониторинг* → *Последние данные* (*Monitoring* → *Latest data*) это преобразование используется, чтобы отобразить «Up» (вместе с исходным значением в скобках).

![](../../../../assets/en/manual/config/items/value_display.png){width="600"}

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

Без предустановленного преобразования значений вы могли бы увидеть только «1», что может быть неочевидным для понимания.

![](../../../../assets/en/manual/config/items/value_display2.png){width="600"}

[comment]: # ({/74c7cb6d-6241051d})
