Auflösen von Unterschieden in Ortsnamen

Um MicroStrategy-Daten unter Verwendung einer Karten-Visualisierung anzuzeigen, müssen die Standortnamen, die von ESRI verwendet werden, eindeutig den Standortnamen (Geo-Attribut) entsprechen, die von MicroStrategy verwendet werden. Die Namen, die für geografische Standorte verwendet werden, sind nicht immer eindeutig oder die gleichen, die von ESRI verwendet werden.

• Unterschiedliche Standorte können über denselben primären Standortnamen verfügen und benötigen einen sekundären Standortnamen, um sie eindeutig zu machen. Viele Landkreise in den USA haben den Namen „Washington“. Dieser Name eines Landkreises ist innerhalb eines Staats eindeutig, nicht jedoch außerhalb des Staates, da der primäre Standortname in mehreren Staaten vorkommt. Um solch einen Landkreis eindeutig zu identifizieren, müssen Sie ihn mit dem Namen des Staates qualifizieren. Wenn Sie dies tun, wird „Washington AL“ eindeutig unterschieden von „Washington GA“ oder „Washington PA“.

• Manchmal verwendet ESRI Standortnamen, die sich von den in MicroStrategy verwendeten Namen unterscheiden. Beispielsweise bezieht sich ESRI bei dem Land Russland auf „Russian Federation“ (Russische Föderation), wohingegen MicroStrategy dies als „Russia“ (Russland) bezeichnet.

Um Unterschiede in Standortnamen aufzulösen, verwendet MicroStrategy eine Konfigurationsdatei namens mapNameConversions.xml. In dieser Konfigurationsdatei können Sie Regeln definieren, die es Ihnen ermöglichen, MicroStrategy-Standortnamen den Standortnamen zuzuordnen, die von Mapping-Anbietern verwendet werden, wenn es Abweichungen gibt, und bei Bedarf sekundäre Standortnamen zu der Übereinstimmung hinzuzufügen. Sie können die Anwendung der Regel auf bestimmte Kartierungslieferanten (Kartenform-Server), auf Karten mit einer bestimmten Art Begrenzung und auf Karten beschränken, die ein bestimmtes Geo-Attribut für die Kartierung verwenden.

Das Out-of-the-Box mapNameConversions.xml Datei ist unten gezeigt. Es hat eine Regel, dargestellt durch ein <elem> Knoten.

<?xml version="1.0" encoding="UTF-8"?>       
<nameConversions>     
<!-- 
  Scope for ESRI - 1 
  Scope for MSTR - 2 
  Scope for Mapbox - 4
-->     
<elem id="1" n="Russia" scope="1">Russian Federation</elem>      
</nameConversions> 

Um Regeln zu überschreiben, die in der vorkonfigurierten Konfigurationsdatei für die Namenskonvertierung festgelegt sind, und neue Regeln hinzuzufügen, erstellen Sie eine benutzerdefinierte mapNameConversions.xml -Datei und fügen Sie sie Ihrem Plug-in hinzu, wie unten beschrieben.

1. Ein ... kreieren mapNameConversions.xml Datei mit dem unten gezeigten Inhalt und fügen Sie sie ein WEB-INF/xml/config in Ihrem Plug-In-Ordner.

   Kopieren

   <?xml version="1.0" encoding="UTF-8"?>   
   <nameConversions>   
   <!--     
     Scope for ESRI - 1       
     Scope for MSTR - 2  
     Scope for Mapbox - 4     
   -->       
   <!--     
   ... add <elem> nodes to define new rules or override existing rules ...       
   -->         
   </nameConversions> 

3. Fügen Sie der Datei Ihre eigenen Regeln hinzu. Jede Regel wird eine separate sein <elem> -Element, das Attribute enthält, die die Regel definieren. Für Hilfe bei der Erstellung der <elem> Elemente, siehe Regeldefinition und Regelauflösung. „Regeldefiniton“ beschreibt die Attribute, die Sie verwenden können, um eine Regel zu definieren, und „Regelauflösung“ erläutert, wie die Regeln angewendet werden.

4. Speichern Sie Ihre Änderungen.

Regeldefiniton

Jede Regel wird durch ein repräsentiert <elem> -Element, das Attribute enthält, die die Regel definieren, wie in der folgenden Tabelle beschrieben:

