Kartenquellen für geomap-Datenvisualisierungen

GeoMap-Datenvisualisierungen sind mit Positionstabellen in einer speziellen Kartenquelle verbunden.

Kartenquellen für Geomaps sind in Kartenquellhierarchien organisiert. Alle Zuordnungsquellen, die auf dieselbe Tabelle verweisen, befinden sich in derselben Hierarchie. Eine Zuordnungsquellhierarchie besteht aus einer übergeordneten Quelle und bis zu vier Ebenen von untergeordneten Quellen. Die übergeordnete Quelle verweist nur auf die Tabelle und die Referenzfelder der untergeordneten Quellen in der Tabelle.

Standardmäßig verfügt Ihre Instanz über eine Kartenquellhierarchie für Geomaps, die auf die Tabelle „Standort“ [cmn_location] verweist. Sie können daher ein Feld „Gruppieren nach“ in Ihrer geomap haben, das auf ein Feld in „Standort“ verweist. Das Feld Gruppieren nach kann sich auf der obersten Ebene der Datenquellentabelle befinden, oder Sie können Dot-Walk dazu ausführen. Sie können zusätzliche Kartenquellhierarchien erstellen, die auf anwenderdefinierte Standorttabellen verweisen.

Unterschiede zwischen Kartenquellen für Datenvisualisierungen und für Berichte

Wenn Sie mit dem Zuordnen von Berichten in vertraut sind Core-UI, Möglicherweise haben Sie festgestellt, dass sich die Kartenquellen für Geomaps von Kartenquellen für Kartenberichte unterscheiden. Sie unterscheiden sich genug, um sich in verschiedenen Kartenquellentabellen zu befinden, sys_Report_Map_Source und viz_Map_Source. Der bedeutendste Unterschied besteht darin, wie sie auf Tabellen verweisen.

In Kartenberichten verweist die Kartenquelle auf die Faktentabelle, z. B. Incident [Incident]. Die Kartenquelle enthält auch ein Referenzfeld, das auf die Standorttabelle verweist. Untergeordnete Kartenquellen – Dot-Walk zu einem Feld in der Standorttabelle. Diese Struktur führt zu einer separaten Zuordnungsquellhierarchie für jede Datentabelle, die Sie als Datenquelle für eine Karte verwenden möchten.

Abbildung : 1. Kartenquellen für Kartenberichte

Kartenquellen für Geomaps verweisen direkt auf Standorttabellen. Sie verweisen nicht auf Faktentabellen. Die Faktentabelle wird nur in der geomap-Datenvisualisierung angegeben. Dank dieser Struktur können Sie eine Kartenhierarchie für alle Geomaps in Ihrer Instanz wiederverwenden, unabhängig von den angezeigten Daten.

Abbildung : 2. Kartenquellen für geomap-Datenvisualisierungen

Erstellen Sie eine Datenvisualisierungszuordnungsquelle

Um eine anwenderdefinierte Positionstabelle in geomap-Datenvisualisierungen zu verwenden, definieren Sie eine Kartenquelle, die mit der Tabelle verknüpft ist. Fügen Sie weitere Kartenquellen auf verschiedenen Ebenen der Hierarchie hinzu.

Vorbereitungen

Erforderliche Rolle: Report_admin, VIZ_admin, PA_admin

Warum und wann dieser Vorgang ausgeführt wird

Prozedur

1. Anfügen viz_Map_Source_list.do An Ihre Instanz-URL im Feld „Browser-URL“.
   Beispiel: Wenn Ihre Instanz ist https://instance.example.com , Eingabetaste https://instance.example.com/viz_map_source_list.do .
2. Überprüfen Sie, ob die Standorttabelle, auf die Sie verweisen möchten, bereits in einer Kartenquelle verwendet wird.
   Der Satz von Kartenquellen, die auf dieselbe Tabelle verweisen, wird als bezeichnet Quellenhierarchie zuordnen .
