Sidebar

ru:manual:api:reference:valuemap:update

valuemap.update

Описание

объект valuemap.update(объект/массив преобразованиязначений)

Этот метод позволяет обновлять существующие преобразования значений.

Параметры

(объект/массив) Свойства преобразования значений, которые будут обновлены.

Свойство valuemapid должно быть указано по каждому преобразованию значений, все остальные свойства опциональны. Будут обновлены только переданные свойства, все остальные останутся неизменными.

Возвращаемые значения

(объект) Возвращает объект, который содержит ID обновленных преобразований значений под свойством valuemapids.

Примеры

Изменение имени преобразования значений

Изменение имени преобразования значений на “Device status”.

Запрос:

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

Ответ:

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

Изменение соответствий значений в одном преобразовании значений

Запрос:

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

Ответ:

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

Исходный код

CValueMap::update() в frontends/php/include/classes/api/services/CValueMap.php.