Regelauflösung

Regeln im Plug-In werden mit Regeln in der integrierten Konfigurationsdatei zusammengeführt, bevor die ESRI-Karten-Visualisierung ausgeführt wird. Wenn dieselbe Regel an beiden Stellen vorliegt, überschreibt die Regel im Plug-In die Regel in der integrierten Konfigurationsdatei; anderenfalls werden die neuen Regeln im Plug-In den integrierten Regeln hinzugefügt.

Die Attribute sfv und ShapeId werden in Flash-Karten unterstützt, aber nicht in DHTML.

1. Nachdem die Regeln zusammengeführt wurden, sucht die Visualisierung zunächst in allen Regeln nach einem scope-Attribut. Sollte ein scope-Attribut in einer Regel gefunden werden, sucht die Visualisierung nach einer Entsprechung zu „scope“. Es würde beispielsweise eine Entsprechung vorliegen, wenn „scope = 1“ ist und die ESRI-Karten-Visualisierung in MicroStrategy Desktop oder MicroStrategy Web angezeigt wird, wobei ESRI der Kartenformserver ist. Eine Entsprechung würde auch vorliegen, wenn „scope = 2“ ist und die ESRI-Karten-Visualisierung auf einem mobilen Gerät angezeigt wird. Wenn für eine Regel kein Bereichsattribut vorhanden ist, gilt die Regel für jeden Kartenformserver. Wenn der Umfang und die Umgebung, in der die Visualisierung angezeigt wird, nicht übereinstimmen, wird die Regel ignoriert. Die Visualisierung filtert die Regeln so, dass nur diejenigen eingeschlossen werden, die eine Übereinstimmung mit dem Bereichsattribut oder kein Bereichsattribut haben.

2. Dann durchsucht die Visualisierung jede Zeile mit Daten und überprüft, ob es in irgendwelchen Regeln (<elem>-Knoten) eine Übereinstimmung zum primären Standortnamen in den MicroStrategy-Daten gibt (der Wert des n-Attributs). Wenn es keine Übereinstimmung findet, geht es zur nächsten Datenzeile und sucht erneut nach einer Regelübereinstimmung für den primären Standortnamen. Wird eine Übereinstimmung gefunden, werden die Regeln gefiltert, um nur diejenigen einzuschließen, die über eine Übereinstimmung zum primären Standortnamen in der aktuellen Zeile mit Daten aufweisen.

3. Gibt es nur eine übereinstimmende Namenskonvertierungsregel, wendet die Visualisierung diese an. Sie ersetzt den Standortnamen, der als Wert des <elem>-Knotens für den primären Standortnamen in den MicroStrategy-Daten (Wert des n-Attributs) bereitgestellt ist. Gibt es mehrere Regeln, versucht die Karten-Visualisierung, die restriktivste Regel zuerst anzuwenden. Attribute, die verwendet werden, um die Anwendung von Regeln einzuschränken, werden nachfolgend in der Reihenfolge absteigender Einschränkung gelistet.

• shapeID
• Rolle
• sfv

Sollte eine Regel mit einer Übereinstimmung zum shapeID-Attribut gefunden werden, wendet die Visualisierung diese umgehend an; anderenfalls wird nach einer Regel mit einem role-Attribut gesucht. Die Liste mit Attributen wird weiter nach unten durchsucht, bis eine Übereinstimmung gefunden wird. Die Regel wird angewendet, und es wird mit der nächsten Zeile mit Daten fortgefahren.

Beispielregeln

Beispielregeln sind nachfolgend angezeigt:

<elem id="1" n="Russia">Democratic Russia</elem>

<elem id="2" n="Russia" scope="1">Russian Federation</elem>

<elem id="3" n="Russia" scope="1" shapeId="400">Democratic Russia</elem>

<elem id="4" n="Russia" scope="1" shapeId="400" role="3">Russian Federation</elem>

<elem id="5" n="Fairfax" sfv="Virginia" role="9">Fairfax County</elem>

<elem id="6" n="Fairfax" sfv="Virginia" shapeId="600">Fairfax County</elem>

<elem id="7" n="Fairfax" sfv="VA" shapeId="600">Fairfax County</elem>

<elem id="8" n="St. Thomas" sfv="USA" role="3">St. Thomas, Virgin Island</elem>

