[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({ee2c7113-41154bde})
# Oggetto mappa dei valori

I seguenti oggetti sono direttamente correlati all'API `valuemap`.

[comment]: # ({/ee2c7113-41154bde})

[comment]: # ({aec7b0d0-65471f47})
### Mappa dei valori

L'oggetto mappa dei valori ha le seguenti proprietà.

|Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|valuemapid|ID|ID della mappa dei valori.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*<br>- *obbligatoria* per le operazioni di aggiornamento|
|hostid|ID|ID dell'host o del template a cui appartiene la mappa dei valori.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *costante*<br>- *obbligatoria* per le operazioni di creazione|
|name|string|Nome della mappa dei valori.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione|
|mappings|array|Mappature dei valori per la mappa dei valori corrente. L'oggetto mapping è [descritto in dettaglio di seguito](object#value-mappings).<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione|
|uuid|string|Identificatore univoco universale, utilizzato per collegare le mappe dei valori importate a quelle già esistenti. Generato automaticamente, se non specificato.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportato* se la mappa dei valori appartiene a un template|

[comment]: # ({/aec7b0d0-65471f47})

[comment]: # ({5ff6d41b-145a9918})
#### Mappature dei valori

L'oggetto delle mappature dei valori definisce le mappature dei valori della mappa dei valori. Ha le seguenti proprietà.

|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|type|integer|Tipo di corrispondenza della mappatura.<br><br>Valori possibili:<br>0 - *(predefinito)* la mappatura verrà applicata se il valore è uguale;<br>1 - la mappatura verrà applicata se il valore è maggiore o uguale^1^;<br>2 - la mappatura verrà applicata se il valore è minore o uguale^1^;<br>3 - la mappatura verrà applicata se il valore rientra in un intervallo (gli intervalli sono inclusivi; è possibile definire più intervalli, separati da una virgola)^1^;<br>4 - la mappatura verrà applicata se il valore corrisponde a un'espressione regolare^2^;<br>5 - se non viene trovata alcuna corrispondenza, la mappatura non verrà applicata e verrà utilizzato il valore predefinito.<br><br>Se `type` è impostato su "0", "1", "2", "3", "4", allora `value` non può essere vuoto.<br><br>Se `type` è impostato su "5", allora `value` deve essere vuoto.|
|value|string|Valore originale.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio* se `type` è impostato su "1", "2", "3", "4"<br>- *supportato* se `type` è impostato su "5"|
|newvalue|string|Valore a cui viene mappato il valore originale.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio*|

^1^ supportato solo per gli item con tipo di valore "numeric unsigned", "numeric float".<br>
^2^ supportato solo per gli item con tipo di valore "character".<br>

[comment]: # ({/5ff6d41b-145a9918})