[comment]: # ({2224a200-e8992262})
# 8 Mapowanie wartości

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

[comment]: # ({cb8222c8-2d2da55e})
#### Przegląd

Mapowanie wartości umożliwia skonfigurowanie bardziej przyjaznej dla użytkownika reprezentacji otrzymanych wartości przy użyciu mapowań między wartościami numerycznymi/tekstowymi a ich reprezentacjami tekstowymi.

Na przykład, gdy wartość pozycji to „0” lub „1”, mapowania wartości mogą zostać użyte do przedstawienia tych wartości w bardziej przyjazny dla użytkownika sposób:

-   0 → Niedostępne
-   1 → Dostępne

Mapowania wartości dla typów kopii zapasowych danych mogą zostać skonfigurowane następująco:

-   F → Pełna
-   D → Różnicowa
-   I → Przyrostowa

Zakresy wartości dla napięcia mogą zostać skonfigurowane następująco:

-   \<=209 → Niskie
-   210-230 → OK
-   \>=231 → Wysokie

Mapowanie wartości jest używane w frontendzie Zabbix oraz w powiadomieniach wysyłanych przez typy mediów.

::: noteimportant
Podstawienie otrzymanej wartości skonfigurowaną reprezentacją jest wykonywane zarówno w frontendzie Zabbix, jak i na serwerze;
jednak serwer obsługuje podstawienie tylko w następujących przypadkach:<br><br>

- podczas wypełniania [inwentarza hosta](/manual/config/hosts/inventory#inventory-overview);
- podczas rozwijania [obsługiwanych makr](/manual/appendix/macros/supported_by_location) {ITEM.VALUE}, {ITEM.LASTVALUE}, {EVENT.OPDATA} oraz {EVENT.CAUSE.OPDATA}.
:::

Mapowania wartości są konfigurowane w szablonach lub hostach.
Po skonfigurowaniu są dostępne dla wszystkich pozycji w odpowiednim szablonie lub hoście.
Podczas [konfigurowania pozycji](/manual/config/items/item#configuration) należy podać nazwę wcześniej skonfigurowanego mapowania wartości w parametrze *Mapowanie wartości*.

::: noteclassic
Nie ma dziedziczenia mapowań wartości — hosty i szablony nie dziedziczą mapowań wartości z podłączonych szablonów.
Pozycje szablonu na hoście będą nadal używać mapowań wartości skonfigurowanych w szablonie.
:::

::: noteclassic
Mapowania wartości mogą być używane z pozycjami mającymi typ informacji *Numeric (unsigned)*, *Numeric (float)* oraz *Character*.
:::

Mapowania wartości są eksportowane/importowane wraz z odpowiednim szablonem lub hostem.
Mogą również być masowo aktualizowane przy użyciu formularzy masowej aktualizacji [hosta](/manual/config/hosts/hostupdate) i [szablonu](/manual/config/templates/mass).

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

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

Aby skonfigurować mapowanie wartości, wykonaj następujące kroki:

1\. Otwórz formularz konfiguracji hosta lub szablonu.

2\. Na karcie *Mapowanie wartości* kliknij *Dodaj*, aby dodać nowe mapowanie wartości, lub kliknij nazwę istniejącego mapowania, aby je edytować.

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

Parametry mapowania wartości:

|Parameter|<|Description|
|-|----------|----------------------------------------|
|*Name*|<|Unikalna nazwa zestawu mapowań wartości.|
|*Mappings*|<|Poszczególne reguły mapowania wartości liczbowych/łańcuchowych na reprezentacje tekstowe.<br><br>Mapowanie jest stosowane w kolejności reguł, które można zmieniać metodą przeciągnij i upuść.|
| |*Type*|Typ mapowania:<br>**equals** - wartości równe będą mapowane;<br>**is greater than or equals** - wartości równe lub większe będą mapowane;<br>**is less than or equals** - wartości równe lub mniejsze będą mapowane;<br>**in range** - wartości z zakresu będą mapowane; zakres jest wyrażony jako <number1>-<number2> lub <number>; obsługiwane są wiele zakresów (na przykład 1-10,101-110,201);<br>**regexp** - wartości odpowiadające [wyrażeniu regularnemu](/manual/regular_expressions) będą mapowane (globalne wyrażenia regularne nie są obsługiwane);<br>**default** - wszystkie pozostałe wartości zostaną zmapowane, inne niż te z określonym mapowaniem.<br><br>W przypadku mapowania zakresów obsługiwane są tylko typy wartości numerycznych (*is greater than or equals*, *is less than or equals*, *in range*).|
|^|*Value*|Wartość wejściowa (może zawierać zakres lub wyrażenie regularne, zależnie od typu mapowania).|
|^|*Mapped to*|Reprezentacja tekstowa (do 64 znaków) dla wartości wejściowej.|

Wszystkie wymagane pola wejściowe są oznaczone czerwoną gwiazdką.

Podczas wyświetlania mapowania wartości na liście widoczne są tylko pierwsze trzy mapowania, a trzy kropki wskazują, że istnieją kolejne mapowania.

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

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

[comment]: # ({74c7cb6d-6241051d})
#### Przykład mapowania wartości

Jedna ze wstępnie zdefiniowanych pozycji agenta, *Zabbix agent ping*, używa mapowania wartości na poziomie szablonu „Zabbix agent ping status” do wyświetlania swoich wartości.

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

W [formularzu konfiguracji](/manual/config/items/item#configuration) pozycji można znaleźć odwołanie do tego mapowania wartości w polu *Mapowanie wartości*:

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

To mapowanie jest używane w sekcji *Monitoring* → *Najnowsze dane* do wyświetlania „Up” (z surową wartością w nawiasach).

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

::: noteclassic
W sekcji *Najnowsze dane* wyświetlane wartości są skracane do 20 znaków.
Jeśli używane jest mapowanie wartości, to skrócenie nie jest stosowane do zmapowanej wartości, lecz tylko do surowej wartości (wyświetlanej w nawiasach).
:::

Bez wstępnie zdefiniowanego mapowania wartości widoczne byłoby tylko „1”, co mogłoby być trudne do zrozumienia.

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

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