template.massadd

Описание

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

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

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

Параметры

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

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

Parameter Type Description
templates object/array Шаблоны, которые нужно обновить.

Шаблоны должны содержать только свойство templateid.

Поведение параметра:
- required
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.