パラメータコントローラー
パラメータコントローラーは、閲覧者がワークシートの内容を調整できるコンポーネントです。1つのパラメータコントローラーから複数のパラメータcodeを作成でき、1つのパラメータcodeは複数のワークシートで使用できます。実際のクエリでは、パラメータコントローラーの値に基づいて対応するパラメータcodeが埋め込まれます。
各パラメータコントローラーには独自の名前とデフォルト値があり、ワークシートのデバッグ結果はデフォルト値に左右されます。編集状態ではデフォルト値を調整できません。
パラメータコントローラーのタイプ
現在、BIダッシュボードでは、日付区間コントローラーとドロップダウンコントローラーの2種類のパラメータコントローラーに対応しています。
日付区間コントローラーでは日付範囲を設定できます。選択できる範囲はダッシュボードや分析モデルと同様で、固定期間、動的期間、または開始が固定で終了が動的な時間範囲があります。
パラメータコントローラーを追加した後、さらにパラメータcodeを設定する必要があります。設定項目は次のとおりです
- パラメータcode：名前です。ワークシートで使用します
- 取得内容：開始日または終了日を選択できます
- 日付format形式：具体的なデータの状況に応じて、適切なformat形式を選択します
- オフセット単位 & オフセット：開始日または終了日を基準にオフセットし、最終結果を得ます
例えば、日付区間コントローラーの日付範囲が2026-02-01～2026-02-28の場合、パラメータcodeの設定条件によって最終結果は次のように異なります
| 取得内容 | 日付format形式 | オフセット単位 | オフセット | 最終結果 |
|---|---|---|---|---|
| 開始日 | yyyy-MM-dd | / | 0 | 2026-02-01 |
| 開始日 | yyyyMMdd | 日 | -1 | 20260131 |
| 終了日 | yyyyMM | 週 | 1 | 202603 |
| 終了日 | yyyy | 年 | -2 | 2024 |
日付区間コントローラーのパラメータcodeは、日付に置換される際に引用符が自動的に付きます。ワークシートでは ${パラメータcode} と直接書くだけでよく、引用符を追加しないでください。'${パラメータcode}' と書くとデバッグ時にエラーになります。
ドロップダウンコントローラーでは単一選択の選択肢を設定できます。各選択肢には選択肢名と内容があります
同様に、パラメータコントローラーを追加した後、パラメータcodeも設定する必要があります。設定項目は次のとおりです
- パラメータcode：名前です。ワークシートで使用します
- 値タイプ：ネイティブまたはテキスト
値タイプがネイティブの場合、システムは内容をそのまま使用して埋め込みます。値タイプがテキストの場合、システムは外側をシングルクォーテーション（''）で囲んでから追加します
ワークシートでのパラメータcodeの使用
設定が完了すると、ワークシートの下部に設定済みのパラメータコントローラーと関連するパラメータcodeが表示されます。マウスをhoverすると、そのパラメータcodeに埋め込まれる内容をプレビューできます。コピーボタンをクリックすると、パラメータcodeをすばやくコピーできます。
ワークシートの該当する位置で${パラメータcode}を使用すると、デバッグ時と実際のクエリ時に対応する値に置換されます
設定されていないパラメータcodeを使用した場合は、メッセージが表示されます
ページ上でのパラメータコントローラーの調整
ページ上で「パラメータコントロール」をクリックして追加し、同じタイプのパラメータコントローラーを選択します。設定後は、BIダッシュボードのプレビュー時や閲覧時に調整できます
ページに追加されていないパラメータコントローラーのパラメータcodeは、デフォルト値のみでクエリされます。ページに追加されたパラメータコントローラーのパラメータcodeの値は、閲覧者の調整に応じて変わります