3. Wenn keine Kartenquellen vorhanden sind, die auf die gewünschte Standorttabelle verweisen, erstellen Sie die Kartenquelle der obersten Ebene für diese Tabelle:
   1. Wählen Sie Neu.
      Ein leerer Datensatz der Kartenquelle [VIZ_Map_Source] wird geöffnet.
   2. Geben Sie die folgenden Informationen an:

      Feld	Beschreibung
      Name	Fügen Sie einen Namen für die Kartenquelle hinzu. Verwenden Sie einen beschreibenden Namen, der den Tabelleninhalt vorschlägt. Schließen Sie diesen Namen als Teil der Namen aller anderen Kartenquellen ein, die Sie in dieser Hierarchie erstellen.
      Tabelle	Wählen Sie eine Standorttabelle aus, die noch nicht in einer Datenvisualisierungszuordnungsquelle verwendet wird. Die von Ihnen ausgewählte Tabelle darf auch nicht auf eine Tabelle wie cmn_location verweisen, die bereits in einer Datenvisualisierungszuordnungsquelle verwendet wird.

   3. Wählen Sie Absenden.
   Sie haben jetzt die übergeordnete Kartenquelle einer neuen Kartenquellhierarchie. Sie können der Hierarchie weitere Ebenen hinzufügen.
4. Wenn eine Kartenquellhierarchie für Ihre Tabelle vorhanden ist, öffnen Sie die Kartenquelle, die sich eine Ebene über der Kartenquelle befindet, die Sie erstellen möchten.
   Hinweis:

   Sie können nicht mehr als vier Ebenen der Kartenquelle unter dem übergeordneten Element der obersten Ebene haben.
5. In Zuordnungsquellen Zugehörige Liste, wählen Sie aus Neu .
   Ein neuer Kartenquelldatensatz [VIZ_Map_Source] wird geöffnet, wobei die Felder „Tabelle“ und „übergeordnetes Element“ schreibgeschützt sind.
6. Geben Sie die folgenden Informationen an:

   Tabelle : 1. Quellfelder zuordnen

   Feld	Beschreibung
   Name	Geben Sie einen Namen für die Kartenquelle ein. Fügen Sie die Ebene in die Namen der Kartenquellenebenen ein. Geben Sie im Allgemeinen allen Kartenquellen in derselben Hierarchie den gleichen Stammnamen. Differenzieren Sie sie nur nach Ebene, z. B. Standortzuordnung (Ebene 2) und Standortzuordnung (Ebene 3).
   Tabelle (schreibgeschützt)	Die gleiche Tabelle wird in der gesamten Kartenquellenhierarchie verwendet und in der Kartenquelle der obersten Ebene angegeben.
   Feld	Wählen Sie ein Feld mit Standortdaten aus, das eine Ebene detaillierter ist als die Karte, auf der Sie sie anzeigen. Stellen Sie sich beispielsweise vor, Sie konfigurieren Daten für eine Kartenquelle der Ebene 1, die auf der Weltkarte angezeigt wird. Da die Daten für Länder auf der Weltkarte angezeigt werden, wählen Sie Standort Land. Wenn Sie Daten konfigurieren, die auf einer Karte von Deutschland oder den USA angezeigt werden sollen, wählen Sie Standort Staat/Provinz. Hinweis: Die Stadt ist die granularste Standortebene, die Sie beim Drilldown in einen Kartenbericht anzeigen können. Beispiel: Wenn Sie Berichte zu verschiedenen Standorten in einer Stadt erstellen und das Kartenquellenfeld der untersten Ebene so definieren möchten, dass es location.name enthält, zeigt der Kartenbericht die verschiedenen Standorte als entsprechende Stadtbeschriftungen an. Daher führt die Berichterstellung an mehreren Standorten mit demselben location.city-Wert zur Anzeige mehrerer Kartenpunkte mit demselben Label, aber mit unterschiedlichen zusammengefassten Werten, die zu verschiedenen Standorten führen.
   Ebene	Wählen Sie eine Hierarchieebene für diese Kartenquelle aus. Sie müssen eine Ebene auswählen, die eine Ebene niedriger als die Ebene der übergeordneten Kartenquelle ist. Sie können maximal vier Ebenen haben. Jede Kartenquellenebene entspricht einer Drillebene in der Kartenhierarchie, und diese Ebenen stimmen weitgehend überein. In einer Hierarchie kann jeweils nur eine Kartenquelle derselben Ebene vorhanden sein.
   Aktiv	Deaktivieren Sie diese Checkbox, damit diese Kartenquelle beim Erstellen von Kartenberichten nicht verfügbar ist.

