• 使用を開始する
  • 関連ドキュメント

「範囲入力」コントロールをセットアップする

Analytics is now Insights

All of the Analytics capabilities of the app remain unchanged. You can continue using your existing dashboards, charts, and smart links alongside the new Rovo-powered features. These features combine work and data context to provide reliable answers, create a shared understanding of data, and build dashboards that your team can depend on.

Read about this change

「範囲入力」コントロールを使用すると、選択した数値範囲に基づいてデータをフィルタリングできます。

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

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

  2. 「範囲入力」コントロールをチャートに接続します。

「範囲入力」コントロールを作成する

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

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

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

  3. 必要に応じてコントロールの設定を編集します。「範囲入力」設定の詳細に関しては、次のセクションをご覧ください。

  4. Optionally, select Connect this control to new and existing charts. Learn more about connecting the control to charts.

  5. 追加 を選択します 。

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


「範囲入力」コントロールの設定

「範囲入力」では次の設定を編集できます。

名前

コントロールの名前

最小値

コントロールの範囲の最小値

最大値

コントロールの範囲の最大値

既定の開始値と終了値

ダッシュボードを開くときに選択する既定値を設定します。

Precision (精度)

範囲の値を選択するときに増加を強制します。


「範囲入力」コントロールをチャートに接続する

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

新しいチャートや既存のチャートに自動で接続する

「範囲入力」が自動的にチャートに接続するには、チャート内のクエリが次の条件を満たす必要があります。

  • ビジュアル モードで構築されている

  • コントロールと同じデータ ソースを使用している

チャートのクエリがこれらの基準を満たしている場合は、ビジュアル モードのクエリにクエリ フィルターが自動で適用されます。

コントロールをすべてのチャートに自動で接続するには、次の手順に従います。

  1. 「範囲入力」コントロールを作成するか、既存の範囲入力コントロールにカーソルを合わせ、[その他のアクション] () > [Edit control (コントロールを編集)] を選択して編集します。

  2. [Connect to new and existing charts (新しいチャートと既存のチャートに接続する)] を選択します。

  3. [データ ソース] と [列] を選択します。「範囲入力」コントロールが選択された列を絞り込みます。

  4. 自動的に適用されるクエリ フィルターで使用する [フィルター演算子] を選択します。使用可能なフィルター演算子の詳細をご確認ください。

  5. [追加] または [保存] を選択して、コントロールへの変更を適用します。

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

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

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

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

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

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

    2. フィルター演算子に [between and including] を選択します。

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

      • 範囲の選択開始点に {RANGE_INPUT_NAME.START} を使用します。

      • 範囲の選択終了点に {RANGE_INPUT_NAME.END} を使用します。

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

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

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

「範囲入力」コントロールを使用して、ビジュアル モード クエリで [ストーリー ポイント] 列をフィルターします。

SQL モード クエリの場合

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

  • 範囲の選択開始点に {RANGE_INPUT_NAME.START} を使用します。

  • 範囲の選択終了点に {RANGE_INPUT_NAME.END} を使用します。

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

これは、ログに記録された作業の合計量が「範囲入力」コントロールの選択された値の間にある、Jira 作業項目 ID のリストを取得する方法の例です。

SELECT `Work item`.`issue_id` AS `Work item ID` FROM `jira_issue` AS `Work item` WHERE `Work item`.`time_spent_secs` BETWEEN {RANGE_INPUT_NAME.START} AND {RANGE_INPUT_NAME.END};

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

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

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

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

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

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

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

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

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

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

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

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。