分析をパラメータ化する

Contour 分析で パラメーター を使用すると、データや結果の異なるビューを簡単に切り替えることができます。例えば、時間と店舗の位置によって食品の販売をリストアップしたデータセットを考えてみましょう。各食品の販売に対して何か分析を行いたいとします。アイテムごとにパスを作成して作業を重複させるのではなく、パラメーターを使って食品のアイテムを切り替えることができます。

パラメーターの作成

インターフェースの左側のサイドバーを使用してパラメーターを作成します。サポートされているタイプは Date、String、Number です。ここでは、デフォルト値が Sandwich の Item パラメーターを作成します。ユーザーがこの分析を開いたとき、Item パラメーターの値はデフォルトで Sandwich になります。エディターやビューアは、他の食品アイテムを調査するためにこのパラメーターを上書きすることを選択できます。

マルチ値パラメーター

パラメーターが複数の値を同時に取ることを可能にするには、パラメーター設定で 複数の値を許可 を切り替えます。このオプションは String と Number パラメーターに対して利用可能ですが、Date パラメーターには利用できません。

マルチ値パラメーターは、Expression Board では、パラメーターに対して1つまたは値が指定されていない場合でも、その値の配列として扱われることに注意してください。パラメーターに対して複数の値を有効にすると、正しいタイプ (配列) が予期されるように、それが使用される表現を更新する必要があるかもしれません。

変換でのパラメーターの使用

パラメーターは、フィルター処理するボードや Expression ボードで使用できます。

各地域での食品アイテムの販売を Pivot Table で視覚化したいとします。まず、アイテムが Item パラメーターの値と等しい行にデータセットをフィルター処理する必要があります。フィルターボードで、下矢印をクリックすると利用可能なパラメーターのリストが表示されます。次に、Item パラメーターを選択します。

他にも、食品アイテムの販売と他のアイテムとの比較を示すチャートを作成したいと考えています。アイテムの販売に対しては True の値、それ以外に対しては False の値を持つ新しい行を作成したいと考えています。

$parameter_name (ドル記号に注意) を参照して、Expression ボードでパラメーターを使用します。以下のように、新しい行を作成するための case when 文を追加することができます。

パラメーターの編集

パラメーターの名前、タイプ、デフォルト値、またはパラメーターが複数の値を受け入れるかどうかを変更したい場合は、鉛筆アイコンをクリックしてパラメーターを編集します。

パラメーターを編集すると、分析を閲覧している全てのユーザーが何を見るかが変わることに注意してください。早くパラメーターの値を試してみたい場合、デフォルトを変更せずに、以下で説明するようにパラメーターの値を上書きします。

提案される値

パラメーターの有効なオプションは、既知のセットから引き出されることがあります。分析に含まれるデータセットまたは制限付きビューの行からリンクするか、値のリストを手動で入力することで、パラメーターに対して提案される値を提供できます。始めるには、パラメーターエディターの下部で リンクされた行から値を提案 を切り替えます。

ここから、または手動で値を入力 を選択して手動の値のセットを追加することができます。これにより、パラメーターに対して自分で提案する値を入力できるダイアログが開きます。

または、行の値にリンク のドロップダウンを開くと、分析の開始ボードに含まれる全てのデータセットと制限付きビューのリストが表示されます。これらのデータセットまたは制限付きビューの上にマウスを置くと、そのリソースの行のネストされたメニューが開きます。

上記のスクリーンショットで使用されているデータセットは、国連食糧農業機関からのオープンソースデータ を使用しています。

行を選択してパラメーターを保存します。パラメーターの概要では、そのパラメーターの入力フィールドを選択すると、提案される値のリストが表示されます。これにより、保存された行から計算された最大1000個の一意の値が提供されます。

クロスフィルターグループ

単一のデータセットまたは制限付きビューの様々な行から派生した複数の文字列パラメーターがある場合、これらのパラメーターはクロスフィルタリンググループに追加できます。クロスフィルタリンググループでは、各パラメーターの選択が他のパラメーターに表示される提案をフィルター処理します。リソースの行にパラメーターをリンクした後、そのパラメーターをグループに追加することができる新しいセクションが表示されます。

ドロップダウンをクリックして 新しいクロスフィルタリンググループを作成 を選択します。グループに名前を入力します (この例では "Location parameters")。パラメーターを保存することを忘れないでください。次に、同じデータセットにリンクされた別のパラメーターを編集し、ドロップダウンから選択してグループに追加することができます。

パラメーターを保存してエディターに戻ります。パラメーターは、"Location parameters" の見出しの下に一緒に表示されます。パラメーターの一つで選択を行い、次に二つ目にクリックします。二つ目の提案される値がそれに応じて更新されます。

1000 個の一意の値の制限は、グループ全体に適用され、グループ内の個々のパラメーターではなく、それに適用されることに注意してください。行のペアが 1000 を超える一意のペアを持つ場合、可能な提案される値の全てが利用可能ではないかもしれません。

パラメーター値の上書き

左側のサイドバーでパラメーター値を手動で入力することで、パラメーターの値を一時的に上書きすることができます。これは、値の変更によって分析がどのように更新されるかを見るために役立ちますが、全てのビューアーに対するデフォルトは更新されません。

この変更を適用した後、パラメーターが Overridden とタグ付けされていることに注意してください。上部バーの矢印を使って、全てのパラメーター値をデフォルトにリセットします。

パラメーター値を上書きすると、ページを更新するまで持続し、他のユーザーが見ることには影響しません。

Contour ダッシュボードのパラメーター

Contour ダッシュボードに追加するボードがパラメーターに依存する場合、そのパラメーターは自動的に Contour ダッシュボードに表示されます。つまり、分析にパラメーターが存在するが、ダッシュボードのボードで使用されていない場合、ダッシュボードには表示されません。

Contour ダッシュボードでは、ユーザーはパラメーターの値を上書きして、データの異なるビューを見ることができます。Contour ダッシュボードについて詳しくはこちら。

Contour ダッシュボードと分析の間で移動するとき、パラメーター値は保持されます。ダッシュボードでパラメーター値を上書きし、その起源パスをより深く調査したい場合は、分析に戻る ボタンをクリックすると、上書きされたパラメーター値が保持されます。

Foundry Reports のパラメーター

Contour 分析内でパラメーターを作成すると、それをレガシーな Foundry Reports アプリケーションでも使用することができます。ただし、Reports は制限付きビューの行にリンクされたパラメーターやクロスフィルターグループをサポートしていません - これらの機能は Contour 分析と Contour ダッシュボードでのみ利用可能です。制限付きビューにリンクしたパラメーターをレポートに追加すると、提案される値は充填されません。Contour のクロスフィルターグループ内の他のパラメーターの選択に基づいてクロスフィルターされない同じデータセット行にリンクされたデフォルトのレポートパラメーターとして、クロスフィルターグループ内のパラメーターをレポートに追加します。