template.massadd

Description

object template.massadd(object parameters)

Cette méthode permet d’ajouter simultanément plusieurs objets liés aux modèles donnés.

Cette méthode n’est disponible que pour les types d’utilisateur Admin et Super admin. Les autorisations d’appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir User roles pour plus d’informations.

Paramètres

(object) Paramètres contenant les ID des modèles à mettre à jour et les objets à ajouter aux modèles.

La méthode accepte les paramètres suivants.

Paramètre Type Description
templates object/array Modèles à mettre à jour.

Les modèles doivent avoir uniquement la propriété templateid définie.

Comportement des paramètres :
- obligatoire
groups object/array Groupes de modèles à ajouter aux modèles donnés.

Les groupes de modèles doivent avoir uniquement la propriété groupid définie.
macros object/array Macros utilisateur à créer pour les modèles donnés.
templates_link object/array Modèles à lier aux modèles donnés.

Les modèles doivent avoir uniquement la propriété templateid définie.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des modèles mis à jour sous la propriété templateids.

Exemples

Lier un groupe à des modèles

Ajouter le groupe de modèles « 2 » à deux modèles.

Requête:

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

Réponse :

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

Lier deux modèles à un modèle

Liez les modèles « 10106 » et « 10104 » au modèle « 10073 ».

Requête:

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

Réponse :

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

Voir aussi

Source

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