<elem id="9" n="Saint Thomas" sfv="USA" role="3">St. Thomas, Virgin Island</elem>

<elem id="10" n="Delhi" sfv="India">New Delhi</elem>

Eine Erläuterung zu jeder Beispielregel ist nachfolgend bereitgestellt:

Regel 1:<code><elem id="1" n="Russia">Democratic Russia</elem> </code>

Bedeutung: Immer, wenn eine beliebige Karten-Visualisierung (in den MicroStrategy-Daten) auf den Namen „Russia“ (Russland) trifft, sollte der Name „Democratic Russia“ (Demokratisches Russland) verwendet werden, um Daten vom Formserver zu beziehen.

Dies wird als universelle Regel bezeichnet, da sie, unabhängig vom Formserver, für jede Karten-Visualisierung gilt. Es gibt kein scope-Attribut.

Regel 2:<elem id="2" n="Russia" scope="1">Russian Federation</elem>

Bedeutung: Immer, wenn eine ESRI-Karten-Visualisierung (in den MicroStrategy-Daten) auf den Namen „Russia“ (Russland) trifft, sollte der Name „Russian Federation“ (Russische Föderation) verwendet werden, um Daten vom ESRI-Formserver zu beziehen.

Diese Regel verfügt über ein scope-Attribut, das die Anwendung der Regel auf eine Karten-Visualisierung mit ESRI als dem Formserver einschränkt.

Regel 3: <elem id="3" n="Russia" scope="1" shapeId="400">Democratic Russia</elem>

Bedeutung: Immer, wenn eine ESRI-Karten-Visualisierung mit Grenzen für Länder der Welt (in den MicroStrategy-Daten) auf den Namen „Russia“ (Russland) trifft, sollte der Name „Democratic Russia“ (Demokratisches Russland) verwendet werden, um Daten vom ESRI-Formserver zu beziehen.

Diese Regel verfügt über zwei Attribute – scope und shapeId –, die die Anwendung der Regel einschränken. Das scope-Attribut schränkt die Regel auf eine Karten-Visualisierung mit ESRI als dem Formserver ein und das shapeId-Attribut schränkt die Regel auf Karten mit Grenzen der Länder der Welt ein.

Regel 4: <elem id="4" n="Russia" scope="1" shapeId="400" role="3">Russian Federation</elem>

Bedeutung: Immer, wenn eine ESRI-Karten-Visualisierung mit Grenzen für Länder der Welt und „Country“ (Land) als primäres Geo-Attribut (in den MicroStrategy-Daten) auf den Namen „Russia“ (Russland) trifft, sollte der Name „Russian Federation“ (Russische Föderation) verwendet werden, um Daten vom ESRI-Formserver zu beziehen.

Diese Regel verfügt über drei Attribute – scope, shapeId und role –, die die Anwendung der Regel einschränken. Das scope-Attribut schränkt die Regel auf eine Karten-Visualisierung mit ESRI als Formserver ein, das shapeId-Attribut schränkt die Regel auf Karten mit Grenzen der Länder der Welt ein und das role-Attribut schränkt die Regel auf Karten mit „Country“ (Land) als primärem Geo-Attribut ein.

Regel 5: <elem id="4" n="Fairfax" sfv="Virginia" role="9">Fairfax County</elem>

Bedeutung: Immer, wenn eine Karten-Visualisierung mit „County“ als primärem Geo-Attribut den Namen „Fairfax“ als County-Wert und „Virginia“ als den Wert „State“ (Staat) erkennt (in den MicroStrategy-Daten), sollte der Name „Fairfax County“ anstelle von „Fairfax“ verwendet werden, um Daten vom Formserver zu beziehen.

Diese Regel verfügt über zwei Attribute – sfv und role –, die die Anwendung der Regel einschränken. Das sfv-Attribut schränkt die Regel auf Daten aus dem Staat Virginia ein und das role-Attribut schränkt die Regel auf Karten mit „County“ als dem primären Geo-Attribut ein. Es kann Daten von jedem Formserver beziehen, da kein scope-Attribut vorhanden ist.

Regel 6:<elem id="5" n="Fairfax" sfv="Virginia" shapeId="600">Fairfax County</elem>

