...
| Table of Contents | ||
|---|---|---|
|
概要
この機能は、Yellowfinのテキストウェジェットを使用して、事前に定義されたキーワードを入力することで、グラフにレポート名やその説明、レポートで定義されたフィルターなど、動的なレポート値を表示させることができます。
定義済みテキストウィジェットパラメーター
以下のパラメーターを（以下に示す正確な形式で）テキストウィジェットに含めることができます。Yellowfinはグラフのプレビュー時に、これらを値に置換します。
| パラメーター | 説明 | ||
| [reportname] | グラフのレポート名を置換します。レポート名は、レポート発行時に設定することができます。 | ||
| [reportdescription] | レポートの説明を表示します。レポート発行時に、こちらの説明を提供します。 | ||
| [filter:<filter_order>] | レポートに適用されたフィルターを返すウィジェットパラメーターです。順序を入力することで、任意のフィルターを含めることができます。例えば、[filter:2] は二番目のフィルターを表示します。ただし、指定されたフィルターが値を返さない場合は、デフォルトで（なし）が返されます。 | ||
| [filter:<filter_order>:format=<value>] | この演算子は、未処理の形式、または適用された形式でフィルター値を表示するために使用されます。 <value>には、以下のいずれかのキーワードを使用します。
| ||
| [filter:<filter_order>:empty=<text>] | 空の演算子を使用して、選択したフィルターが値を持たない場合に、表示するテキストを正確に指定することができます。フィルターが空を返す場合に表示するテキストを入力します。 例：[filter:1:empty=No result] - 一番目のフィルターが空の場合、このテキストウィジェットフィルターパラメーターが配置された場所に「No result（結果なし）」と表示されます。 注意：以下の文字をテキストに含めてはいけません。：「:」、 「[」、「]」 | ||
| [total:<column_number>] | カラム（列）フィールドに設定された合計集約値を表示するために使用します。ここでは、カラム（列）がレポート内の順序で指定されます。例えば、[total:3]は、三番目のカラム（列）の合計集約値を表示します。 この値は、レポート内のカラム（列）フィールドの合計に集約タイプが設定されている場合は、その集約タイプに応じて異なります。設定されていない場合は、メトリック（数値）フィールドの場合は合計値を、ディメンション（次元）フィールドの場合は個数の合計を表示します。 | ||
| [total:<column_number>:<aggregation_type>] | これは上記のパラメーターと類似していますが、こちらで指定した集約タイプに応じて、カラム（列）の合計値を表示します。これは、レポートに定義された既存の集約タイプを上書きします。 以下のキーワードを使用して、集約タイプを指定します（これらのキーワードに同じ形式が使用されていることを確認してください。例：すべて大文字） SUM、AVG、MAX、MIN、COUNT、COUNTDISTINCT 例えば、[total:2:AVG]は、二番目のカラム（列）の合計平均を表示します。
| ||
| [parameter:<parameter_order>:format=<value>] | 未処理、または適用された形式で、Yellowfinの一意のパラメーター項目の値を表示するには、こちらの演算子を使用します。（パラメーターフィールドについて、より詳細な情報は、こちらを参照してください） <value>には、以下のいずれかのキーワードを使用します。
| ||
| [parameter:<parameter_order>:empty=<text>] | デフォルトでは、選択されたパラメーターが値を持たない場合、グラフに何も表示しない代わりに、「None（なし）」が表示されます。しかし、空の演算子を使用することで、表示するテキストを正確に選択することができます。 パラメーターが値を持たない場合に表示するテキストを入力します。 例：EMPTY=Details が表示されます。 注意：以下の文字をテキストに含めてはいけません。：「:」、 「[」、「]」 |
注意：
...
パラメーターの追加
...
テキストウィジェットパラメーターを入力します。
| Note |
|---|
テキストウィジェットパラメーターの値を表示するには（例：[reportname]や、[reportdescription]など）、最初にレポートを発行し、形式に詳細を提供しなくてはいけません。それから、編集モードでデザインステップに戻り、パラメーターを使用します。 |
...
下図のように、グラフに追加したテキストウィジェットパラメーターの値が表示されます。
| Note |
|---|
何も表示されない場合は、適応したテキストフィールドパラメーターに値が含まれていることを確認してください。 |
スタイリングの制限
ウィジェットパラメーターキーワードを使用する際には、基礎的なスタイリングを適用してください。受け付けられる形式は以下の通りです。
- スタイリングをしない。例：[reportname]
- 全体的なスタイリング。例：[reportname] または [reportname]
その他の変更は受け付けられません。例：[reportname]