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

triggerprototype.update

Описание

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

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

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

Параметры

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

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

В дополнение к стандартным свойствам прототипа триггеров, этот метод принимает следующие параметры.

Параметр Тип Описание
dependencies массив Триггеры и прототипы триггеров, от которых обновляемый прототип триггеров зависит.

У триггеров должно быть задано свойство triggerid.
tags массив Теги прототипа триггеров.

Выражение триггера необходимо указывать в раскрытой форме и оно должно содержать по крайней мере один прототип элементов данных.

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

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

Примеры

Активация прототипа триггеров

Активация прототипа триггеров, то есть изменение его состояния на значение "0".

Запрос:

{
           "jsonrpc": "2.0",
           "method": "triggerprototype.update",
           "params": {
               "triggerid": "13938",
               "status": 0
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "triggerids": [
                   "13938"
               ]
           },
           "id": 1
       }

Замена тегов у прототипа триггеров

Замена тегов у одного прототипа триггеров.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "triggerprototype.update",
           "params": {
               "triggerid": "17373",
               "tags": [
                   {
                       "tag": "volume",
                       "value": "{#FSNAME}"
                   },
                   {
                       "tag": "type",
                       "value": "{#FSTYPE}"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "triggerids": [
                   "17373"
               ]
           },
           "id": 1
       }

Источник

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