template.massadd

Description

object template.massadd(object parameters)

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

Cette méthode est disponible uniquement 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 des rôles utilisateur. Voir Rôles utilisateur pour plus d'informations.

Paramètres

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

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.