• 製品
  • 関連ドキュメント
  • リソース

「カレンダー」コントロールをセットアップする

「カレンダー」コントロールを使用すると、1 つの日付または日付範囲でチャートをフィルタリングできます。

「カレンダー」コントロールのセットアップには、主に次の 2 つの手順が必要です。

  1. ダッシュボードに「カレンダー」コントロールを作成します。

  2. 「カレンダー」コントロールをチャートに接続します。

「カレンダー」コントロールを作成する

ダッシュボードに「カレンダー」コントロールを追加する方法は次のとおりです。

  1. 「カレンダー」コントロールを追加するダッシュボードを開きます。

  2. ダッシュボードのサイドバーから [Add control] > [Calendar] を選択します。コントロールを設定するためのポップアップが表示されます。

  3. オプションで、コントロールの [Name] を変更します。

  4. [Calendar type (カレンダー タイプ)] では、チャートを 1 つの日付で絞り込むか、日付範囲で絞り込むかを選択します。

  5. 固定の日付を使用して [Default start and end] の日付を編集するか、動的フィルタリングに相対日付変数および日付と時刻の関数の組み合わせを使用します。

  6. 追加 を選択します 。

  7. 新しく作成した「カレンダー」コントロールをダッシュボードのどこかに配置します。

「カレンダー」コントロールをチャートに接続する

「カレンダー」コントロールを作成したら、フィルターに使い始める前に、そのコントロールをチャートに接続する必要があります。クエリで対応するダッシュボード変数を使用することで、チャートに接続します。

他の Visual SQL ステップでコントロールを接続することもできます。クエリ以外でコントロールを接続する方法の詳細をご確認ください。

チャートに手動で接続する

ビジュアル モード クエリの場合

ビジュアル モード クエリを使用して「カレンダー」コントロールをチャートに接続する方法は次のとおりです。

  1. 新しいチャートを作成するか、ダッシュボードの既存チャートを編集して、チャート エディターを開きます。

  2. ビジュアル モード クエリの [Filters] セクションで以下を実行します。

    1. コントロールでフィルタリングする日付列を追加します。

    2. フィルター演算子を選択します。多くの場合は間かつ含むを使用します。

    3. ダッシュボード変数を使用してコントロールを参照します。

      • コントロールの [Data type] が [Date] の場合は、{CALENDAR_NAME} を使用します。

      • コントロールの [Data type] が [Data range] の場合、開始日と終了日のそれぞれに {CALENDAR_NAME.START}{CALENDAR_NAME.END} を使用します。

      • CALENDAR_NAME をコントロールの名前に置き換えます。

  3. [Run query] を選択します。結果テーブルは、データに新しいフィルターが適用された状態で更新されます。

  4. チャートを保存するには、[Save to dashboard] を選択します。

「カレンダー」コントロールを使用して、ビジュアル モード クエリで [Created At] 列をフィルタリングします。

SQL モード クエリの場合

ダッシュボード変数を参照することで、SQL モード クエリの「カレンダー」コントロールを接続します。

  • コントロールの [Data type] が [Date] の場合は、{CALENDAR_NAME} を使用します。

  • コントロールの [Data type] が [Data range] の場合、開始日と終了日のそれぞれに {CALENDAR_NAME.START}{CALENDAR_NAME.END} を使用します。

CALENDAR_NAME をコントロールの名前に置き換えます。

これは「カレンダー」コントロールの選択した日付の間に作成された Jira 課題の総数を取得する方法の例です。

1 2 3 SELECT COUNT(DISTINCT `Issue`.`issue_id`) AS `Count of unique Issue ID` FROM `jira_issue` AS `Issue` WHERE `Issue`.`created_at` BETWEEN {CALENDAR_NAME.START} AND {CALENDAR_NAME.END};

チャートがコントロールに接続されていることを確認する

チャートがコントロールに正しく接続されていることを確認するには、コントロールの値を更新し、接続されているチャートがその値に応じてフィルタリングされるかどうかを見ることで、接続が適切かを確認できます。

他にも、コントロールに接続されているすべてのチャートを確認する方法が 2 つあります。

1 つ目のオプションは次のとおりです。

  1. コントロールにカーソルを合わせます。

  2. [その他のアクション]() メニュー > [Highlight connections (接続をハイライト)] の順に選択します。

2 つ目のオプションは次のとおりです。

  1. ダッシュボードのサイドバーで [設定] を選択します。

  2. [Controls (コントロール)] タブに移動します。

  3. [Highlight connections (接続をハイライト)] を選択します。

どちらの方法でも、その特定のコントロールに接続されているダッシュボード上のすべての要素が強調表示されます。

その他のヘルプ