[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({ee2c7113-41154bde})
# Objet de correspondance de valeurs

Les objets suivants sont directement liés à l'API `valuemap`.

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

[comment]: # ({aec7b0d0-65471f47})
### Correspondance de valeurs

L'objet de correspondance de valeurs possède les propriétés suivantes.

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|valuemapid|ID|ID de la correspondance de valeurs.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*<br>- *requis* pour les opérations de mise à jour|
|hostid|ID|ID de l'hôte ou du modèle auquel appartient la correspondance de valeurs.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *requis* pour les opérations de création|
|name|string|Nom de la correspondance de valeurs.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *requis* pour les opérations de création|
|mappings|array|Correspondances de valeurs pour la correspondance de valeurs actuelle. L'objet de correspondance est [décrit en détail ci-dessous](object#value-mappings).<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *requis* pour les opérations de création|
|uuid|string|Identifiant unique universel, utilisé pour lier les correspondances de valeurs importées à celles qui existent déjà. Généré automatiquement s'il n'est pas fourni.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *pris en charge* si la correspondance de valeurs appartient à un modèle|

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

[comment]: # ({5ff6d41b-145a9918})
#### Correspondances de valeurs

L'objet de correspondances de valeurs définit les correspondances de valeurs de la table de correspondance des valeurs. Il possède les propriétés suivantes.

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|type|integer|Type de correspondance.<br><br>Valeurs possibles :<br>0 - *(par défaut)* la correspondance sera appliquée si la valeur est égale ;<br>1 - la correspondance sera appliquée si la valeur est supérieure ou égale^1^ ;<br>2 - la correspondance sera appliquée si la valeur est inférieure ou égale^1^ ;<br>3 - la correspondance sera appliquée si la valeur est dans une plage (les plages sont inclusives ; plusieurs plages, séparées par une virgule, peuvent être définies)^1^ ;<br>4 - la correspondance sera appliquée si la valeur correspond à une expression régulière^2^ ;<br>5 - si aucune correspondance n'est trouvée, la correspondance ne sera pas appliquée et la valeur par défaut sera utilisée.<br><br>Si `type` est défini sur "0", "1", "2", "3", "4", alors `value` ne peut pas être vide.<br><br>Si `type` est défini sur "5", alors `value` doit être vide.|
|value|string|Valeur d'origine.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire* si `type` est défini sur "1", "2", "3", "4"<br>- *pris en charge* si `type` est défini sur "5"|
|newvalue|string|Valeur vers laquelle la valeur d'origine est mappée.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire*|

^1^ pris en charge uniquement pour les éléments ayant le type de valeur "numeric unsigned", "numeric float".<br>
^2^ pris en charge uniquement pour les éléments ayant le type de valeur "character".<br>

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