ジオマップデータを可視化するためのマップソース

ジオマップデータの可視化は、特別なマップソースの場所テーブルに接続されます。

ジオマップのマップソースは、マップソース階層で整理されます。同じテーブルを参照するすべてのマップソースは同じ階層にあります。マップソース階層は、親ソースと最大 4 レベルの子ソースで構成されます。親ソースはテーブルのみを参照し、子ソースはテーブル内のフィールドを参照します。

デフォルトでは、インスタンスには、場所 [cmn_location] テーブルを参照するジオマップのマップソース階層があります。したがって、ロケーションのフィールドを参照する [グループ] フィールドをジオマップ上に持つことができます。[グループ] フィールドは、データソーステーブルの最上位レベルに配置することも、ドット連結することもできます。カスタムの場所テーブルを参照する追加のマップソース階層を作成できます。

データの可視化とレポートのマップソースの違い

コア UIのマップレポートに精通している場合は、ジオマップのマップソースがマップレポートのマップソースとは異なることに気付いたかもしれません。これらは、異なるマップソーステーブル、sys_report_map_source、viz_map_sourceに存在するほど異なっています。最も大きな違いは、テーブルの参照方法です。

マップ レポートでは、マップ ソースはインシデント [incident] などのファクト テーブルを参照します。マップソースには、場所テーブルを指す参照フィールドも含まれています。場所テーブルのフィールドにドット連結する子マップソース。この構造により、マップのデータソースとして必要なすべてのデータテーブルに対して、個別のマップソース階層が作成されます。

図 : 1. マップレポートのマップソース

ジオマップのマップソースは、場所テーブルを直接指しています。ファクトテーブルは参照しません。ファクトテーブルは、ジオマップデータの可視化でのみ指定されます。この構造により、表示されるデータに関係なく、インスタンス上のすべてのジオマップに対して 1 つのマップ階層を再利用できます。

図 : 2. ジオマップデータを可視化するためのマップソース

データの可視化マップソースを作成

ジオマップデータの可視化でカスタムの場所テーブルを使用するには、テーブルにリンクするマップソースを定義します。階層のさまざまなレベルでマップソースを追加します。

始める前に

必要なロール:report_admin、viz_admin、pa_admin

このタスクについて

手順

1. ブラウザーの URL フィールドで、インスタンス URL に viz_map_source_list.do を追加します。
   たとえば、インスタンスが https://instance.example.com の場合は、「 https://instance.example.com/viz_map_source_list.do」と入力します。
2. 参照する場所テーブルがマップソースで既に使用されているかどうかを確認します。
   同じテーブルを参照する一連のマップ ソースは、 マップ ソース階層と呼ばれます。
3. 目的の場所テーブルを参照するマップソースがない場合は、そのテーブルの最上位のマップソースを作成します。
   1. [New (新規)] を選択します。
      空のマップソース [viz_map_source] レコードが開きます。
   2. 次の情報を指定します。

      フィールド	説明
      [Name (名前)]	マップソースの名前を追加します。テーブルの内容を示すわかりやすい名前を使用します。この階層で作成する他のすべてのマップ ソースの名前の一部として、この名前を含めます。
      テーブル	データの可視化マップソースでまだ使用されていない場所テーブルを選択します。また、選択するテーブルは、データの可視化マップソースで既に使用されているテーブル (cmn_location など) を参照してはなりません。

   3. [Submit (送信)] を選択します。
   これで、新しいマップソース階層の親マップソースが作成されました。階層にさらにレベルを追加できます。
4. テーブルのマップソース階層が存在する場合は、作成するマップソースの 1 レベル上にあるマップソースを開きます。
   注:

   最上位の親の下に配置できるマップソースのレベルは 4 つまでです。
5. [ マップソース ] 関連リストで、[ 新規] を選択します。
   新しいマップソース [viz_map_source] レコードが開き、[テーブル] フィールドと [親] フィールドが読み取り専用になります。
