[comment]: # ({9ee1626a-75e1f9a9})
# 10 Graph prototype

[comment]: # ({/9ee1626a-75e1f9a9})

[comment]: # ({ba208c2a-fff692ae})
### 説明

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

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

[comment]: # ({/ba208c2a-fff692ae})

[comment]: # ({b68cef93-a17f027e})
### パラメーター

*グラフプロトタイプ*ウィジェットでは、以下のパラメーターがサポートされています。

|パラメーター|[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分|
|*ソース*|0|source_type|2 - *(デフォルト)* グラフプロトタイプ;<br>3 - シンプルグラフプロトタイプ|
|*グラフ プロトタイプ*|7|graphid|[グラフ プロトタイプ](/manual/api/reference/graphprototype/get) ID<br><br>*ソース*が「グラフ プロトタイプ」に設定されている場合は、パラメーター *グラフ プロトタイプ* が必要です。|
|*アイテム プロトタイプ*|5|itemid|[アイテム プロトタイプ](/manual/api/reference/itemprototype/get) ID<br><br>*ソース*が「シンプル グラフ プロトタイプ」に設定されている場合は、パラメーター *アイテム プロトタイプ* が必要です。|
|*凡例の表示*|0|show_legend|0 - 無効<br>1 - *(デフォルト)* 有効|
|*動的アイテム*|0|dynamic|0 - *(デフォルト)* 無効<br>1 - 有効|
|*列*|0|列|有効な値の範囲は 1～24 です。<br><br>デフォルト: 2|
|*行*|0|行|有効な値の範囲は 1 ～ 16 です。<br><br> デフォルト: 1|

[comment]: # ({/b68cef93-a17f027e})

[comment]: # ({bc39c20a-0dcd55e8})
### 例

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

[comment]: # ({/bc39c20a-0dcd55e8})

[comment]: # ({c7baef00-6ed953dc})
#### *グラフのプロトタイプ*ウィジェットの設定

ローレベルディスカバリによってアイテムのプロトタイプ(ID: "42316")から作成された3つのグラフ(3列、1行)のグリッドを表示する*グラフのプロトタイプ*ウィジェットを設定します。

リクエスト:

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "graphprototype",
                        "name": "Graph prototype",
                        "x": 0,
                        "y": 0,
                        "width": 16,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 0,
                                "name": "source_type",
                                "value": 3
                            },
                            {
                                "type": 5,
                                "name": "itemid",
                                "value": 42316
                            },
                            {
                                "type": 0,
                                "name": "columns",
                                "value": 3
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

レスポンス:

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

[comment]: # ({/c7baef00-6ed953dc})

[comment]: # ({e9d30322-176ec50c})
### 参照

-   [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-176ec50c})