7. In Datentransformation Geben Sie die folgenden Informationen an:

   Feld	Beschreibung
   Verwendung von Daten	Wählen Sie aus, wie Daten in dieser Kartenquelle verwendet werden sollen. Daten in Tabelle verwenden: Verwenden Sie die Daten in der ServiceNow AI Platform®, ohne sie zu transformieren. Wählen Sie diese Option aus, wenn die Daten bereits mit den JSON-Schlüsselwerten übereinstimmen, denen Sie zuordnen. Zuordnung verwenden : Der häufigste Anwendungsfall. Transformieren Sie Daten so, dass sie den JSON-Schlüsselwerten entsprechen, denen Sie zuordnen. Wählen Sie für geografische Kartenquellen, die den Schlüssel hc-key geoJSON verwenden, immer diese Option aus. Diese Option kann aus folgendem Grund nicht mit Daten unter der Bundesland-/Kantonsebene verwendet werden Region und Bundesland Ist die Zuordnung der niedrigsten Ebene. Verwenden Sie Breiten- und Längengrad : Wählen Sie diese Option immer für die untere Kartenebene aus, z. B. Ebene 3. Stellen Sie sicher, dass Ihre Daten Breiten- und Längengradwerte enthalten. Warnung: Weil Verwenden Sie Längen- und Breitengrad Option deaktiviert das Drilldown. Wählen Sie diese Option nur auf Kartenquellebenen aus, die die unterste Ebene in einer Hierarchie sind.
   Verwenden Sie diese Zuordnungen	Wenn Sie Zuordnung verwenden ausgewählt haben, wählen Sie eine Zuordnungsgruppe aus, die Sie verwenden möchten. Eine Zuordnungsgruppe ist eine Sammlung von Schlüssel- Wert-Paarzuordnungen, die Daten transformieren. EUm die Zuordnungen in einer Zuordnungsgruppe zu überprüfen, wechseln Sie zur Tabelle Standorte-Zuordnung [sys_report_map_source_mapping]. Beispiel: Wenn Sie den Feldwert umwandeln USA Bis hc-Schlüsselwert USA , Wählen Sie aus Länderzuordnungen , Das die relevante Schlüssel-Wert-Paarzuordnung enthält.

8. Wählen Sie einen JSON-Schlüssel im Abschnitt JSON-Schlüssel aus, um die Kartenquelldaten mit Karten zu verbinden.
   Geografische Karten verwenden normalerweise den hc-Schlüssel.

   Jede geomap verfügt über eine JSON-Definition. Wählen Sie ein JSON-Schlüssel-Wert-Paar aus, dem die Daten zugeordnet werden sollen. Die Daten, die auf der Karte angezeigt werden, müssen mit den JSON-Schlüsselwerten übereinstimmen. Der von Ihnen ausgewählte Schlüssel bestimmt also, ob Sie Ihre Daten mit den Einstellungen im Abschnitt So benutzen Sie Daten umwandeln müssen. Alle Standard-Plattform-Karten und -Zuordnungen verwenden den hc-Schlüssel geoJSON und Werte der ISO 3166-Norm. Für benutzerdefinierte Karten können Sie einen anderen JSON-Schlüssel eingeben.

9. Wählen Sie Aktualisieren.