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

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

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

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

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

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

「範囲入力」コントロールを追加するダッシュボードを開きます。
ダッシュボードのサイドバーから [Add control] > [Range input] を選択します。コントロールを設定するためのポップアップが表示されます。
必要に応じてコントロールの設定を編集します。「範囲入力」設定の詳細に関しては、次のセクションをご覧ください。
オプションで、[Connect this control to new and existing charts (このコントロールを新しいチャートや既存のチャートに接続する)] を選択します。チャートへのコントロールの接続に関する詳細をご確認ください。
追加を選択します。
新しく作成した「範囲入力」コントロールをダッシュボードのどこかに配置します。

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

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

名前

コントロールの名前

最小値

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

最大値

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

既定の開始値と終了値

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

Precision (精度)

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

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

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

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

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

ビジュアルモードで構築されている
コントロールと同じデータソースを使用している

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

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

「範囲入力」コントロールを作成するか、既存の範囲入力コントロールにカーソルを合わせ、[その他のアクション] () > [Edit control (コントロールを編集)] を選択して編集します。
[Connect to new and existing charts (新しいチャートと既存のチャートに接続する)] を選択します。
[データソース] と [列] を選択します。「範囲入力」コントロールが選択された列を絞り込みます。
自動的に適用されるクエリフィルターで使用する [フィルター演算子] を選択します。使用可能なフィルター演算子の詳細をご確認ください。
[追加] または [保存] を選択して、コントロールへの変更を適用します。

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

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

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

新しいチャートを作成するか、ダッシュボードの既存チャートを編集して、チャートエディターを開きます。
ビジュアルモードクエリの [Filters] セクションで以下を実行します。
1. コントロールでフィルタリングする数値列を追加します。
2. フィルター演算子に [between and including] を選択します。
3. ダッシュボード変数を使用してコントロールを参照します。
  - 範囲の選択開始点に {RANGE_INPUT_NAME.START} を使用します。
  - 範囲の選択終了点に {RANGE_INPUT_NAME.END} を使用します。
  - RANGE_INPUT_NAME をコントロールの名前に置き換えます。
[Run query] を選択します。結果テーブルは、データに新しいフィルターが適用された状態で更新されます。
チャートを保存するには、[Save to dashboard] を選択します。

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

SQL モードクエリの場合

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

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

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

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

SELECT "Jira Issue"."issue_id" AS "Issue Id"
FROM "jira _issue" AS "Jira Issue"
WHERE "Jira Issue"."time_spent_secs" BETWEEN {RANGE_INPUT_NAME.START} AND {RANGE_INPUT_NAME.END};

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

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

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

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

コントロールにカーソルを合わせます。
[その他のアクション]() メニュー > [Highlight connections (接続をハイライト)] の順に選択します。

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

ダッシュボードのサイドバーで [設定] を選択します。
[Controls (コントロール)] タブに移動します。
[Highlight connections (接続をハイライト)] を選択します。

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

この内容はお役に立ちましたか?

正確ではなかった

明確ではなかった

関係なかった

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

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

コミュニティに質問