Bedeutung: Immer, wenn eine Karten-Visualisierung mit „US zip codes“ (PLZ USA) den Namen „Fairfax“ als County (Landkreis) und „Virginia“ als Staat (in den MicroStrategy-Daten) erkennt, sollte der Name „Fairfax County“ anstelle von „Fairfax“ verwendet werden, um Daten vom Formserver zu beziehen.

Diese Regel verfügt über zwei Attribute – sfv und shapeId –, die die Anwendung der Regel einschränken. Das sfv-Attribut schränkt die Regel auf Daten aus dem Staat Virginia ein und das shapeId-Attribut schränkt die Regel auf Karten mit „US county boundaries“ (Grenzen Landkreis USA) ein.

Regel 7:<elem id="6" n="Fairfax" sfv="VA" shapeId="600">Fairfax County</elem>

Bedeutung: Immer, wenn eine Karten-Visualisierung mit „US counties“ (Landkreise USA) den Namen „Fairfax“ als County (Landkreis) und „VA“ als Staat (in den MicroStrategy-Daten) erkennt, sollte der Name „Fairfax County“ anstelle von „Fairfax“ verwendet werden, um Daten vom Formserver zu beziehen.

Diese Regel verfügt über zwei Attribute – sfv und shapeId –, die die Anwendung der Regel einschränken. Das sfv-Attribut schränkt die Regel auf Daten aus dem Staat mit der Abkürzung VA (Virginia) ein und das shapeId-Attribut schränkt die Regel auf Karten mit „US county boundaries“ (Grenzen Landkreis USA) ein.

Regel 8:<elem id="7" n="St. Thomas" sfv="USA" role="3">St. Thomas, Virgin Island</elem>

Bedeutung: Immer dann, wenn eine Karten-Visualisierung mit „Country“ (Land) als primärem Geo-Attribut den Namen „St. Thomas“ als die Stadt und „USA“ als das Land (in den MicroStrategy-Daten) erkennt, sollte der Name „St. Thomas, Virgin Islands“ anstelle von „St. Thomas“ verwendet werden, um Daten vom Formserver zu beziehen.

Diese Regel verfügt über zwei Attribute – sfv und role –, die die Anwendung der Regel einschränken. Das sfv-Attribut schränkt die Regel auf das Land USA ein und das role-Attribut schränkt die Regel auf Karten mit „Country“ (Land) als dem primären Geo-Attribut ein.

Regel 9:<elem id="8" n="Saint Thomas" sfv="USA" role="3">St. Thomas, Virgin Island</elem>

Bedeutung: Immer dann, wenn eine Karten-Visualisierung mit „Country“ (Land) als primärem Geo-Attribut den Namen „Saint Thomas“ als die Stadt und „USA“ als das Land (in den MicroStrategy-Daten) erkennt, sollte der Name „St. Thomas, Virgin Islands“ anstelle von „St. Thomas“ verwendet werden, um Daten vom Formserver zu beziehen.

Diese Regel verfügt über zwei Attribute – sfv und role –, die die Anwendung der Regel einschränken. Das sfv-Attribut schränkt die Regel auf das Land USA ein und das role-Attribut schränkt die Regel auf Karten mit „Country“ (Land) als dem primären Geo-Attribut ein.

Regel 10:<elem id="9" n="Delhi" sfv="India">New Delhi</elem>

Bedeutung: Immer, wenn eine Karten-Visualisierung die Zeichenfolge „Delhi“ als die Stadt und „India“ (Indien) als das Land (in den MicroStrategy-Daten) erkennt, sollte die Zeichenfolge „New Delhi“ anstelle von „Delhi“ verwendet werden, um Daten vom Formserver zu beziehen.

Diese Regel verfügt über ein sfv-Attribut, das die Anwendung auf die Regel des Landes Indien einschränkt.

Beispiele für Regelauflösung

Es gibt mehrere Rollen für den Standortnamen „Russia“: Regeln 1, 2, 3 und 4.

• Regel 1 ist eine universelle Regel, die für den primären Standortnamen „Russia“ gilt – ohne weitere Einschränkungen.

• Regel 2 gilt für den Standortnamen „Russia“, beschränkt die Anwendung der Regel jedoch auf Visualisierungen mit ESRI als Kartenformserver (scope = „1“).

