ジオマップデータ可視化のマップソース

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

ジオマップのマップ ソースは、マップ ソース階層に整理されます。同じテーブルを参照するすべてのマップ ソースは、同じ階層内にあります。マップ ソース階層は、親ソースと最大 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. [新規] を選択します。
      空のマップソース [viz_map_source] レコードが開きます。
   2. 次の情報を指定します。

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

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

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

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

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

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

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

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

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

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