valuemap.update

Beschreibung

object valuemap.update(object/array valuemaps)

Mit dieser Methode können vorhandene Wertezuordnungen aktualisiert werden.

Diese Methode ist nur für den Benutzertyp Super admin verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object/array) Zu aktualisierende Eigenschaften der Wertezuordnung.

Die Eigenschaft valuemapid muss für jede Wertezuordnung definiert sein, alle anderen Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden aktualisiert, alle anderen bleiben unverändert.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Wertezuordnungen in der Eigenschaft valuemapids enthält.

Beispiele

Namen der Wertezuordnung ändern

Ändern Sie den Namen der Wertezuordnung in „Device status“.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "valuemap.update",
    "params": {
        "valuemapid": "2",
        "name": "Device status"
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "valuemapids": [
            "2"
        ]
    },
    "id": 1
}

Zuordnungen für eine Wertzuordnung ändern.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "valuemap.update",
    "params": {
        "valuemapid": "2",
        "mappings": [
            {
                "type": "0",
                "value": "0",
                "newvalue": "Online"
            },
            {
                "type": "0",
                "value": "1",
                "newvalue": "Offline"
            }
        ]
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "valuemapids": [
            "2"
        ]
    },
    "id": 1
}

Quelle

CValueMap::update() in ui/include/classes/api/services/CValueMap.php.