[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({ee2c7113-41154bde})
# Werte-Karten-Objekt

Die folgenden Objekte stehen in direktem Zusammenhang mit der `valuemap` API.

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

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

Das Objekt der Wertezuordnung hat die folgenden Eigenschaften.

|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|valuemapid|ID|ID der Wertezuordnung.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*<br>- *erforderlich* für Aktualisierungsvorgänge|
|hostid|ID|ID des Hosts oder der Vorlage, zu dem bzw. zu der die Wertezuordnung gehört.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *konstant*<br>- *erforderlich* für Erstellungsvorgänge|
|name|string|Name der Wertezuordnung.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsvorgänge|
|mappings|array|Wertezuordnungen für die aktuelle Wertezuordnung. Das Zuordnungsobjekt wird [weiter unten im Detail beschrieben](object#value-mappings).<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsvorgänge|
|uuid|string|Universell eindeutige Kennung, die verwendet wird, um importierte Wertezuordnungen mit bereits vorhandenen zu verknüpfen. Wird automatisch generiert, wenn sie nicht angegeben wird.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn die Wertezuordnung zu einer Vorlage gehört|

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

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

Das Objekt für Wertezuordnungen definiert Wertezuordnungen der Wertetabelle. Es
hat die folgenden Eigenschaften.

|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|type|integer|Typ der Zuordnungsübereinstimmung.<br><br>Mögliche Werte:<br>0 - *(Standard)* die Zuordnung wird angewendet, wenn der Wert gleich ist;<br>1 - die Zuordnung wird angewendet, wenn der Wert größer oder gleich ist^1^;<br>2 - die Zuordnung wird angewendet, wenn der Wert kleiner oder gleich ist^1^;<br>3 - die Zuordnung wird angewendet, wenn der Wert im Bereich liegt (Bereiche sind inklusive; mehrere Bereiche, durch Komma getrennt, können definiert werden)^1^;<br>4 - die Zuordnung wird angewendet, wenn der Wert einem regulären Ausdruck entspricht^2^;<br>5 - wenn keine Übereinstimmungen gefunden werden, wird die Zuordnung nicht angewendet und der Standardwert verwendet.<br><br>Wenn `type` auf "0", "1", "2", "3", "4" gesetzt ist, darf `value` nicht leer sein.<br><br>Wenn `type` auf "5" gesetzt ist, muss `value` leer sein.|
|value|string|Ursprünglicher Wert.<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `type` auf "1", "2", "3", "4" gesetzt ist<br>- *unterstützt*, wenn `type` auf "5" gesetzt ist|
|newvalue|string|Wert, dem der ursprüngliche Wert zugeordnet wird.<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|

^1^ nur für Datenpunkte mit dem Werttyp "numeric unsigned", "numeric float" unterstützt.<br>
^2^ nur für Datenpunkte mit dem Werttyp "character" unterstützt.<br>

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