screenitem.updatebyposition

Описание

объект screenitem.updatebyposition(массив ЭлементыКомплексногоЭкрана)

Этот метод позволяет обновлять элементы комплексного экрана в заданных ячейках комплексного экрана. Если ячейка пустая, будет создан новый элемент комплексного экрана.

Параметры

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

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

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

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

Примеры

Изменение ID ресурса элемента комплексного экрана

Изменение ID ресурса элемента комплексного экрана, который расположен в левой верхней ячейке комплексного экрана.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "screenitem.updatebyposition",
           "params": [
               {
                   "screenid": "16",
                   "x": 0,
                   "y": 0,
                   "resourceid": "644"
               }
           ],
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "screenitemids": [
                   "66"
               ]
           },
           "id": 1
       }

Смотрите также

Исходный код

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