概要

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

参照コードの使用

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

1. データソースに保持されている値を、ビジネス用語に変換したい場合。例えば、性別データが「M」や「F」という表記で保持されている場合、「男性」や「女性」として表示することができます。

2 .特定の順序でフィールドを並べかえたい場合。例えば、通常クエリーで返されるデータは、英数字の昇順に並べかえられます。そのため、「Admin Staff」、「Managers」、「Executive Management」といったデータが含まれている場合は、以下のように表示されます。

Admin Staff	500
Executive Management	10
Management	50

3. 役職の階級を考慮すると、以下のように表示された方が良いでしょう。

Executive Management	10
Management	50
Admin Staff	500

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

参照コード管理

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

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

詳細

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

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

値

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

コード： データベースの値で、説明に入力した値に置き換えられます。
説明：コードの代わりに、レポートやフィルターに表示される値です。
並べかえ：並べかえをしたときに、値が表示される順序です。
色：（選択時に）グラフやフィルターに表示される値に適用される色です。
イメージ： （利用可能な場合）フィルターの値の横に表示されるイメージです。

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

翻訳

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

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

更新

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

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

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

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

1. 値の更新設定方法として、「スケジュール同期」を選択します。

2. 新しい値で既存の値を置き換える場合は、「既存の値の上書き」トグルを有効にします。こちらのトグルを無効にした場合は、既存の値を削除、更新することなく、新しい値が追加されます。

3.値を取得するデータソース、ビュー、フィールドを指定します。

4.値を更新する頻度を設定します。例えば、週次で更新されるように設定することができます。

5.値が更新された時に通知を受信する管理者ユーザーを設定することができます。

6.「保存」ボタンをクリックして、更新を実行します。

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

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

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

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

1. 値の更新設定方法として、「スケジュールされたクエリー」を選択します。

2. 新しい値で既存の値を置き換える場合は、「既存の値の上書き」トグルを有効にします。こちらのトグルを無効にした場合は、既存の値を削除、更新することなく、新しい値が追加されます。

3. 値をインポートするデータソースを選択します。

4. SQLクエリーを記述します。

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

5. クエリー記述時には、「クエリーのヘルプ」を参照できます。

6. ページ下部にある「テストクエリー」ボタンをクリックして、クエリーをテストします。クエリーが有効であれば、メッセージとともに、結果の例が表示されます（テストクエリーボタンは、保存ボタンに変わります）。

7. 値を更新する頻度を設定します。例えば、週次で更新されるように設定することができます。

8. 値が更新された時に通知を受信する管理者ユーザーを設定することができます。

9.「保存」ボタンをクリックして、更新を実行します（スケジュールされたクエリーの設定は、クエリーが有効の場合にのみ保存することができます）。

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

使用

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

参照コードの作成

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

1. 管理コーンソールの参照コード一覧下部にある「追加」ボタンをクリックします。

2. コードを設定します。有効にする機能は、「詳細」タブの説明を参照してください。

3.「値」タブをクリックして、参照コードフィールドに値を追加します。値は手作業で入力することもできますし、「CSVから投入します。」をクリックして、CSVファイルからインポートすることもできます。

4.「更新」タブをクリックして、参照コードの値を定期的に更新するスケジュールを設定することができます。より詳細な情報は、更新項目を参照してください。

5.「保存」をクリックします。