template.massadd

説明

object template.massadd(object parameters)

このメソッドは、指定したテンプレートに複数の関連オブジェクトを同時に追加することができます。

このメソッドは 管理者 および スーパ管理者 ユーザータイプでのみ利用可能です。メソッドの呼び出し権限はユーザーロールの設定で取り消すことができます。詳細はユーザーロールを参照してください。

パラメーター

(object) 更新するテンプレートのIDとテンプレートに追加するオブジェクトを含むパラメーター。

このメソッドは以下のパラメーターを受け付けます。

パラメーター タイプ 説明
templates object/array 更新するテンプレート。

テンプレートにはtemplateidプロパティのみを定義する必要があります。

パラメーターの動作:
- 必須
groups object/array 指定したテンプレートを追加するテンプレートグループ。

テンプレートグループにはgroupidプロパティのみを定義する必要があります。
macros object/array 指定したテンプレートに作成するユーザーマクロ。
templates_link object/array 指定したテンプレートにリンクするテンプレート。

テンプレートにはtemplateidプロパティのみを定義する必要があります。

戻り値

(object) templateids プロパティの下で更新されたテンプレートの ID を含むオブジェクトを返します。

例

テンプレートにグループをリンクする

テンプレートグループ "2" を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
}

2つのテンプレートを1つのテンプレートにリンクする

テンプレート"10106"と"10104"をテンプレート"10073"にリンクします。

リクエスト:

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

Response:

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

関連項目

ソース

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