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.
{
"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 ».
{
"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.