6. 次の情報を指定します。

   表 : 1. マップ ソースのフィールド

   フィールド	説明
   名前	マップ ソースの名前を入力します。マップ ソース レベルの名前にはレベルを含めます。通常、同じ階層内のすべてのマップソースに同じルート名を付けます。ロケーションマッピング (レベル 2) やロケーションマッピング (レベル 3) など、レベルでのみ区別します。
   テーブル (読み取り専用)	同じテーブルがマップ ソース階層全体で使用され、最上位のマップ ソースで指定されます。
   フィールド	表示しているマップよりも 1 レベル詳細な場所データのフィールドを選択します。 たとえば、世界地図に表示されるレベル 1 のマップ ソースのデータを構成する場合は、各国のデータを世界地図上に表示するため、[場所：国] を選択します。同様に、都道府県の地図に表示するデータを構成する場合は、[場所：都道府県] を選択します。 注: 市区町村は、マップレポートにドリルダウンするときに表示できる最も詳細な位置レベルです。たとえば、都市内のさまざまな場所のレポートを作成して、最下位のマップ ソース フィールドの定義に location.name を含めた場合、マップ レポートには複数の場所が対応する市ラベルとして表示されます。その結果、同じ location.city の値を持つ複数の場所のレポートを作成すると、ラベルが同じで集計値が異なる複数のマップ ドットが表示され、異なる場所にドリル ダウンされます。
   レベル	このマップ ソースの階層レベルを選択します。親マップソースのレベルより 1 レベル低いレベルを選択する必要があります。最大 4 つのレベルを持たせることができます。マップ ソース レベルはそれぞれ、マップ階層のドリル レベルに対応し、それらのレベルはほとんど一致しています。階層内に同時に存在できるマップソースは、同じレベルの 1 つだけです。
   [Active (アクティブ)]	マップ レポートの作成時にこのマップ ソースを使用できないようにするには、このチェック ボックスをオフにします。

7. [ データ変換 ] セクションで、次の情報を指定します。

   フィールド	説明
   データの使用方法	このマップ ソースでのデータの使用方法を選択します。 テーブルのデータを使用: Now Platform® 内のデータを変換せずに使用します。マッピング先の JSON キー値とデータが既に一致している場合は、このオプションを選択します。 マッピングの使用:最も一般的なユースケース。マッピング先の JSON キー値と一致するようデータを変換します。hc キーの geoJSON キーを使用する地図のマップ ソースの場合は、常にこのオプションを選択します。 リージョンと州は最下位レベルのマッピングであるため、このオプションは州/都道府県レベルより下のデータでは使用できません。 緯度と経度を使用:レベル 3 などの下部のマップ レベルでは常にこのオプションを選択します。データに緯度と経度の値があることを確認します。 警告: [ 経度と緯度を使用 ] オプションではドリルダウンが無効になるため、このオプションは、階層の最下位レベルであるマップソースレベルでのみ選択してください。
   次のマッピングを使用	[マッピングを使用] を選択した場合は 、使用するマッピング グループを選択します。マッピング グループは、データを変換するキーと値のペアのマッピングの集まりです。マッピング グループ内のマッピングを確認するには、[場所マッピング] の [sys_report_map_source_mapping] テーブルに移動します。 たとえば、フィールド値 [米国 ] を hc キー値 [us] に変換する場合は、関連するキーと値のペアのマッピングが含まれている [国のマッピング] を選択します。

8. [JSON キー] セクションで、マップ ソース データをマップに結び付ける JSON キーを選択します。
   地図では通常、hc キーを使用します。

   すべてのジオマップには JSON 定義があります。データのマップ先となる JSON のキーと値のペアを 1 つ選択します。マップに表示するデータは、JSON キー値と一致する必要があります。したがって、選択するキーによって、[データの使い方] セクションの設定でデータを変換する必要があるかどうかが決まります。すべてのデフォルトのプラットフォームマップとマッピングは、 geoJSON hc キーと ISO 3166 標準値を使用します。カスタム マップでは、別の JSON キーを入力できます。

9. [Update (更新)] を選択します。