[comment]: # ({2224a200-e8992262})
# 8 Mapatge de valors

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

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

Per a una representació més "humana" dels valors rebuts, podeu emprar taules de mapatge de valors que contenen la correspondència entre valors numèrics/cadenes i representacions de cadena.

Les taules de mapatge de valors es poden emprar tant a la interfície de Zabbix com a les notificacions per tipus de suport.

Per exemple, un element que tingui el valor "0" o "1" pot emprar el mapa de valors per representar valors en una forma llegible per els humans:

- '0' => 'No disponible'
- '1' => 'Disponible'

O bé, una taula d'assignació de valors relacionada amb la còpia de seguretat podria ésser:

- 'F' => 'Complet'
- 'D' => 'Diferencial'
- 'I' => 'Incremental'

En un altre exemple, es poden mapar intervals de valors de voltatge:

- '<=209' => 'Baixa'
- '210-230' => 'D'acord'
- '>=231' => 'Alta'

El mapatge de valors s'empra al tauler de Zabbix i notificacions enviades per els tipus de suport.

::: noteimportant
La substitució del valor rebut amb la representació configurada es realitza tant a la interfície com al servidor de Zabbix;
tanmateix, el servidor gestiona la substitució només en els casos següents:<br><br>

- en emplenar [inventari de l'equip](/manual/config/hosts/inventory#inventory-overview);
- en expandir [macros admeses](/manual/appendix/macros/supported_by_location) {ITEM.VALUE}, {ITEM.LASTVALUE}, {EVENT.OPDATA} i {EVENT.CAUSE.OPDATA}.
:::

Els mapes de valors es defineixen a nivell de model o equip. Un cop establerts, són disponibles per a tots els elements del model o equip respectiu.
Quan configureu [elements](/manual/config/items/item#configuration), especifiqueu el nom d'un mapatge de valors prèviament configurat al paràmetre *Mapatge de valors*.

:::noteclassic
No hi ha herència de mapa de valors - equips i plantilles no hereten els valors de mapatge de plantilles enllaçades.
Els elements de plantilla en un equip continuarà emprant mapatge de valors configurats a la plantilla.
:::

:::noteclassic
L'assignació de valors es pot emprar amb elements que tenen informació de tipus *Numèric (sense signe)*, *Numèric (flotant)* i *Caràcter*.
:::

Els mapes de valors es poden exportar/importar amb la plantilla o equip corresponent.
També es poden actualitzar en massa emprant els formularis d'actualització massiva d'[equips](/manual/config/hosts/hostupdate) i [plantilles](/manual/config/templates/mass).

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

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

Per definir un dels valors:

- Obriu un formulari de configuració d'equip o model
- Aneu a la pestanya *Taula de correspondència*
- Feu clic a *Afegeix* per afegir una taula nova
- Feu clic al nom d'una taula existent per modificar-la

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

Paràmetres d'una taula de mapeig de valors:

|Paràmetre|<|Descripció|
|-|-----------|-------------------------------------- ----|
|*Nom*|<|Nom únic d'un conjunt de coincidències de valors.|
|*Coincidències*|<|Regles de concordança individuals per assignar valors numèrics/cadenes a representacions de cadena.<br>El mapatge s'aplica en l'ordre de les regles de mapatge. Els mapes es poden reordenar arrossegant.<br>Només s'admeten els tipus de valors numèrics per als intervals de mapes (els tipus de mapes *és major o igual que*, *és menor o igual que*, *és dins l'interval*).|
| |*Tipus*|Tipus de mapeig:<br>**igual** - s'assignaran valors iguals<br>**és més gran o igual que** - s'assignaran valors iguals o superiors<br> **és menor o igual a** - es mapejaran valors iguals o menors<br>**es dins l'interval** - els valors dins l'interval s'assignaran; l'interval s'expressa com a <nombre1>-<nombre2> o <nombre>. S'admeten diversos intervals (p. ex., 1-10 101-110 201)<br>**expressió regular** - els valors que coincideixen amb [expressió regular](/manual/expressions_regulars) s'assignaran (no s'admeten expressions regulars)<br >* *per defecte** - tots els valors pendents s'assignaran, excepte els que tinguin mapes específics.|
|^|*Valor*|Valor entrant.<br>Depenent del tipus de mapatge, també pot contindre un interval o una expressió regular.|
|^|*Coincidències*|Representació de cadena (fins a 64 caracters) per al valor entrant.|

Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.

Quan la taula d'assignació de valors es mostra a la llista, només els tres primers mapes són visibles, mentre que tres punts indiquen que hi ha altres mapes.

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

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

[comment]: # ({74c7cb6d-6241051d})
#### Exemple de mapatge de valors

Un dels elements d'agent predefinits "Ping de l'agent Zabbix" empra una taula de mapatge de valors a nivell de model anomenada "Estat de ping de l'agent Zabbix" per mostrar els seus valors.

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

Al [formulari de configuració de l'element](element), podeu veure una referència a aquesta taula de mapatge de valors al camp *Taula de mapatge*:

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

Així, a *Monitoratge → #Darreres dades*, la taula de cerca s'empra per mostrar "Amunt" (amb el valor brut entre parèntesis).

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

::: noteclassic
A la secció *Darreres dades*, els valors mostrats es redueixen a 20 símbols.
Si s'empra la taula d'assignació de valors, aquest escurçament no s'aplica al valor assignat, sinó només al valor brut (que es mostra entre parèntesis).
:::

Sense una taula de mapatge de valors predefinida, només veureu "1", que pot ésser difícil d'entendre.

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

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