[comment]: # ({d220a982-0158bee8})
# 12 Item value

[comment]: # ({/d220a982-0158bee8})

[comment]: # ({f0bf3b77-90997d6a})
### 説明

これらのパラメーターと、各ダッシュボードウィジェットフィールドオブジェクトの有効なプロパティ値を使用することで、`dashboard.create`メソッドおよび`dashboard.update`メソッドで[*アイテムの値*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value)ウィジェットを設定できます。

::: noteimportant
ウィジェットの`fields`プロパティは、ダッシュボードの作成または更新時に検証されません。
これにより、ユーザーは[組み込みウィジェット](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)を変更したり、[カスタムウィジェット](/manual/modules#developing-modules)を作成したりできますが、ウィジェットを誤って作成または更新してしまうリスクも生じます。
*アイテムの値*ウィジェットを正常に作成または更新するには、以下の表に記載されているパラメーター要件を参照してください。
:::

[comment]: # ({/f0bf3b77-90997d6a})

[comment]: # ({7ebf36a4-c637d90d})
### パラメータ

*アイテム値*ウィジェットでは、以下のパラメータがサポートされています。

|パラメータ|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*更新間隔*|0|rf_rate|0 - 更新なし;<br>10 - 10秒;<br>30 - 30秒;<br>60 - *(デフォルト)* 1分;<br>120 - 2分;<br>600 - 10分;<br>900 - 15分|
|***アイテム***<br>(必須)|4|itemid|[アイテム](/manual/api/reference/item/get) ID|
|*表示*|0|表示|1 - 説明;<br>2 - 値;<br>3 - 時間;<br>4 - 変更インジケーター<br><br>デフォルト: 1、2、3、4 (すべて有効)。<br><br>注: 複数の値を設定するには、値ごとにダッシュボードウィジェットフィールドオブジェクトを作成してください。|
|*動的項目*|0|dynamic|0 - *(デフォルト)* 無効;<br>1 - 有効|
|*詳細設定*|0|adv_conf|0 - *(デフォルト)* 無効;<br>1 - 有効|

[comment]: # ({/7ebf36a4-c637d90d})

[comment]: # ({6c4a776f-db4b24d9})
#### 詳細設定

*詳細設定*が"有効"に設定されている場合、以下のパラメータがサポートされます。

|パラメータ|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|--------------------------------------------|
|*背景色*|<|1|bg_color|16進数の色コード（例：`FF0000`）<br><br>デフォルト：`""`（空）|

[comment]: # ({/6c4a776f-db4b24d9})

[comment]: # ({afead1c7-078914fc})
##### 説明

*詳細設定*が"有効"に設定され、*表示*が"説明"に設定されている場合は、以下のパラメータがサポートされます。

|パラメータ|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|名前|値|
|-----|-|-----|-------------------|
|*説明*|1|説明|マクロを含む任意の文字列値<br>サポートされているマクロ: {HOST.\*}、{ITEM.\*}、{INVENTORY.\*}、ユーザーマクロ<br><br>デフォルト: {ITEM.NAME}|
|*水平位置*|0|desc_h_pos|0 - 左;<br>1 - *(デフォルト)* 中央;<br>2 - 右<br><br>2 つ以上の要素 (説明、値、時間) が同じ *水平位置* と *垂直位置* を共有することはできません。|
|*垂直位置*|0|desc_v_pos|0 - 上;<br>1 - 中央;<br>2 - *(デフォルト)* 下<br><br>2 つ以上の要素 (説明、値、時間) が同じ *水平位置* と *垂直位置* を共有することはできません。|
|*サイズ*|0|desc_size|有効な値の範囲は 1～100 です。<br><br>デフォルト: 15|
|*太字*|0|desc_bold|0 - *(デフォルト)* 無効;<br>1 - 有効|
|*Color*|1|desc_color|16進数カラーコード（例：`FF0000`）<br><br>デフォルト：`""`（空）|

[comment]: # ({/afead1c7-078914fc})

[comment]: # ({1c933529-ef72e1ef})
##### 値

*詳細設定*が"有効"に設定され、*表示*が"値"に設定されている場合は、以下のパラメータがサポートされます。

|パラメータ|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|--------------------------------------------|
|*小数点以下の桁数*|<|<|<|
|<|*小数点以下の桁数*|0|decimal_places|有効な値の範囲は1～10です。<br><br>デフォルト: 2|
|^|*サイズ*|0|decimal_size|有効な値の範囲は1～100です。<br><br>デフォルト: 35|
|*位置*|<|<|<|<|
|<|*水平位置*|0|value_h_pos|0 - 左;<br>1 - *(デフォルト)* 中央;<br>2 - 右<br><br>2 つ以上の要素 (説明、値、時間) が同じ *水平位置* と *垂直位置* を共有することはできません。|
|^|*垂直位置*|0|value_v_pos|0 - 上;<br>1 - *(デフォルト)* 中央;<br>2 - 下<br><br>2 つ以上の要素 (説明、値、時間) が同じ *水平位置* と *垂直位置* を共有することはできません。|
|^|*サイズ*|0|value_size|有効な値の範囲は 1～100 です。<br><br>デフォルト: 45|
|^|*太字*|0|value_bold|0 - 無効;<br>1 - *(デフォルト)* 有効|
|^|*色*|1|value_color|16進数の色コード（例：`FF0000`）<br><br>デフォルト：`""`（空）|
|*単位*|<|<|<|<|
|<|*単位*（チェックボックス）|0|units_show|0 - 無効<br>1 - *（デフォルト）* 有効|
|^|*単位*（値）|1|units|任意の文字列値|
|^|*位置*|0|units_pos|0 - 前の値<br>1 - 上の値<br>2 - *（デフォルト）* 後の値<br>3 - 下の値|
|^|*サイズ*|0|units_size|有効な値の範囲は1～100です。<br><br>デフォルト：35|
|^|*太字*|0|units_bold|0 - 無効;<br>1 - *(デフォルト)* 有効|
|^|*色*|1|units_color|16進数の色コード (例: `FF0000`)<br><br>デフォルト: `""` (空)|

[comment]: # ({/1c933529-ef72e1ef})

[comment]: # ({2562b521-1504e2d4})
##### 時間

*詳細設定*が"有効"に設定され、*表示*が"時間"に設定されている場合に、以下のパラメータがサポートされます。

|パラメータ|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|名前|値|
|-----|-|-----|-------------------|
|*水平位置*|0|time_h_pos|0 - 左;<br>1 - *(デフォルト)* 中央;<br>2 - 右<br><br>2つ以上の要素（説明、値、時間）で同じ*水平位置*と*垂直位置*を共有することはできません。|
|*垂直位置*|0|time_v_pos|0 - *(デフォルト)* 上;<br>1 - 中央;<br>2 - 下<br><br>2 つ以上の要素 (説明、値、時間) が同じ *水平位置* と *垂直位置* を共有することはできません。|
|*サイズ*|0|time_size|有効な値の範囲は 1～100 です。<br><br>デフォルト: 15|
|*太字*|0|time_bold|0 - *(デフォルト)* 無効;<br>1 - 有効|
|*色*|1|time_color|16 進数のカラーコード (例: `FF0000`)<br><br>デフォルト: `""` (空)|

[comment]: # ({/2562b521-1504e2d4})

[comment]: # ({effbeabd-071114d8})
##### Change indicator

*詳細設定*が"有効"に設定され、*表示*が"変更インジケーター"に設定されている場合に、以下のパラメーターがサポートされます。

|パラメーター|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*変更インジケーター↑の色*|1|up_color|16進数カラーコード（例：`FF0000`）<br><br>デフォルト：`""`（空）|
|*変更インジケーター↓の色*|1|down_color|16進数カラーコード（例：`FF0000`）<br><br>デフォルト：`""`（空）|
|*インジケーターの色変更*|1|updown_color|16進数カラーコード（例：`FF0000`）<br><br>デフォルト：`""`（空）|

[comment]: # ({/effbeabd-071114d8})

[comment]: # ({fd9ac7eb-2dce34b2})
### 例

次の例は、*アイテムの値*ウィジェットのダッシュボードウィジェットフィールドオブジェクトの設定を説明することだけを目的としています。
ダッシュボードの設定の詳細については、[`dashboard.create`](/manual/api/reference/dashboard/create)を参照してください。

[comment]: # ({/fd9ac7eb-2dce34b2})

[comment]: # ({ac4bca74-98b4043e})
#### *アイテムの値*ウィジェットの設定

アイテム"42266"(Zabbixエージェントの可用性)のアイテム値を表示する*アイテムの値*ウィジェットを設定します。さらに、複数の詳細オプションを使用してウィジェットを視覚的に微調整します。

リクエスト:

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "item",
                        "name": "Item value",
                        "x": 0,
                        "y": 0,
                        "width": 4,
                        "height": 3,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 4,
                                "name": "itemid",
                                "value": 42266
                            },
                            {
                                "type": 0,
                                "name": "show",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "show",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "show",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "adv_conf",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "bg_color",
                                "value": "D1C4E9"
                            },
                            {
                                "type": 1,
                                "name": "description",
                                "value": "Agent status"
                            },
                            {
                                "type": 0,
                                "name": "desc_h_pos",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "desc_v_pos",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "desc_bold",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "desc_color",
                                "value": "F06291"
                            },
                            {
                                "type": 0,
                                "name": "value_h_pos",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "value_size",
                                "value": 25
                            },
                            {
                                "type": 1,
                                "name": "value_color",
                                "value": "FFFF00"
                            },
                            {
                                "type": 0,
                                "name": "units_show",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "time_h_pos",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "time_v_pos",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "time_size",
                                "value": 10
                            },
                            {
                                "type": 0,
                                "name": "time_bold",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "time_color",
                                "value": "9FA8DA"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

レスポンス:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}
```

[comment]: # ({/ac4bca74-98b4043e})

[comment]: # ({e9d30322-0dc1c2d5})
### 参照

-   [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field)
-   [`dashboard.create`](/manual/api/reference/dashboard/create)
-   [`dashboard.update`](/manual/api/reference/dashboard/update)

[comment]: # ({/e9d30322-0dc1c2d5})