GraphSettings
アプリ内で定義されたグラフと分析を管理し、管理者がユーザー向けにデータがどのように可視化されるかを確認または更新できるようにします。
Select
WHERE 句ではAppId カラムが必須です。本製品 はKintone API を使用してこのカラムによる結果をフィルタリングします。デフォルトでは、本製品 はクライアント側で本製品 内で他のフィルタを処理します。
例えば、次のクエリはサーバー側で処理されます。
SELECT * FROM GraphSettings WHERE AppId = 6 SELECT * FROM GraphSettings WHERE AppId = 6 AND Lang = 'en' SELECT * FROM GraphSettings WHERE AppId = 6 AND IsPreview = false
Update
GraphSettings を更新するには、Reports を集計として指定します。GraphSettings を更新するには、AppId カラムが必須です。
UPDATE GraphSettings SET Reports = '{"Graph1":{"chartType":"BAR","chartMode":"PERCENTAGE","name":"Updated_Graph_Name","index":"0","groups":[{"code":"Created_by"}]}}' WHERE AppId = 6
Columns
| Name | Type | ReadOnly | References | Description |
| AppId | Integer | False |
グラフとレポート設定を取得または更新する対象のkintoneアプリのアプリID。 | |
| Id [KEY] | String | True |
アプリ内のグラフ設定の一意の識別子。 | |
| Index | String | False |
アプリのグラフリスト内でのグラフの位置（0から始まる）。グラフがユーザーに表示される順序を決定します。 | |
| Name | String | False |
グラフの表示名。64文字以下で指定します。langパラメータが指定されている場合、リクエストされた言語で返されます。 | |
| PeriodicReport | String | False |
グラフの定期レポート設定を含むオブジェクト。定期レポートが設定されていない場合は'null'が返されます。 | |
| Sorts | String | False |
グラフデータの並び順を決定する「並び替え」設定を定義するオブジェクトの配列。 | |
| Aggregations | String | False |
グラフ生成時に合計やカウントなど、フィールド値を集計するために使用される関数設定。 | |
| ChartMode | String | False |
グラフに適用される表示モード。インターフェースでグラフがどのようにレンダリングされるかを決定します。 | |
| ChartType | String | False |
グラフに選択されたグラフの種類（棒グラフ、折れ線グラフ、円グラフ、その他のサポートされている可視化形式など）。 | |
| FilterCond | String | False |
クエリ文字列形式で表現されたレコードのフィルタ条件。グラフの「絞り込み」設定を反映します。 | |
| Groups | String | False |
グラフでレコードをグループ化するために使用される関数設定。集計時にデータがどのように分類されるかを定義します。 | |
| Revision | String | True |
アプリ設定のリビジョン番号。グラフ設定に加えられた更新を追跡するのに役立ちます。 |
Pseudo-Columns
SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| Lang | String |
グラフ設定の値を特定の言語で取得するためのロケールコード。 |
| IsPreview | Boolean |
グラフ設定の詳細を動作テスト環境から取得するか（'true'）、運用環境から取得するか（'false'）を示します。デフォルト値は'true'です。 |
| Reports | String |
更新実行時に変更されたグラフレポート設定を提供するためにのみ使用される値。 |