批量添加

描述

object template.massadd(object parameters)

该方法允许同时将多个相关对象添加到给定的模板中。

这个方法只有 管理员超级管理员 两个用户类型可用。可以在用户角色设置中撤销调用该方法的权限。 查看 User roles获取更多信息。

参数

(object) 参数包含要更新的模板的ID以及要添加到模板中的对象。

这个方法接受下列参数。

参数类型描述
templatesobject/array要更新的模版

这些模板必须只定义了 templateid 属性。

参数行为:
- 必需
groupsobject/array将给定的模版添加到模版组

这些模板必须只定义了 groupid 属性。
macrosobject/array要为给定模板创建的用户宏
templates_linkobject/array要链接到给定模版的模版

这些模板必须只定义了 templateid 属性。

返回值

(object) 返回一个对象,该对象包含templateids属性下已更新模板的ID。

示例

将一个模板组链接到模板

将模板组 “2” 添加到两个模板中。

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "template.massadd",
  4. "params": {
  5. "templates": [
  6. {
  7. "templateid": "10085"
  8. },
  9. {
  10. "templateid": "10086"
  11. }
  12. ],
  13. "groups": [
  14. {
  15. "groupid": "2"
  16. }
  17. ]
  18. },
  19. "id": 1
  20. }

响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "templateids": [
  5. "10085",
  6. "10086"
  7. ]
  8. },
  9. "id": 1
  10. }

将两个模板链接到一个模板

将模板 “10106” 和 “10104” 链接到模板 “10073”。

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "template.massadd",
  4. "params": {
  5. "templates": [
  6. {
  7. "templateid": "10073"
  8. }
  9. ],
  10. "templates_link": [
  11. {
  12. "templateid": "10106"
  13. },
  14. {
  15. "templateid": "10104"
  16. }
  17. ]
  18. },
  19. "id": 1
  20. }

响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "templateids": [
  5. "10073"
  6. ]
  7. },
  8. "id": 1
  9. }

参阅

来源

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