[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:

|Parametr|<|Opis|
|-|----------|----------------------------------------|
|*Nazwa*|<|Unikalna nazwa zestawu mapowań wartości.|
|*Mapowania*|<|Poszczególne reguły mapowania wartości numerycznych/ciągów znaków na reprezentacje tekstowe.<br><br>Mapowanie jest stosowane zgodnie z kolejnością reguł, którą można zmieniać przez przeciąganie.|
| |*Typ*|Typ mapowania:<br>**równa się** - równe wartości zostaną zmapowane;<br>**jest większe lub równe** - równe lub większe wartości zostaną zmapowane;<br>**jest mniejsze lub równe** - równe lub mniejsze wartości zostaną zmapowane;<br>**w zakresie** - wartości z zakresu zostaną zmapowane; zakres jest wyrażany jako <number1>-<number2> lub <number>; obsługiwanych jest wiele zakresów (na przykład 1-10,101-110,201);<br>**regexp** - wartości odpowiadające [wyrażeniu regularnemu](/manual/regular_expressions) zostaną zmapowane (globalne wyrażenia regularne nie są obsługiwane);<br>**domyślne** - wszystkie pozostałe wartości zostaną zmapowane, inne niż te ze zdefiniowanymi mapowaniami.<br><br>W przypadku mapowania zakresów obsługiwane są tylko numeryczne typy wartości (*jest większe lub równe*, *jest mniejsze lub równe*, *w zakresie*).|
|^|*Wartość*|Wartość przychodząca (może zawierać zakres lub wyrażenie regularne, w zależności od typu mapowania).|
|^|*Mapowane na*|Reprezentacja tekstowa (do 64 znaków) dla wartości przychodzącej.|

Wszystkie obowiązkowe 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})
