[comment]: # ({adaceae4-e8fbaf7c})
# 3 テンプレート

[comment]: # ({/adaceae4-e8fbaf7c})

[comment]: # ({8456e9da-02fec82c})
#### 概要

テンプレートは、多くの関連オブジェクトやオブジェクトの関係とともに[エクスポート](/manual/xml_export_import)されます。

テンプレートのエクスポートには以下が含まれます:

- リンクされたテンプレートグループ
- （[ホストプロトタイプ](/manual/discovery/low_level_discovery/host_prototypes)の設定で使用されている場合）リンクされたホストグループ
- テンプレートデータ
- 他のテンプレートへのリンク
- テンプレートグループへのリンク
- 直接リンクされたアイテム
- 直接リンクされたトリガー
- 直接リンクされたグラフ
- 直接リンクされたダッシュボード
- すべてのプロトタイプを含む直接リンクされたディスカバリルール
- 直接リンクされたWebシナリオ
- 値のマッピング

[comment]: # ({/8456e9da-02fec82c})

[comment]: # ({9a909adc-ca3e35f8})
#### エクスポート

テンプレートをエクスポートするには、以下の手順を実行します。

1. *データ収集* → *テンプレート* に移動します。
2. エクスポートするテンプレートのチェックボックスをオンにします。
3. リストの下にある *エクスポート* をクリックします。

![](../../../assets/en/manual/xml_export_import/export_templates.png)

選択したフォーマットに応じて、テンプレートはデフォルト名のローカルファイルにエクスポートされます。

-   `zabbix_export_templates.yaml` - YAMLエクスポートの場合（エクスポートのデフォルトオプション）;
-   `zabbix_export_templates.xml` - XMLエクスポートの場合;
-   `zabbix_export_templates.json` - JSONエクスポートの場合。

[comment]: # ({/9a909adc-ca3e35f8})

[comment]: # ({a5ee5ead-78f6f939})
#### インポート

テンプレートをインポートするには、次の手順を実行します。

1. *データ収集* → *テンプレート* に移動します。
2. 右上隅の *インポート* をクリックします。
3. インポートファイルを選択します。
4. 設定フォームの右下隅にある *インポート* をクリックします。

![](../../../assets/en/manual/xml_export_import/import_templates.png){width="600"}

*詳細オプション* チェックボックスをオンにすると、インポート可能なすべての要素の詳細な一覧が表示されます。必要に応じて各インポートルールをオンまたはオフにしてください。

*すべて* 行のチェックボックスをクリックすると、その下にあるすべての要素がオン/オフされます。

インポートルール:

|ルール|説明|
|----|-----------|
|*既存を更新*|既存の要素は、インポートファイルのデータを使用して更新されます。そうでない場合、更新されません。|
|*新規作成*|新しい要素は、インポートファイルのデータを使用して作成されます。そうでない場合、作成されません。|
|*不足分を削除*|インポートファイルに存在しない既存の要素は削除されます。そうでない場合、削除されません。<br>*テンプレートのリンク* に対して *不足分を削除* がオンになっている場合、インポートファイルに存在しない現在のテンプレートリンクは解除されます。リンク解除されたテンプレートから継承されたエンティティ（アイテム、トリガー、グラフなど）は削除されません（各エンティティに対しても *不足分を削除* オプションが選択されている場合を除きます）。|

::: noteimportant
同じ名前のテンプレートがすでに存在する場合、クリーンなインポートを実現するには、インポート時に *不足分を削除* オプションをチェックする必要があります。
こうすることで、更新後のテンプレートに含まれなくなった古いアイテムが削除されます（これらの古いアイテムの履歴が失われることに注意してください）。
:::

次の画面では、インポートされるテンプレートの内容を確認できます。
新しいテンプレートの場合、すべての要素が緑色で表示されます。
既存のテンプレートを更新する場合、新しいテンプレート要素は緑色で強調表示され、削除されたテンプレート要素は赤色で強調表示され、変更されていない要素は灰色の背景で表示されます。

![](../../../assets/en/manual/xml_export_import/import_templates_details.png){width="600"}

左側のメニューを使用して、変更一覧内を移動できます。
*更新済み* セクションでは、既存のテンプレート要素に加えられたすべての変更が強調表示されます。
*追加済み* セクションには、新しいテンプレート要素が一覧表示されます。
各セクション内の要素は要素タイプごとにグループ化されています。灰色の矢印をクリックすると、要素グループを展開または折りたたむことができます。

![](../../../assets/en/manual/xml_export_import/import_templates_menu.png)

テンプレートの変更内容を確認したら、*インポート* をクリックしてテンプレートのインポートを実行します。
インポートの成功または失敗メッセージがWebインターフェースに表示されます。

[comment]: # ({/a5ee5ead-78f6f939})

[comment]: # ({ef9795c7-e7259fe0})
## エクスポート形式

テンプレートをエクスポートすると、Zabbixは構造化されたYAML、JSON、またはXML形式を生成します。
エクスポートには、テンプレートのメタデータ、アイテム、マクロ、トリガー、ダッシュボードなどのテンプレート要素が含まれます。

各要素は特定の目的を持ち、ネストされた要素を含む場合があります。

以下のセクションでは、エクスポート形式の各要素について説明します。
例では、[Linux by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/os/linux/template_os_linux.yaml) テンプレートを使用しています。

省略記号 `(...)` は、簡潔にするために省略された要素を示します。
`(see table below)` の注記は、後のセクションで要素がより詳細に説明されている場合に使用されます。

[comment]: # ({/ef9795c7-e7259fe0})

[comment]: # ({854855e8-2c61d3f8})
## テンプレートメタデータ

```yaml
zabbix_export:
  version: '8.0'
  template_groups:
    - uuid: 846977d1dfed4968bc5f8bdb363285bc
      name: 'Templates/Operating systems'
  templates: (see table below)
  triggers: (see table below)
  graphs: (see table below)
```

