Werte-Karten-Objekt

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

Wertezuordnung

Das Objekt der Wertezuordnung hat die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
valuemapid ID ID der Wertezuordnung.

Verhalten der Eigenschaft:
- schreibgeschützt
- erforderlich für Aktualisierungsvorgänge
hostid ID ID des Hosts oder der Vorlage, zu dem bzw. zu der die Wertezuordnung gehört.

Verhalten der Eigenschaft:
- konstant
- erforderlich für Erstellungsvorgänge
name string Name der Wertezuordnung.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
mappings array Wertezuordnungen für die aktuelle Wertezuordnung. Das Zuordnungsobjekt wird weiter unten im Detail beschrieben.

Verhalten der Eigenschaft:
- 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.

Verhalten der Eigenschaft:
- unterstützt, wenn die Wertezuordnung zu einer Vorlage gehört

Wertezuordnungen

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

Eigenschaft Type Beschreibung
type integer Typ der Zuordnungsübereinstimmung.

Mögliche Werte:
0 - (Standard) die Zuordnung wird angewendet, wenn der Wert gleich ist;
1 - die Zuordnung wird angewendet, wenn der Wert größer oder gleich ist1;
2 - die Zuordnung wird angewendet, wenn der Wert kleiner oder gleich ist1;
3 - die Zuordnung wird angewendet, wenn der Wert im Bereich liegt (Bereiche sind inklusive; mehrere Bereiche, durch Komma getrennt, können definiert werden)1;
4 - die Zuordnung wird angewendet, wenn der Wert einem regulären Ausdruck entspricht2;
5 - wenn keine Übereinstimmungen gefunden werden, wird die Zuordnung nicht angewendet und der Standardwert verwendet.

Wenn type auf "0", "1", "2", "3", "4" gesetzt ist, darf value nicht leer sein.

Wenn type auf "5" gesetzt ist, muss value leer sein.
value string Ursprünglicher Wert.

Property behavior:
- erforderlich, wenn type auf "1", "2", "3", "4" gesetzt ist
- unterstützt, wenn type auf "5" gesetzt ist
newvalue string Wert, auf den der ursprüngliche Wert abgebildet wird.

Property behavior:
- erforderlich

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