Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

Table of Contents
classcontents

概要

レポートに表示される数値やテキストベースのデータは、レポートフィールドに参照コードを追加することで、データベースに保持されている値を、より意味のあるものへ変えることができます。このマッピング機能を、「参照コード」と呼びます。参照コード管理ページでは、モデルを通して作成された既存の参照コードを編集することができます。

参照コードの使用

このタイプのマッピングは、以下のような場合に使用します。

...

参照コードは、各フィールド値にコードをマッピングすることで、数値およびテキストベースのデータを含むレポートで、より意味のある値を表示することができます。例えば、「Y」または「N」を含むテキストフィールドをマッピングすることで、「Yes」または「No」と表示できます。

システム管理者は、参照コードページでモデルを通して作成された既存の参照コードを編集できます。

参照コードの使用例

参照コードのマッピングは、あらゆる種類のものに使用できます。以下に例を示します。

  • より説明的なテキストの提供 (上記の「Y」や「N」のような場合)
  • 翻訳された選択肢の提供 (多言語展開を有効にしている場合のみ利用可能)。これは、値を翻訳された同等のものにマッピングすることができます (上記の例では、フランス語の「Oui」や「Non」は、「Yes」や「No」と表示されます)
  • テーブルおよびグラフでカスタマイズされた並べかえを使用 (例えば、次の例で示すように、一部の結果に重みをつけて表示したい場合など)
  • 各値にカスタムカラーを追加
  • 各値にカスタムイメージを追加

カスタマイズされた並べかえを例に挙げてみましょう。データは通常クエリーから英数字順で返されます。データに「Admin Staff」、「Management」、「Executive Management」が含まれる場合、レポート結果は以下のように表示されます。

Admin Staff

500

Executive Management

10

Management

50

...

以下に示す順序のように、好みの並べかえ順に表示したい場合は、要件に合わせて各値に並べかえ順の番号をマッピングできます。以下のように表示するには、「Executive Management」が1、「Management」が2、「Admin Staff」が3と設定します。

Executive Management

10

Management

50

Admin Staff

500

これは、値に対して参照コードを作成し、並び順を指定することで実現できます。

参照コード管理

利用可能な参照コード一覧にアクセスするには「管理」>「管理コンソール」>「参照コード」に移動します。

Image Removed

こちらから、コード名をクリックして「参照コード管理」を開くことで、対象のコードを更新できます。各タブの詳細は、以下の項目を参照してください。

詳細

最初のタブにはコード名の他、設定可能ないくつかの項目が表示されます。

Image Removed

  1. カスタムソート:アルファベット順以外の並び順を適用できます。例えば、January = 1、February = 2と設定することで、月名を時系列で並べかえることができます。
  2. カスタムカラー:フィールドの様々な値に、色を適用することができます。こちらで設定した色は、グラフやフィルターにも適用されることで、値を簡単に識別し、レポートに一貫性を持たせることができます。
  3. カスタムイメージ:フィールドの様々な値に、イメージを適用することができます。こちらで設定したイメージは、「一覧に含む」フィルター使用時に表示され、ユーザーの値選択をサポートします。イメージは、一覧の値の横に表示されます。
  4. 値の空白を削除:フィールドの値の先頭と末尾の空白を削除することができます。
  5. 削除:参照コードを削除します。これは、この参照コードを使用しているフィールドの書式設定をリセットします。

コードに値を定義したり、上述の詳細設定で有効化したオプションの定義をします。

  1. コード: データベースの値で、説明に入力した値に置き換えられます。
  2. 説明:コードの代わりに、レポートやフィルターに表示される値です。

  3. 並べかえ:並べかえをしたときに、値が表示される順序です。
  4. 色:(選択時に)グラフやフィルターに表示される値に適用される色です。
  5. イメージ: (利用可能な場合)フィルターの値の横に表示されるイメージです。

Image Removed

こちらから、元の参照コードを定義する際に追加しなかったコードを追加することができます。必要な値を入力し、「プラス(+)」ボタンをクリックするか(下図参照)、CSVファイルから値をインポートします。

Image Removed

翻訳

Yellowfinに多言語設定をしている場合、参照コードを翻訳したい言語を選択することができます(こちらのタブが表示されない場合は、多言語設定がされていないことになります)。

Image Removed

翻訳された値を編集することもできます。

Image Removed

更新

コードの値を更新する方法を設定します。以下の3つのオプションを使用することができます。

手動:各値を手作業で入力するか、CSVファイルからインポートします。

スケジュール同期:特定のデータソースから定期的に値を同期します。同期する頻度をスケジュール設定することができます。こちらのオプションの使用は、ひとつのフィールドに限定されており、手動更新が必要な場合もあることに注意してください。

...

title展開して設定手順を確認する

データソースから値を同期するスケジュールを設定するには、以下の手順に従います。

...

こちらのオプションの使用は、ひとつのフィールドにのみ限定されていることに注意してください。この場合は、コードと説明の値は同一になります。そのため、タブから手作業で説明を更新しなくてはいけません。

Tip

こちらの更新タスクは、スケジュール管理から実行することもできます。

スケジュールされたクエリー:SQLクエリーを使用して定期的に値を更新します。これはフィールドを作成する最も簡単な方法ですが、SQLの知識が必要です。

...

title展開して設定手順を確認する

SQLクエリーを使用して参照コードフィールドに値を追加するには、以下の手順に従います。

...

Note

クエリー内ではカラム(列)の順序を正確に指定しなくてはいけません。例:コード、言語(多言語設定をしている場合)、説明、並び順(カラム(列)名も正確でなくてはいけません)。

...


...

Tip

こちらの更新タスクは、スケジュール管理から実行することもできます。

使用

こちらのタブにはコードの使用量が表示されます。これは、コードを削除する前に、使用箇所を確認する場合に使用すると便利です。

Image Removed

参照コードの作成

新規参照コードの作成は、以下の手順に従います。

...

参照コードへのアクセス