Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

valuemap.update

Описание

object valuemap.update(объект/массив valuemaps)

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

Этот метод доступен только пользователю с типом доступа Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

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

Свойство 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": [
                   {
                       "type": "0",
                       "value": "0",
                       "newvalue": "Online"
                   },
                   {
                       "type": "0",
                       "value": "1",
                       "newvalue": "Offline"
                   }
               ]
           },
           "auth": "57562fd409b3b3b9a4d916d45207bbcb",
           "id": 1
       }

Ответ:

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

Источник

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