template.massadd

Описание

object template.massadd(параметры объекта)

Этот метод позволяет одновременно добавить несколько связанных объектов к указанным шаблонам.

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

Параметры

(object) Параметры, содержащие идентификаторы шаблонов для обновления и объекты для добавления в шаблоны.

Метод принимает следующие параметры.

Параметр Type Описание
templates object/array Шаблоны, которые необходимо обновить.

Для шаблонов должно быть определено только свойство templateid.

Поведение параметра:
- обязательный
groups object/array Группы шаблонов, в которые необходимо добавить указанные шаблоны.

Для групп шаблонов должно быть определено только свойство groupid.
macros object/array Пользовательские макросы, которые необходимо создать для указанных шаблонов.
templates_link object/array Шаблоны, которые необходимо связать с указанными шаблонами.

Для шаблонов должно быть определено только свойство templateid.

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

(объект) Возвращает объект, который содержит ID обновленных шаблонов, указанных в свойстве templateids.

Примеры

Привязка группы к шаблонам

Добавьте группу шаблонов "2" к двум шаблонам.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "template.massadd",
    "params": {
        "templates": [
            {
                "templateid": "10085"
            },
            {
                "templateid": "10086"
            }
        ],
        "groups": [
            {
                "groupid": "2"
            }
        ]
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10085",
            "10086"
        ]
    },
    "id": 1
}

Привязка двух шаблонов к шаблону

Привяжите шаблоны "10106" и "10104" к шаблону "10073".

Запрос:

{
    "jsonrpc": "2.0",
    "method": "template.massadd",
    "params": {
        "templates": [
            {
                "templateid": "10073"
            }
        ],
        "templates_link": [
            {
                "templateid": "10106"
            },
            {
                "templateid": "10104"
            }
        ]
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10073"
        ]
    },
    "id": 1
}

См. также

Источник

CTemplate::massAdd() в ui/include/classes/api/services/CTemplate.php.