パラメーター置換

概要

この機能は、Yellowfinのテキストウェジェットを使用して、事前に定義されたキーワードを入力することで、グラフにレポート名やその説明など、動的なレポート値を表示させることができます。

定義済みパラメーター

以下のキーワード（以下に示す正確な形式で）をレポートに含めることができます。レポートプレビュー時にYellowfinは、これらのキーワードを値に置換します。

パラメーター	説明
[reportname]	グラフのレポート名を置換します。レポート名は、レポート発行時に設定することができます。
[reportdescription]	レポートの説明を表示します。レポート発行時に、こちらの説明を提供します。
[filter:<filter_order>]	レポートに適用されたフィルターを返します。順序を入力することで、任意のフィルターを含めることができます。例えば、[filter:2] は二番目のフィルターを表示します。ただし、指定されたフィルターが値を返さない場合は、デフォルトで（なし）が返されます。
[total:<column_number>]	カラム（列）フィールドに設定された合計集約値を表示するために使用します。ここでは、カラム（列）がレポート内の順序で指定されます。例えば、[total:3]は、三番目のカラム（列）の合計集約値を表示します。この値は、レポート内のカラム（列）フィールドの合計に集約タイプが設定されている場合は、その集約タイプに応じて異なります。設定されていない場合は、メトリック（数値）フィールドの場合は合計値を、ディメンション（次元）フィールドの場合は個数の合計を表示します。
[total:<column_number>:<aggregation_type>]	これは上記のパラメーターと類似していますが、このパラメーター内で指定した集約タイプに応じて、カラム（列）の合計値を表示します。これは、レポートに定義された既存の集約タイプを上書きします。以下のキーワードを使用して、集約タイプを指定します（これらのキーワードに同じ形式が使用されていることを確認してください。例：すべて大文字） SUM、AVG、MAX、MIN、COUNT、COUNTDISTINCT 例えば、[total:2:AVG]は、二番目のカラム（列）の合計平均を表示します。注意：ディメンション（次元）フィールドには、COUNT、およびCOUNTDISTINCTしか適用することができません。

パラメーターの追加

ページトップ

レポートを作成します（レポート作成について、より詳細な情報は、レポートの作成を参照してください）
注意：「フィルターパラメーター」を使用するためには、レポート作成時に、対応するフィールドをフィルター項目へ追加しなくてはいけません。
グラフを作成したら（2つ以上のグラフを作成する必要があります）、「デザイン」ステップへ移動します。
レフトサイドメニューからキャンバスに、「テキストウィジェット」をドラッグします。
上記の表を参照し、必要なパラメーターを入力します。
一部のパラメーターの値を表示するには（例：[reportname]や、[reportdescription]など）、最初にレポートを発行し、詳細をフォームに提供しなくてはいけません。それから、編集モードでデザインステップに移動し、パラメーターを使用します。
「プレビュー」ボタンをクリックし、レポートのプレビューを表示します。
他にレポートに変更を追加している場合は、これを保存します。
下図のように、グラフに追加したパラメーターがキーワードで置換されて表示されます。
使用しているパラメーターに値が無い場合は、何も表示されません。