|要素|<|型|説明|
|-|---|---|-----------------------|
|version|<|string|(必須) エクスポートバージョン。|
|template_groups|<| |(必須) テンプレートグループのルート要素。|
|<|uuid|string|(必須) このテンプレートグループの一意の識別子。|
|^|name|string|(必須) テンプレートグループ名。|
|host_groups|<| |ホストプロトタイプで使用されるホストグループのルート要素。|
|<|uuid|string|(必須) このホストグループの一意の識別子。|
|^|name|string|(必須) ホストグループ名。|
|templates|<| |[テンプレート](#templates)のルート要素。|
|triggers|<| |テンプレートトリガー要素のルート要素。[テンプレートアイテムトリガー](#template-item-triggers)と同じです。|
|graphs|<| |テンプレートグラフ要素のルート要素。[ホストグラフ](/manual/xml_export_import/hosts#host-graphs)と同じです。|

[comment]: # ({/854855e8-2c61d3f8})

[comment]: # ({dd596252-bdfd38fc})
### テンプレート

```yaml
zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      template: 'Linux by Zabbix agent'
      name: 'Linux by Zabbix agent'
      description: |
        これは公式のLinuxテンプレートです。Zabbixエージェント 8.0以降が必要です。(...) 
      wizard_ready: 'YES'
      readme: |
        ## 概要
        
        これは公式のLinuxテンプレートです。Zabbixエージェント 8.0以降が必要です。(...)
      vendor:
        name: Zabbix
        version: 8.0-2
      groups:
        - name: 'Templates/Operating systems'
      items: （以下の表を参照）
      discovery_rules: （以下の表を参照）
      tags:
        - tag: class
          value: os
        - tag: target
          value: linux
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          value: 3m
          description: 'この時間を過ぎるとエージェントは利用不可と見なされます。Zabbixサーバー/プロキシから到達可能なエージェント（パッシブモード）でのみ機能します。'
          config: （以下の表を参照）
        - macro: '{$CPU.UTIL.CRIT}'
          value: '90'
          description: 'CPU使用率の重大しきい値（%単位）。'
          config: （以下の表を参照）
        (...)
      dashboards: （以下の表を参照）
      valuemaps: （以下の表を参照）
    (...)
```

|Element|<|Type|説明|
|-|---|---|-----------------------|
|uuid|<|string|（必須）このテンプレートの一意な識別子。|
|template|<|string|（必須）一意なテンプレート名。|
|name|<|string|表示用テンプレート名。|
|description|<|text|テンプレートの説明。|
|wizard\_ready|<|text|テンプレートを[ホストウィザード](/manual/config/hosts/host_wizard)で選択可能にするかどうか。<br>指定可能な値:^[1](#footnotes)^ NO (0、デフォルト)、YES (1)。<br>関連項目: [Template object](/manual/api/reference/template/object) (`wizard_ready`)。|
|readme|<|text|[ホストウィザード](/manual/config/hosts/host_wizard#configure-host)に表示する、テンプレート固有の設定手順。Markdown形式をサポートします。|
|vendor|<| |テンプレートベンダーのルート要素（エクスポートされたテンプレートにベンダーデータが含まれる場合に存在）。|
|<|name|string|（必須）テンプレートベンダー名。|
|^|version|string|（必須）テンプレートのバージョン。<br>[out-of-the-box templates](/manual/config/templates_out_of_the_box) では、バージョンは次の形式で表示されます: Zabbixのメジャーバージョン、区切り文字（"-"）、リビジョン番号（テンプレートの新しいバージョンごとに増加し、Zabbixのメジャーバージョンごとにリセットされます）。例: 7.0-0、7.0-3、8.0-0、8.0-3。|
|templates|<| |リンクされたテンプレートのルート要素。|
| |name|string|（必須）テンプレート名。|
|groups|<| |テンプレートグループのルート要素。|
| |name|string|（必須）テンプレートグループ名。|
|items|<| |[テンプレートアイテム](#template-items)のルート要素。|
|discovery_rules|<| |[テンプレートのローレベルディスカバリルール](#template-low-level-discovery-rules)のルート要素。|
|httptests|<| |[テンプレートのWebシナリオ](#template-web-scenarios)のルート要素。|
|tags|<| |テンプレートタグのルート要素。|
|<|tag|string|（必須）タグ名。|
|^|value|string|タグ値。|
|macros|<| |テンプレートユーザーマクロのルート要素。|
|<|macro|string|（必須）ユーザーマクロ名。|
|^|type|string|ユーザーマクロのタイプ。<br>指定可能な値:^[1](#footnotes)^ TEXT (0、デフォルト)、SECRET\_TEXT (1)、VAULT (2)。<br>関連項目: [User macro object](/manual/api/reference/usermacro/object) (`type`)。|
|^|value|string|ユーザーマクロ値。|
|^|description|string|ユーザーマクロの説明。|
|^|config| |[ホストウィザード](/manual/config/hosts/host_wizard#configure-host)でマクロをどのように表示するかを制御する、[テンプレートマクロ設定](#template-macro-configuration)のルート要素。|
|dashboards|<| |[テンプレートダッシュボード](#template-dashboards)のルート要素。|
|valuemaps|<| |[テンプレートの値マッピング](#template-value-maps)のルート要素。|

[comment]: # ({/dd596252-bdfd38fc})

[comment]: # ({d75cdc3f-18631c1b})
#### テンプレートアイテム

```yaml
zabbix_export:
  (...)
  templates:
    (...)
      items:
        - uuid: f94f9f4699e94c369e6c98b2a2f485ce
          name: 'Zabbixエージェント ping'
          key: agent.ping
          description: 'エージェントはこのアイテムに対して常に "1" を返します。可用性チェックのために `nodata()` と組み合わせて使用できます。'
          valuemap:
            name: 'Zabbixエージェント ping status'
          tags:
            - tag: component
              value: system
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          name: 'インストール済みパッケージ数'
          key: system.sw.packages.get
          delay: 1h
          preprocessing: （以下の表を参照）
          tags:
            - tag: component
              value: os
          triggers: （以下の表を参照）
        - uuid: 403cebed115441369e94d35d070ca7b8
          name: 'メモリ使用率'
          type: DEPENDENT
          key: vm.memory.utilization
          value_type: FLOAT
          units: '%'
          description: '使用済みメモリの割合は `100-pavailable` として計算されます。'
          preprocessing: （以下の表を参照）
          master_item:
            key: 'vm.memory.size[pavailable]'
          tags:
            - tag: component
              value: memory
          triggers: （以下の表を参照）
        (...)
```

|Element|<|Type|説明|
|-|---|---|-----------------------|
|uuid|<|string|（必須）このアイテムの一意な識別子。|
|name|<|string|（必須）アイテム名。|
|type|<|string|アイテムタイプ。<br>指定可能な値:^[1](#footnotes)^ ZABBIX\_PASSIVE (0, デフォルト), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX\_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP\_TRAP (17), DEPENDENT (18), HTTP\_AGENT (19), SNMP\_AGENT (20), ITEM\_TYPE\_SCRIPT (21), ITEM\_TYPE\_BROWSER (22)。|
|snmp\_oid|<|string|（SNMP\_AGENT アイテムで必須）SNMPオブジェクトID。|
|key|<|string|（必須）アイテムキー。|
|delay|<|string|アイテムの更新間隔。<br>デフォルト: 1m。TRAP アイテムでは値は常に 0 になります。|
|history|<|string|履歴データをどのくらいの期間保存するかを示す期間（[time suffix](/manual/appendix/suffixes#time-suffixes)、[user macro](/manual/config/macros/user_macros) または [LLD macro](/manual/config/macros/lld_macros) を使用）。<br>デフォルト: 31d。|
|trends|<|string|トレンドデータをどのくらいの期間保存するかを示す期間（[time suffix](/manual/appendix/suffixes#time-suffixes)、[user macro](/manual/config/macros/user_macros) または [LLD macro](/manual/config/macros/lld_macros) を使用）。<br>デフォルト: 365d。|
|status|<|string|アイテムのステータス。<br>指定可能な値:^[1](#footnotes)^ ENABLED (0, デフォルト), DISABLED (1)。|
|value\_type|<|string|受信する値のタイプ。<br>指定可能な値:^[1](#footnotes)^ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, デフォルト), TEXT (4), BINARY (5), JSON (6)。|
|allowed\_hosts|<|string|このアイテムに対してデータ送信を許可するホストのIPアドレスをカンマ区切りで指定したリスト。<br>TRAP および HTTP\_AGENT アイテムでサポートされます。|
|units|<|string|受信する値の単位（bps、B など）。|
|params|<|text|アイテムタイプに応じた追加パラメータ（SSH および TELNET アイテムでは実行するスクリプト、ODBC アイテムでは SQL クエリ、CALCULATED アイテムでは数式、ITEM\_TYPE\_SCRIPT および ITEM\_TYPE\_BROWSER アイテムではスクリプト）。|
|ipmi\_sensor|<|string|IPMI センサー。<br>IPMI アイテムでサポートされます。|
|authtype|<|string|認証タイプ。<br>SSH および HTTP\_AGENT アイテムでサポートされます。<br>SSH アイテムで指定可能な値:^[1](#footnotes)^ PASSWORD (0, デフォルト), PUBLIC\_KEY (1)。<br>HTTP\_AGENT アイテムで指定可能な値:^[1](#footnotes)^ NONE (0, デフォルト), BASIC (1), NTLM (2), Kerberos (3), または Digest (4)。|
|username|<|string|（SSH および TELNET アイテムで必須）認証用のユーザー名。<br>SIMPLE、ODBC、JMX、HTTP\_AGENT アイテムでサポートされます。<br>JMX アイテムで使用する場合は、`password`（以下参照）も指定するか、両方の要素を空欄のままにする必要があります。|
|password|<|string|（SSH および TELNET アイテムで必須）認証用のパスワード。<br>SIMPLE、ODBC、JMX、HTTP\_AGENT アイテムでサポートされます。<br>JMX アイテムで使用する場合は、`username`（上記参照）も指定するか、両方の要素を空欄のままにする必要があります。|
|publickey|<|string|（SSH アイテムで必須）公開鍵ファイル名。|
|privatekey|<|string|（SSH アイテムで必須）秘密鍵ファイル名。|
|description|<|text|アイテムの説明。|
|inventory\_link|<|string|アイテムによって設定されるホストインベントリフィールド。<br>指定可能な値:^[1](#footnotes)^ NONE (0), ALIAS (4) など（サポートされるフィールドについては [Host inventory](/manual/api/reference/host/object#host-inventory) を参照）。|
|valuemap|<| |アイテムの値マップのルート要素。|
| |name|string|（必須）このアイテムで使用する値マップ名。|
|logtimefmt|<|string|ログエントリ内の時刻の形式。<br>LOG 値タイプのアイテムでサポートされます。|
|preprocessing|<| |アイテム値の前処理のルート要素。|
| |step| |[テンプレートアイテム値の前処理ステップ](#template-item-value-preprocessing-steps) のルート要素。|
|jmx\_endpoint|<|string|JMX エンドポイント。<br>JMX アイテムでサポートされます。|
|master_item|<| |（DEPENDENT アイテムで必須）依存アイテムのマスターアイテムのルート要素。|
| |key|string|（必須）依存アイテムのマスターアイテムキー。|
|timeout|<|string|アイテムデータのポーリング要求タイムアウト。<br>[Timeouts](/manual/web_interface/frontend_sections/administration/general#timeouts) のアイテムタイプ一覧でサポートされます。|
|url|<|string|（HTTP\_AGENT アイテムで必須）URL 文字列。|
|query_fields|<| |クエリパラメータのルート要素。<br>HTTP\_AGENT アイテムでサポートされます。|
|<|name|string|（HTTP\_AGENT アイテムで必須）クエリパラメータ名。|
|^|value|string|クエリパラメータ値。<br>HTTP\_AGENT アイテムでサポートされます。|
|parameters|<| |ユーザー定義パラメータのルート要素。<br>ITEM\_TYPE\_SCRIPT および ITEM\_TYPE\_BROWSER アイテムでサポートされます。|
|<|name|string|（ITEM\_TYPE\_SCRIPT および ITEM\_TYPE\_BROWSER アイテムで必須）ユーザー定義パラメータ名。|
|^|value|string|ユーザー定義パラメータ値。<br>ITEM\_TYPE\_SCRIPT および ITEM\_TYPE\_BROWSER アイテムでサポートされます。|
|posts|<|string|HTTP(S) リクエスト本文データ。<br>HTTP\_AGENT アイテムでサポートされます。|
|status\_codes|<|string|必要な HTTP ステータスコードの範囲をカンマ区切りで指定します。<br>HTTP\_AGENT アイテムでサポートされます。|
|follow\_redirects|<|string|データのポーリング中にレスポンスのリダイレクトに従うかどうか。<br>HTTP\_AGENT アイテムでサポートされます。<br>指定可能な値:^[1](#footnotes)^ NO (0), YES (1, デフォルト)。|
|post\_type|<|string|POST データ本文のタイプ。<br>HTTP\_AGENT アイテムでサポートされます。<br>指定可能な値:^[1](#footnotes)^ RAW (0, デフォルト), JSON (2), XML (3)。|
|http\_proxy|<|string|HTTP(S) プロキシ接続文字列。<br>HTTP\_AGENT アイテムでサポートされます。|
|headers|<| |HTTP(S) リクエストヘッダーのルート要素。<br>HTTP\_AGENT アイテムでサポートされます。|
|<|name|string|（HTTP\_AGENT アイテムで必須）ヘッダー名。|
|^|value|string|（HTTP\_AGENT アイテムで必須）ヘッダー値。|
|retrieve\_mode|<|string|レスポンスのどの部分を保存するか。<br>HTTP\_AGENT アイテムでサポートされます。<br>指定可能な値:^[1](#footnotes)^ BODY (0, デフォルト), HEADERS (1), BOTH (2)。|
|request\_method|<|string|リクエストメソッドのタイプ。<br>HTTP\_AGENT アイテムでサポートされます。<br>指定可能な値:^[1](#footnotes)^ GET (0, デフォルト), POST (1), PUT (2), HEAD (3)。|
|output\_format|<|string|レスポンスの処理方法。<br>HTTP\_AGENT アイテムでサポートされます。<br>指定可能な値:^[1](#footnotes)^ RAW (0, デフォルト), JSON (1)。|
|allow\_traps|<|string|trapper アイテムと同様に値を設定できるようにします。<br>HTTP\_AGENT アイテムでサポートされます。<br>指定可能な値:^[1](#footnotes)^ NO (0, デフォルト), YES (1)。|
|ssl\_cert\_file|<|string|公開 SSL キーファイルのパス。<br>HTTP\_AGENT アイテムでサポートされます。|
|ssl\_key\_file|<|string|秘密 SSL キーファイルのパス。<br>HTTP\_AGENT アイテムでサポートされます。|
|ssl\_key\_password|<|string|SSL キーファイルのパスワード。<br>HTTP\_AGENT アイテムでサポートされます。|
|verify\_peer|<|string|ホストの証明書が正当なものであることを検証するかどうか。<br>HTTP\_AGENT アイテムでサポートされます。<br>指定可能な値:^[1](#footnotes)^ NO (0, デフォルト), YES (1)。|
|verify\_host|<|string|接続先のホスト名がホストの証明書内のものと一致することを検証するかどうか。<br>HTTP\_AGENT アイテムでサポートされます。<br>指定可能な値:^[1](#footnotes)^ NO (0, デフォルト), YES (1)。|
|tags|<| |アイテムタグのルート要素。|
|<|tag|string|（必須）タグ名。|
|^|value|string|タグ値。|
|triggers|<|<|[テンプレートアイテムトリガー](#template-item-triggers) のルート要素。|

::: noteclassic
関連項目: [Item object](/manual/api/reference/item/object)（一致する名前の関連プロパティを参照してください）。
:::

[comment]: # ({/d75cdc3f-18631c1b})

[comment]: # ({df0b957d-497cb193})
##### テンプレートアイテムの値の事前処理ステップ

```yaml
zabbix_export:
  (...)
  templates:
    (...)
      items:
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          (...)
          preprocessing:
            - type: JSONPATH
              parameters:
                - $.length()
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 12h
          (...)
```

|要素|<|型|説明|
|-|---|---|-----------------------|
|type|<|string|(必須) アイテム値の事前処理ステップのタイプ。<br>指定可能な値:^[1](#footnotes)^ MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL\_TO\_DECIMAL (6), OCTAL\_TO\_DECIMAL (7), HEX\_TO\_DECIMAL (8), SIMPLE\_CHANGE (9, 計算式: 受信値 - 前回値), CHANGE\_PER\_SECOND (10, 計算式: (受信値 - 前回値)/(現在時刻 - 前回チェック時刻)), XMLPATH (11), JSONPATH (12), IN\_RANGE (13), MATCHES\_REGEX (14), NOT\_MATCHES\_REGEX (15), CHECK\_JSON\_ERROR (16), CHECK\_XML\_ERROR (17), CHECK\_REGEX\_ERROR (18), DISCARD\_UNCHANGED (19), DISCARD\_UNCHANGED\_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS\_PATTERN (22), PROMETHEUS\_TO\_JSON (23), CSV\_TO\_JSON (24), STR\_REPLACE (25), CHECK\_NOT\_SUPPORTED (26), XML\_TO\_JSON (27), SNMP\_WALK\_VALUE (28), SNMP\_WALK\_TO\_JSON (29), SNMP\_GET\_VALUE (30)。|
|parameters|<| |(必須) アイテム値の事前処理ステップのパラメータのルート要素。|
| |parameter|string|アイテム値の事前処理ステップの個別パラメータ。|
|error\_handler|<|string|事前処理ステップの失敗時に使用されるアクションタイプ。<br>指定可能な値:^[1](#footnotes)^ ORIGINAL\_ERROR (0, デフォルト), DISCARD\_VALUE (1), CUSTOM\_VALUE (2), CUSTOM\_ERROR (3)。|
|error\_handler\_params|<|string|エラーハンドラのパラメータ。|

::: noteclassic
参照: [アイテムの事前処理オブジェクト](/manual/api/reference/item/object#item-preprocessing) (同名のプロパティを参照)。
:::

[comment]: # ({/df0b957d-497cb193})

[comment]: # ({8e24887a-8aada697})
##### テンプレートアイテムのトリガー

```yaml
zabbix_export:
  (...)
  templates:
    (...)
      items:
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          (...)
          triggers:
            - uuid: b950c306394f4b3c902060a8273cbcde
              expression: 'change(/Linux by Zabbix agent/system.sw.packages.get)<>0'
              name: 'Linux: Number of installed packages has been changed'
              priority: WARNING
              manual_close: 'YES'
              tags:
                - tag: scope
                  value: notice
        (...)
        - uuid: 403cebed115441369e94d35d070ca7b8
          (...)
          triggers:
            - uuid: cfd395b1cde74ef18a5e5f840bd5142a
              expression: 'min(/Linux by Zabbix agent/vm.memory.utilization,5m)>{$MEMORY.UTIL.MAX}'
              name: 'Linux: High memory utilization'
              event_name: 'Linux: High memory utilization (>{$MEMORY.UTIL.MAX}% for 5m)'
              priority: AVERAGE
              description: 'The system is running out of free memory.'
              dependencies:
                - name: 'Linux: Lack of available memory'
                  expression: 'max(/Linux by Zabbix agent/vm.memory.size[available],5m)<{$MEMORY.AVAILABLE.MIN} and last(/Linux by Zabbix agent/vm.memory.size[total])>0'
              tags:
                - tag: scope
                  value: capacity
                - tag: scope
                  value: performance
        (...)
```

|要素|<|型|説明|
|-|---|---|-----------------------|
|uuid|<|string|(必須) このトリガーの一意な識別子。|
|expression|<|string|(必須) トリガーの式。|
|recovery\_mode|<|string|OKイベント生成の基準。<br>可能な値:^[1](#footnotes)^ EXPRESSION (0, デフォルト), RECOVERY\_EXPRESSION (1), NONE (2)。|
|recovery\_expression|<|string|トリガーのリカバリー式。|
|correlation\_mode|<|string|相関モード（イベント相関なし、またはタグによるイベント相関）。<br>可能な値:^[1](#footnotes)^ DISABLED (0, デフォルト), TAG\_VALUE (1)。|
|correlation\_tag|<|string|イベント相関に使用するタグ名。|
|name|<|string|(必須) トリガー名。|
|event\_name|<|string|イベント名。|
|opdata|<|string|運用データ。|
|url\_name|<|string|トリガーに関連付けられたURLのラベル。|
|url|<|string|トリガーに関連付けられたURL。|
|status|<|string|トリガーのステータス。<br>可能な値:^[1](#footnotes)^ ENABLED (0, デフォルト), DISABLED (1)。|
|priority|<|string|トリガーの深刻度。<br>可能な値:^[1](#footnotes)^ NOT\_CLASSIFIED (0, デフォルト), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5)。|
|description|<|text|トリガーの説明。|
|type|<|string|イベント生成タイプ（単一の問題イベントまたは複数の問題イベント）。<br>可能な値:^[1](#footnotes)^ SINGLE (0, デフォルト), MULTIPLE (1)。|
|manual\_close|<|string|問題イベントの手動クローズ。<br>可能な値:^[1](#footnotes)^ NO (0, デフォルト), YES (1)。|
|dependencies|<| |依存関係のルート要素。|
|<|name|string|(必須) 依存トリガー名。|
|^|expression|string|(必須) 依存トリガーの式。|
|^|recovery\_expression|string|依存トリガーのリカバリー式。|
|tags|<| |トリガータグのルート要素。|
|<|tag|string|(必須) タグ名。|
|^|value|string|タグ値。|

::: noteclassic
参照: [Trigger object](/manual/api/reference/trigger/object)（同名のプロパティを参照）。
:::

[comment]: # ({/8e24887a-8aada697})

[comment]: # ({f783f2f2-2fdd304e})
#### テンプレートのローレベルディスカバリルール

```yaml
zabbix_export:
  (...)
  templates:
    (...)
      discovery_rules:
        - uuid: acfdea9c46ef48c68e6636f43b8f96a2
          name: 'Network interface discovery'
          key: net.if.discovery
          delay: 1h
          filter: (see table below)
          description: 'The discovery of network interfaces.'
          item_prototypes: (see table below)
          trigger_prototypes: (see table below)
          graph_prototypes: (see table below)
        (...)
```

::: noteimportant
テンプレートのローレベルディスカバリルール要素のほとんどは、[テンプレートアイテム](#template-items)と同じです。
下記の表では、テンプレートアイテムと異なる要素について説明します。
:::

|要素|<|型|説明|
|-|---|---|-----------------------|
|type|<|string|アイテムタイプ。<br>指定可能な値:^[1](#footnotes)^ ZABBIX\_PASSIVE (0, デフォルト), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX\_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP\_AGENT (19), SNMP\_AGENT (20), ITEM\_TYPE\_SCRIPT (21), ITEM\_TYPE\_BROWSER (22)。|
|key|<|string|(必須) ローレベルディスカバリルールのキー。|
|filter|<| |[テンプレートのローレベルディスカバリルールフィルタ](#template-low-level-discovery-rule-filters)のルート要素。|
|lifetime|<|string|発見されなくなったリソースが削除されるまでの期間（秒、[時間サフィックス](/manual/appendix/suffixes#time-suffixes)、または[ユーザーマクロ](/manual/config/macros/user_macros)を使用）。<br>デフォルト: 7d。|
|lifetime_type|<|string|失われたLLDリソースを削除するシナリオ。<br>指定可能な値: DELETE\_NEVER, DELETE\_IMMEDIATELY, DELETE\_AFTER。|
|enabled_lifetime|<|string|発見されなくなったリソースが無効化されるまでの期間（秒、[時間サフィックス](/manual/appendix/suffixes#time-suffixes)、または[ユーザーマクロ](/manual/config/macros/user_macros)を使用）。|
|enabled_lifetime_type|<|string|失われたLLDリソースを無効化するシナリオ。<br>指定可能な値: DISABLE\_NEVER, DISABLE\_IMMEDIATELY, DISABLE\_AFTER。|
|item\_prototypes|<| |テンプレートアイテムプロトタイプ要素のルート要素。[テンプレートアイテム](#template-items)と同じです。|
|trigger\_prototypes|<| |テンプレートトリガープロトタイプ要素のルート要素。[テンプレートアイテムトリガー](#template-item-triggers)と同じです。|
|graph\_prototypes|<| |テンプレートグラフプロトタイプ要素のルート要素。[ホストグラフ](/manual/xml_export_import/hosts#host-graphs)と同じです。|
|host\_prototypes|<| |テンプレートホストプロトタイプ要素のルート要素。[ホスト](/manual/xml_export_import/hosts#hosts)と同じです。|
|parent\_discovery\_rule|<| |ローレベルディスカバリルールプロトタイプの親ローレベルディスカバリルール（またはルールプロトタイプ）のルート要素。このプロパティは、参照されたルール/ルールプロトタイプの直接の子であるLLDルールプロトタイプであることを示します。|
|<|key|string|(必須) 親ローレベルディスカバリルール（またはルールプロトタイプ）のキー。|
|master\_item|<|string|(DEPENDENTルールの場合は必須) 従属ルールのマスターアイテムのルート要素。|
|lld\_macro\_paths|<| |ローレベルディスカバリルールのマクロパスのルート要素。|
|<|lld\_macro|string|(必須) ローレベルディスカバリルールのマクロ名。|
|^|path|string|(必須) 対応するマクロに割り当てる値のセレクタ。|
|preprocessing|<| |ローレベルディスカバリルール値のプリプロセスのルート要素。|
| |step| |[テンプレートアイテム値のプリプロセスステップ](#template-item-preprocessing-steps)と同じローレベルディスカバリルール値のプリプロセスステップ要素のルート要素。ただし、指定可能な値は少なくなります。参照: [LLDルールプリプロセスオブジェクト](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing)。|
|overrides|<| |ローレベルディスカバリルールのオーバーライドルールのルート要素。|
|<|name|string|(必須) 一意のオーバーライド名。|
|^|step|string|(必須) オーバーライドの一意の順序番号。|
|^|stop|string|一致した場合、次のオーバーライドの処理を停止します。|
|^|filter| |[テンプレートのローレベルディスカバリルールフィルタ](#template-low-level-discovery-rule-filters)と同じテンプレートのローレベルディスカバリルールオーバーライドルールフィルタ要素のルート要素。|
|^|operations| |[テンプレートのローレベルディスカバリルールオーバーライド操作](#template-low-level-discovery-rule-override-operations)のルート要素。|

::: noteclassic
参照: [LLDルールオブジェクト](/manual/api/reference/discoveryrule/object)（同名の該当プロパティを参照）。
:::

[comment]: # ({/f783f2f2-2fdd304e})

[comment]: # ({e41c55eb-1147e24b})
##### テンプレートのローレベルディスカバリールールフィルター

```yaml
zabbix_export:
  (...)
  templates:
    (...)
      discovery_rules:
        - uuid: acfdea9c46ef48c68e6636f43b8f96a2
          (...)
          filter:
            evaltype: AND
            conditions:
              - macro: '{#IFNAME}'
                value: '{$NET.IF.IFNAME.MATCHES}'
              - macro: '{#IFNAME}'
                value: '{$NET.IF.IFNAME.NOT_MATCHES}'
                operator: NOT_MATCHES_REGEX
          (...)
        - uuid: 2bbdc79f082d4c618e01bec625e9c90a
          (...)
          filter:
            evaltype: AND
            conditions:
              - macro: '{#DEVNAME}'
                value: '{$VFS.DEV.DEVNAME.MATCHES}'
              - macro: '{#DEVNAME}'
                value: '{$VFS.DEV.DEVNAME.NOT_MATCHES}'
                operator: NOT_MATCHES_REGEX
              - macro: '{#DEVTYPE}'
                value: disk
          (...)
```

|要素|<|型|説明|
|-|---|---|-----------------------|
|evaltype|<|string|フィルター条件の評価方法を上書きします。<br>使用可能な値:^[1](#footnotes)^ AND\_OR (0, デフォルト), AND (1), OR (2), FORMULA (3)。|
|formula|<|string|フィルター条件のカスタム計算式。|
|conditions|<| |フィルター条件のルート要素。|
|<|macro|string|(必須) チェックを実行するローレベルディスカバリーマクロの名前。|
|^|value|string|比較する値。|
|^|operator|string|条件演算子。<br>使用可能な値:^[1](#footnotes)^ MATCHES\_REGEX (8, デフォルト), NOT\_MATCHES\_REGEX (9)。|
|^|formulaid|string|(必須) カスタム式から条件を参照するために使用される任意の一意のID。大文字のみ使用可能。フィルター条件を変更する際にユーザーが定義する必要がありますが、その後リクエストする際には新たに生成されます。|

::: noteclassic
参照: [LLDルールフィルターオブジェクト](/manual/api/reference/discoveryrule/object#lld-rule-filter)（該当するプロパティ名で参照）。
:::

[comment]: # ({/e41c55eb-1147e24b})

[comment]: # ({7eed19ff-18c53e3c})
##### テンプレートのローレベルディスカバリールールのオーバーライド操作

|要素|<|型|説明|
|-|---|---|-----------------------|
|operationobject|<|string|操作が適用されるオブジェクト。<br>可能な値:^[1](#footnotes)^ ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3)。|
|operator|<|string|オーバーライド条件演算子。<br>可能な値:^[1](#footnotes)^ EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6)。|
|value|<|string|オーバーライド条件演算子のための正規表現または文字列。|
|status|<|string|オーバーライド操作時のオブジェクトのステータス。|
|discover|<|string|ディスカバリの結果としてオブジェクトが追加されるかどうか。|
|delay|<|string|オーバーライド操作時にアイテムプロトタイプに設定される更新間隔。|
|history|<|string|オーバーライド操作時にアイテムプロトタイプに設定される履歴保存期間。|
|trends|<|string|オーバーライド操作時にアイテムプロトタイプに設定されるトレンド保存期間。|
|severity|<|string|オーバーライド操作時に設定されるトリガープロトタイプの深刻度。|
|tags|<| |オーバーライド操作時にオブジェクトに設定されるタグのルート要素。|
|<|tag|string|(必須) タグ名。|
|^|value|string|タグ値。|
|templates|<| |オーバーライド操作時にホストプロトタイプにリンクされるテンプレートのルート要素。|
| |name|string|(必須) テンプレート名。|
|inventory_mode|<|string|オーバーライド操作時に設定されるホストプロトタイプのインベントリモード。|

::: noteclassic
関連項目: [LLDルールのオーバーライド操作オブジェクト](/manual/api/reference/discoveryrule/object#lld-rule-override-operation)（同名のプロパティを参照）。
:::

[comment]: # ({/7eed19ff-18c53e3c})

[comment]: # ({ad2d6df7-fd8f09c1})
#### テンプレートWebシナリオ

|要素|<|型|説明|
|-|---|---|-----------------------|
|uuid|<|string|(必須) このWebシナリオの一意の識別子。|
|name|<|string|(必須) Webシナリオ名。|
|delay|<|string|Webシナリオの実行頻度（秒、[時間のサフィックス](/manual/appendix/suffixes#time-suffixes)、または[ユーザーマクロ](/manual/config/macros/user_macros)を使用）。<br>デフォルト: 1m。|
|attempts|<|integer|Webシナリオステップの実行試行回数。<br>可能な値:^[1](#footnotes)^ 1-10（デフォルト: 1）。|
|agent|<|string|クライアントエージェント。Zabbixは選択したブラウザになりすまします。<br>これは、Webサイトが異なるブラウザに対して異なるコンテンツを返す場合に便利です。<br>デフォルト: Zabbix。|
|http\_proxy|<|string|Webシナリオで使用されるプロキシ。`http://[username[:password]@]proxy.example.com[:port]`の形式で指定。|
|variables|<| |シナリオステップで使用できるWebシナリオ変数のルート要素。|
|<|name|string|(必須) 変数名。|
|^|value|text|(必須) 変数値。|
|headers|<| |リクエスト実行時に送信されるHTTPヘッダーのルート要素。<br>ヘッダーはHTTPプロトコルで表示されるのと同じ構文でリストする必要があります。|
|<|name|string|(必須) ヘッダー名。|
|^|value|text|(必須) ヘッダー値。|
|status|<|string|Webシナリオのステータス。<br>可能な値:^[1](#footnotes)^ ENABLED (0, デフォルト), DISABLED (1)。|
|authentication|<|string|認証方式。<br>可能な値:^[1](#footnotes)^ NONE (0, デフォルト), BASIC (1), NTLM (2), Kerberos (3), Digest (4)。|
|http\_user|<|string|BASIC(HTTP)、NTLM、Kerberos、Digest認証で使用されるユーザー名。|
|http\_password|<|string|BASIC(HTTP)、NTLM、Kerberos、Digest認証で使用されるパスワード。|
|verify\_peer|<|string|WebサーバーのSSL証明書を検証するかどうか。<br>可能な値:^[1](#footnotes)^ NO (0, デフォルト), YES (1)。|
|verify\_host|<|string|Webサーバー証明書の*Common Name*フィールドまたは*Subject Alternate Name*フィールドが一致するかどうかを検証する。<br>可能な値:^[1](#footnotes)^ NO (0, デフォルト), YES (1)。|
|ssl\_cert\_file|<|string|クライアント認証で使用されるSSL証明書ファイル名（PEM形式である必要があります）。|
|ssl\_key\_file|<|string|クライアント認証で使用されるSSL秘密鍵ファイル名（PEM形式である必要があります）。|
|ssl\_key\_password|<|string|SSL秘密鍵ファイルのパスワード。|
|steps|<| |(必須) [テンプレートWebシナリオステップ](#template-web-scenario-steps)のルート要素。|
|tags|<| |Webシナリオタグのルート要素。|
|<|tag|string|(必須) タグ名。|
|^|value|string|タグ値。|

::: noteclassic
参考: [Webシナリオオブジェクト](/manual/api/reference/httptest/object)（該当するプロパティ名を参照）。
:::

[comment]: # ({/ad2d6df7-fd8f09c1})

[comment]: # ({5f667fc1-0dcf2b63})
##### テンプレートWebシナリオステップ

|要素|<|型|説明|
|-|---|---|-----------------------|
|name|<|string|(必須) Webシナリオステップ名。|
|url|<|string|(必須) 監視対象のURL。|
|query\_fields|<| |クエリパラメータのルート要素（リクエスト実行時にURLに追加されるHTTPフィールドの配列）。|
|<|name|string|(必須) クエリパラメータ名。|
|^|value|string|クエリパラメータ値。|
|posts|<| |HTTP POST変数のルート要素（文字列（生のPOSTデータ）またはHTTPフィールドの配列（フォームフィールドデータ））。|
|<|name|string|(必須) POSTフィールド名。|
|^|value|string|(必須) POSTフィールド値。|
|variables|<| |このステップの後に適用されるべきステップレベルの変数（マクロ）のルート要素。<br>変数値に 'regex:' プレフィックスがある場合、その値はこのステップで返されたデータから 'regex:' プレフィックスに続く正規表現パターンに従って抽出されます|
|<|name|string|(必須) 変数名。|
|^|value|text|(必須) 変数値。|
|headers|<| |リクエスト実行時に送信されるHTTPヘッダーのルート要素。|
|<|name|string|(必須) ヘッダー名。|
|^|value|text|(必須) ヘッダー値。|
|follow\_redirects|<|string|HTTPリダイレクトの追従。<br>指定可能な値:^[1](#footnotes)^ NO (0), YES (1, デフォルト)。|
|retrieve\_mode|<|string|HTTPレスポンスの取得モード。<br>指定可能な値:^[1](#footnotes)^ BODY (0, デフォルト), HEADERS (1), BOTH (2)。|
|timeout|<|string|ステップ実行のタイムアウト（秒、[時間のサフィックス](/manual/appendix/suffixes#time-suffixes)、または[ユーザーマクロ](/manual/config/macros/user_macros)を使用）。<br>デフォルト: 15s。|
|required|<|string|レスポンスに含まれている必要があるテキスト（空の場合は無視）。|
|status\_codes|<|string|許可されるHTTPステータスコードのカンマ区切りリスト（例: `200-201,210-299`。空の場合は無視）。|

::: noteclassic
参照: [Webシナリオステップオブジェクト](/manual/api/reference/httptest/object#scenario-step)（同名の関連プロパティを参照）。
:::

[comment]: # ({/5f667fc1-0dcf2b63})

[comment]: # ({4f5c021b-5d9cfd7b})
#### テンプレートマクロの設定

```yaml
zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      (...)
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          (...)
          config:
            type: TEXT
            priority: '1'
            label: 'Seconds since the last Zabbix agent seen'
            description: 'Timeout after which agent is considered unavailable.'
        - macro: '{$CPU.UTIL.CRIT}'
          (...)
          config:
            type: TEXT
            priority: '2'
            section_name: Thresholds
            label: 'Threshold of CPU utilization expressed'
            description: 'Critical threshold of CPU utilization expressed in %. In the range from 0 to 100 inclusive.'
            regex: '^-?([0-9]+|(([0-9]+)\.([0-9]+)))$'
        (...)
        - macro: '{$IFCONTROL}'
          (...)
          config:
            type: CHECKBOX
            priority: '19'
            label: 'Interfaces control'
            description: 'Fire a trigger when the interface operational status changes to "Link down".'
            options:
              - checked: '1'
                unchecked: '0'
        (...)
```

|要素|<|型|説明|
|-|---|---|-----------------------|
|type|<|string|(必須) マクロ入力フィールドのタイプ。<br>指定可能な値:^[1](#footnotes)^ NOCONF (0), TEXT (1), LIST (2), CHECKBOX (3)。|
|priority|<|string|マクロリスト内でのマクロの位置。|
|section_name|<|string|マクロがグループ化される折りたたみセクションのラベル。|
|label|<|string|(TEXT、LIST、CHECKBOXマクロで必須) マクロのラベル。|
|description|<|text|マクロのヘルプテキスト。Markdown書式をサポート。|
|required|<|string|マクロを必須としてマークします。<br>指定可能な値:^[1](#footnotes)^ NO (0), YES (1)。<br>TEXTおよびLISTマクロでサポート。|
|regex|<|string|テキストボックスフィールドでのユーザー入力を検証するための正規表現。<br>TEXTマクロでサポート。|
|options|<| |LISTアイテムまたはCHECKBOX値のルート要素。|
|<|value|string|(LISTマクロで必須) LISTアイテムの値。|
|^|text|string|(LISTマクロで必須) LISTアイテムのテキスト。|
|^|checked|string|(CHECKBOXマクロで必須) チェック状態を表す値。<br>指定可能な値:^[1](#footnotes)^ 0 (false), 1 (true)。<br>CHECKBOXマクロでサポート。|
|^|unchecked|string|(CHECKBOXマクロで必須) 未チェック状態を表す値。<br>指定可能な値:^[1](#footnotes)^ 0 (false), 1 (true)。<br>CHECKBOXマクロでサポート。|

::: noteclassic
参考: [マクロ設定オブジェクト](/manual/api/reference/usermacro/object#macro-configuration)（同名のプロパティを参照）。
:::

[comment]: # ({/4f5c021b-5d9cfd7b})

[comment]: # ({729a16b9-51ede6fc})
#### テンプレートダッシュボード

```yaml
zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Filesystems
          pages:
            - name: Overview
              widgets: (下表参照)
        (...)
```

|要素|<|型|説明|
|-|---|---|-----------------------|
|uuid|<|string|(必須) このダッシュボードの一意の識別子。|
|name|<|string|(必須) テンプレートダッシュボード名。|
|display period|<|integer|ダッシュボードページの表示期間。|
|auto\_start|<|string|スライドショーの自動開始。<br>指定可能な値:^[1](#footnotes)^ NO (0), YES (1, デフォルト)。|
|pages|<| |テンプレートダッシュボードページのルート要素。|
|<|name|string|ページ名。|
|^|display period|integer|ページの表示期間。|
|^|sortorder|integer|ページの並び順。|
|widgets|<| |[テンプレートダッシュボードウィジェット](#template-dashboard-widgets)のルート要素。|

::: noteclassic
参照: [テンプレートダッシュボードオブジェクト](/manual/api/reference/templatedashboard/object)（同名のプロパティを参照）。
:::

[comment]: # ({/729a16b9-51ede6fc})

[comment]: # ({d59b6d60-c1a97fff})
##### テンプレートダッシュボードウィジェット

```yaml
zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Filesystems
          pages:
            - name: Overview
              widgets:
                - type: graphprototype
                  width: '72'
                  height: '5'
                  fields:
                    - type: INTEGER
                      name: columns
                      value: '3'
                    - type: GRAPH_PROTOTYPE
                      name: graphid.0
                      value:
                        host: 'Linux by Zabbix agent'
                        name: 'FS [{#FSTYPE}({#FSNAME})]: Space utilization chart (relative to total)'
                    - type: STRING
                      name: reference
                      value: AAAEB
                - type: graphprototype
                  'y': '5'
                  width: '72'
                  height: '5'
                  fields:
                    - type: INTEGER
                      name: columns
                      value: '1'
                    - type: GRAPH_PROTOTYPE
                      name: graphid.0
                      value:
                        host: 'Linux by Zabbix agent'
                        name: 'FS [{#FSTYPE}({#FSNAME})]: Space usage graph, in % (relative to max available)'
                    - type: STRING
                      name: reference
                      value: AAAEC
        (...)
```

|要素|<|型|説明|
|-|---|---|-----------------------|
|type|<|string|(必須) ウィジェットタイプ。|
|name|<|string|ウィジェット名。|
|x|<|integer|テンプレートダッシュボードの左端からの水平位置。<br>可能な値:^[1](#footnotes)^ 0-71。|
|y|<|integer|テンプレートダッシュボードの上端からの垂直位置。<br>可能な値:^[1](#footnotes)^ 0-63。|
|width|<|integer|ウィジェットの幅。<br>可能な値:^[1](#footnotes)^ 1-72。|
|height|<|integer|ウィジェットの高さ。<br>可能な値:^[1](#footnotes)^ 1-64。|
|hide\_header|<|string|ウィジェットヘッダーの非表示。<br>可能な値:^[1](#footnotes)^ NO (0, デフォルト), YES (1)。|
|fields|<| |テンプレートダッシュボードウィジェットフィールドのルート要素。|
|<|type|string|(必須) ウィジェットフィールドタイプ。<br>可能な値:^[1](#footnotes)^ INTEGER (0), STRING (1), ITEM (4), ITEM\_PROTOTYPE (5), GRAPH (6), GRAPH\_PROTOTYPE (7), MAP (8), SERVICE (9), SLA (10), USER (11), ACTION (12), MEDIA_TYPE (13)。|
|^|name|string|(必須) ウィジェットフィールド名。|
|^|value|mixed|(必須) フィールドタイプに応じたウィジェットフィールド値。|

::: noteclassic
関連項目: [テンプレートダッシュボードウィジェットオブジェクト](/manual/api/reference/templatedashboard/object#template-dashboard-widget)（同名のプロパティを参照）。
:::

[comment]: # ({/d59b6d60-c1a97fff})

[comment]: # ({de758e45-8e4db88d})
#### テンプレートの値のマッピング

```yaml
zabbix_export:
  (...)
  templates:
    (...)
      valuemaps:
        - uuid: 8c048c6cca8248f2860c208e8db0f59e
          name: ifOperStatus
          mappings:
            - value: '0'
              newvalue: unknown
            - value: '1'
              newvalue: notpresent
            - value: '2'
              newvalue: down
            - value: '3'
              newvalue: lowerlayerdown
            - value: '4'
              newvalue: testing
            - value: '5'
              newvalue: dormant
            - value: '6'
              newvalue: up
        (...)
```

|要素|<|型|説明|
|-|---|---|-----------------------|
|uuid|<|文字列|(必須) この値のマッピングの一意の識別子。|
|name|<|文字列|(必須) 値のマッピング名。|
|mapping|<| |マッピングのルート要素。|
|<|type|文字列|マッピングの一致タイプ。<br>可能な値:^[1](#footnotes)^ EQUAL (0, デフォルト), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6)。|
|^|value|文字列|元の値。|
|^|newvalue|文字列|(必須) 元の値がマッピングされる値。|

::: noteclassic
参照: [値のマッピングオブジェクト](/manual/api/reference/valuemap/object) (同名の関連プロパティを参照)。
:::

[comment]: # ({/de758e45-8e4db88d})

[comment]: # ({8a9ebde1-869bd76e})
## 脚注

^1^ 括弧内のAPI整数値（例：ENABLED（0））は参照用にのみ記載されています。
詳細については、表のエントリまたは各セクションの最後にあるリンクされたAPIオブジェクトページを参照してください。

[comment]: # ({/8a9ebde1-869bd76e})