• Regel 3 gilt für den Standortnamen „Russia“, ist aber noch restriktiver. Sie schränkt die Anwendung der Regel auf Visualisierungen mit ESRI als Map-Shape-Server ein (Scope = „1“), aber sie schränkt auch die Anwendung auf Daten ein, die mit Namensgrenzen von US-Bundesstaaten gerendert werden (shapeId = „400“).

• Regel 4 gilt für den Standortnamen „Russia“, ist aber die restriktivste. Sie schränkt die Anwendung der Regel auf Visualisierungen mit ESRI als Shape-Server (Bereich = „1“) und Daten ein, die mit Namensgrenzen von US-Bundesstaaten gerendert werden (shapeId = „400“), aber sie beschränkt auch die Anwendung auf Visualisierungen mit Land als primärem Geo Attribut (Rolle = "3")

Nachfolgend finden Sie Beispiele zur Regelauflösung für den Namen „Russia“ unter Verwendung der vorher beschriebenen Beispielregeln:

• Wenn nur Regel 1 in das Plug-In aufgenommen wird, wird es verwendet, um Regel 1 in der integrierten Namenskonvertierungskonfigurationsdatei zu überschreiben. Regel 1 aus dem Plug-In wird auf alle Zeilen mit Daten mit „Russia“ als dem Standortnamen angewendet, da es eine universelle Regel ist, die für alle Karten-Visualisierungen gilt.

• Wenn sowohl Regel 1 als auch Regel 2 im Plug-in enthalten sind, versucht die Visualisierung zunächst, Regel 2 anzuwenden, da diese restriktiver ist als Regel 1. Regel 2 verfügt über ein scope-Attribut und eine Regel mit „scope“ hat immer Vorrang vor einer universellen Regel. Wenn ESRI der Shape-Server für die Kartenvisualisierung ist (es gibt eine Übereinstimmung im Umfang), wird Regel 2 auf jede Datenzeile mit „Russland“ als Ortsname angewendet; andernfalls wird Regel 1 aus dem Plug-in angewendet.

• Sind Regel 1, Regel 2 und Regel 3 im Plug-In enthalten, versucht die Visualisierung zunächst, Regel 3 anzuwenden, da sie restriktiver als Regel 2 ist. Vorhanden ist ein shape-Attribut, das restriktiver als eine einfache scope-Einschränkung ist. Wenn ESRI der Shape-Server für die Kartenvisualisierung ist (es gibt eine Übereinstimmung im Umfang) und die aktuelle Shape-Datei „Countries of the world“ (shapeId="400") ist, wird Regel 3 auf jede Datenzeile mit „ Russland“ als Standortname; andernfalls wird es versuchen, Regel 2 anzuwenden. Sollte Regel 2 fehlschlagen, wird Regel 1 aus dem Plug-In angewendet.

• Wenn nur Regel 3 im Plug-in enthalten ist, versucht die Visualisierung zunächst, Regel 3 anzuwenden, da sie restriktiver ist als Regel 1 in der vorkonfigurierten Konfigurationsdatei für die Namenskonvertierung. Regel 3 verfügt über ein shapeId-Attribut, das restriktiver als eine einfache scope-Einschränkung ist. Wenn ESRI der Shape-Server für die Kartenvisualisierung ist (es gibt eine Übereinstimmung im Umfang) und die aktuelle Shape-Datei „Countries of the world“ (shapeId="400") ist, wird Regel 3 auf jede Datenzeile mit „ Russland“ als Standortname; Andernfalls wird Regel 1 aus der vorkonfigurierten Konfigurationsdatei für die Namenskonvertierung angewendet.

• Sind Regel 1, Regel 2, Regel 3 und Regel 4 im Plug-In enthalten, versucht die Visualisierung zunächst, Regel 4 anzuwenden, da sie die restriktivste ist. Vorhanden ist ein role-Attribut, das restriktiver als ein shape-Attribut ist. Wenn ESRI der Shape-Server für die Kartenvisualisierung ist (es gibt eine Übereinstimmung im Bereich) und das Geo-Attribut „County“ (role="3") ist, wird Regel 4 auf jede Datenzeile mit „Russland“ als angewendet Standortname (Wert des primären Geo-Attributs); andernfalls wird es versuchen, Regel 3 anzuwenden. Sollte Regel 3 fehlschlagen, wird versucht, Regel 2 anzuwenden; sollte Regel 2 fehlschlagen, wird Regel 1 aus dem Plug-In angewendet.