valuemap.update

説明

object valuemap.update(object/array valuemaps)

このメソッドは、既存の値のマッピングを更新するためのものです。

このメソッドはスーパ管理者ユーザータイプでのみ利用可能です。 このメソッドを呼び出す権限は、ユーザーロールの設定で取り消すことができます。詳細はユーザーロールをご覧ください。

パラメータ

(object/array) バリューマップのプロパティ が更新されます。

valuemapidプロパティは、バリューマップごとに設定する必要があります。すべてのプロパティはオプションです。 渡されたプロパティのみが更新され、他のプロパティは変更されません。

戻り値

(object) valuemapidsプロパティの下にある更新されたバリューマップのIDを含むオブジェクトを返します。

値のマップ名の変更

値のマップ名を「Device status」に変更します。

リクエスト:

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

レスポンス:

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

1つの値のマッピングを変更する。

リクエスト:

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

レスポンス:

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

ソース

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