Unterschiede in Standortnamen werden aufgelöst

Um MicroStrategy-Daten unter Verwendung einer Karten-Visualisierung anzuzeigen, müssen die von ESRI verwendeten Standortnamen eindeutig mit den von MicroStrategy verwendeten Standortnamen (Geo-Attribut) übereinstimmen. Allerdings sind die für geografische Standorte verwendeten Namen nicht immer eindeutig oder stimmen mit den von ESRI verwendeten Namen überein.

• Verschiedene Standorte können den gleichen primären Standortnamen haben und benötigen einen sekundären Standortnamen, um sie eindeutig zu machen. Beispielsweise tragen viele Countys in den USA den Namen „Washington“. Dieser County-Name ist innerhalb eines Bundesstaates eindeutig, jedoch nicht außerhalb des Bundesstaates, da der primäre Ortsname in mehreren Bundesstaaten existiert. Um ein solches County eindeutig zu identifizieren, müssen Sie es mit dem Namen des Staates qualifizieren. Wenn Sie dies tun, unterscheidet sich Washington AL deutlich von Washington GA oder Washington PA.

• ESRI verwendet manchmal Standortnamen, die sich von den von MicroStrategy verwendeten Namen unterscheiden. Beispielsweise bezeichnet ESRI das Land Russland als „Russische Föderation“, während MicroStrategy es als „Russland“ bezeichnet.

Um Unterschiede in Speicherortnamen aufzulösen, verwendet MicroStrategy eine Konfigurationsdatei namens mapNameConversions.xml. In dieser Konfigurationsdatei können Sie Regeln definieren, mit denen Sie MicroStrategy-Standortnamen den Standortnamen zuordnen können, die von Zuordnungsanbietern verwendet werden, wenn nicht übereinstimmen, und bei Bedarf sekundäre Standortnamen zur Übereinstimmung hinzufügen können. Sie können die Anwendung der Regel auf bestimmte Kartenanbieter (Kartenformserver), auf Karten mit einer bestimmten Art von Grenzen und auf Karten beschränken, die ein bestimmtes Geoattribut für die Kartenerstellung verwenden.

Die sofort einsatzbereite mapNameConversions.xml -Datei ist unten dargestellt. Sie verfügt über eine Regel, dargestellt durch eine <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> 

Erstellen Sie eine benutzerdefinierte Datei, um die in der standardmäßigen Konfigurationsdatei für die Namenskonvertierung festgelegten Regeln zu überschreiben und neue Regeln hinzuzufügen mapNameConversions.xml -Datei und fügen Sie sie wie unten beschrieben zu Ihrem Plug-in hinzu.

1. Erstellen Sie a mapNameConversions.xml Datei mit dem unten gezeigten Inhalt und fügen Sie sie unter 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 ist eine andere <elem> -Element mit Attributen, die die Regel definieren. Hilfe beim Erstellen von <elem> Elemente finden Sie unter Regeldefinition und Regelauflösung. Die Regeldefinition beschreibt die Attribute, die Sie zum Definieren einer Regel verwenden können, und die Regelauflösung erläutert, wie die Regeln angewendet werden.

4. Speichern Sie Ihre Änderungen.

Regeldefinition

Jede Regel wird durch dargestellt <elem> -Element, das Attribute enthält, die die Regel definieren, wie in der Tabelle unten beschrieben:

Regelauflösung

Regeln im Plug-In werden mit Regeln in der vorinstallierten Konfigurationsdatei zusammengeführt, bevor die ESRI-Kartenvisualisierung ausgeführt wird. Wenn an beiden Stellen dieselbe Regel vorhanden ist, überschreibt die Regel im Plug-In die Regel in der vordefinierten Konfigurationsdatei. Andernfalls werden die neuen Regeln im Plug-In zu den vordefinierten Regeln hinzugefügt.

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

1. Nachdem die Regeln zusammengeführt wurden, sucht die Visualisierung zunächst nach einem Bereichsattribut in einer der Regeln. Wenn in einer Regel ein Bereichsattribut gefunden wird, prüft die Visualisierung, ob eine Übereinstimmung im Bereich vorliegt. Eine Übereinstimmung liegt beispielsweise vor, wenn Bereich = 1 und die ESRI-Kartenvisualisierung in MicroStrategy Desktop oder MicroStrategy Web mit ESRI als Kartenform-Server angezeigt wird. Eine Übereinstimmung würde auch vorliegen, wenn der Bereich = 2 ist und die ESRI-Kartenvisualisierung auf einem mobilen Gerät angezeigt wird. Wenn für eine Regel kein Gültigkeitsbereichsattribut vorhanden ist, gilt die Regel für alle Kartenformserver. Wenn eine Nichtübereinstimmung zwischen dem Umfang und der Umgebung besteht, in der die Visualisierung angezeigt wird, wird die Regel ignoriert. Die Visualisierung filtert die Regeln so, dass nur diejenigen eingeschlossen werden, die eine Übereinstimmung hinsichtlich des Bereichs aufweisen oder kein Bereichsattribut haben.

2. Die Visualisierung schaut sich dann jede Datenzeile an und prüft, ob es in einer der Regeln (< Element> Knoten). Wenn keine Übereinstimmung gefunden wird, wechselt es zur nächsten Datenzeile und sucht erneut nach einer Regelübereinstimmung für den primären Standortnamen. Wenn eine Übereinstimmung gefunden wird, werden die Regeln so gefiltert, dass nur diejenigen eingeschlossen werden, die eine Übereinstimmung mit dem primären Standortnamen in der aktuellen Datenzeile aufweisen.

3. Wenn nur eine passende Namenskonvertierungsregel vorhanden ist, wendet die Visualisierung diese an. Ersetzt den als Wert für angegebenen Ortsnamen< Element> -Knoten für den Namen des primären Standorts in den MicroStrategy-Daten (Wert des Attributs n). Wenn mehrere Regeln vorhanden sind, versucht die Kartenvisualisierung zuerst die restriktivste Regel anzuwenden. Attribute, die zum Einschränken der Anwendung von Regeln verwendet werden, sind unten in der Reihenfolge abnehmender Einschränkung aufgeführt.

• Form-ID
• Rolle
• sfv

Wenn eine Regel mit einer Übereinstimmung für das ShapeID-Attribut gefunden wird, wendet die Visualisierung diese sofort an. Andernfalls sucht sie nach einer Regel mit Rollenattribut. Es durchsucht die Liste der Attribute weiter, bis es eine Übereinstimmung findet. Es wendet die Regel an und wechselt zur nächsten Datenzeile.

Beispielregeln

Nachfolgend sind Beispielregeln aufgeführt:

<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>

Nachfolgend finden Sie eine Erläuterung der einzelnen Beispielregeln:

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

Bedeutung: Immer wenn eine Karten-Visualisierung den Namen „Russland“ (in den MicroStrategy-Daten) sieht, sollte sie den Namen „Demokratisches Russland“ verwenden, um Daten vom Form-Server abzurufen.

Dies wird als universelle Regel bezeichnet, da sie für jede Kartenvisualisierung gilt, unabhängig vom Shape-Server. Es gibt kein Scope-Attribut.

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

Bedeutung: Immer wenn eine ESRI-Karten-Visualisierung den Namen „Russland“ (in den MicroStrategy-Daten) sieht, sollte sie den Namen „Russische Föderation“ verwenden, um Daten vom ESRI-Form-Server abzurufen.

Diese Regel verfügt über ein Gültigkeitsbereichsattribut, das die Anwendung der Regel auf eine Kartenvisualisierung mit ESRI als Shape-Server beschrä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 den Namen „Russland“ (in den MicroStrategy-Daten) sieht, sollte sie den Namen „Demokratisches Russland“ verwenden, um Daten vom ESRI-Form-Server abzurufen.

Diese Regel hat zwei Attribute – „Scope“ und „ShapeId“ – die die Anwendung der Regel einschränken. Das Scope-Attribut beschränkt die Regel auf eine Kartenvisualisierung mit ESRI als Shape-Server und das ShapeId-Attribut beschränkt die Regel auf Karten mit Ländergrenzen weltweit.

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 Land als primäres Geo-Attribut den Namen „Russland“ (in den MicroStrategy-Daten) sieht, sollte sie den Namen „Russische Föderation“ verwenden, um Daten aus der ESRI-Form abzurufen Server.

Diese Regel hat drei Attribute – Umfang, Shape-ID und Rolle – die die Anwendung der Regel einschränken. Das Scope-Attribut beschränkt die Regel auf eine Kartenvisualisierung mit ESRI als Shape-Server, das ShapeId-Attribut beschränkt die Regel auf Karten mit Ländergrenzen weltweit und das Role-Attribut beschränkt die Regel auf Karten mit „Land“ als primärem Geo-Attribut.

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

Bedeutung: Immer wenn eine Karten-Visualisierung mit Landkreis als primärem Geo-Attribut den Namen „Fairfax“ als Landkreiswert und „Virginia“ als Bundesstaatswert (in den MicroStrategy-Daten) sieht, sollte sie den Namen „Fairfax County“ anstelle von „“ verwenden. Fairfax“, um Daten vom Form-Server abzurufen.

Diese Regel hat zwei Attribute – sfv und Rolle – die die Anwendung der Regel einschränken. Das Attribut „sfv“ beschränkt die Regel auf Daten aus dem Bundesstaat Virginia und das Attribut „role“ beschränkt die Regel auf Karten mit „County“ als primärem Geoattribut. Es kann Daten von jedem Shape-Server abrufen, da es kein Scope-Attribut hat.

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

Bedeutung: Wenn eine Karten-Visualisierung mit US-amerikanischen Postleitzahlen als Grenzen den Namen „Fairfax“ für den Landkreis und „Virginia“ für den Bundesstaat sieht (in den MicroStrategy-Daten), sollte sie den Namen „Fairfax County“ anstelle von „Fairfax“ verwenden Ruft Daten vom Form-Server ab.

Diese Regel hat zwei Attribute – sfv und shapeId – die die Anwendung der Regel einschränken. Das Attribut „sfv“ beschränkt die Regel auf Daten aus dem Bundesstaat Virginia und das Attribut „shapeId“ beschränkt die Regel auf Karten mit den Grenzen von US-Bundesstaaten.

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

Bedeutung: Immer wenn eine Karten-Visualisierung mit US-amerikanischen Landkreisen als Grenzen den Namen „Fairfax“ für den Landkreis und „VA“ für den Bundesstaat (in den MicroStrategy-Daten) sieht, sollte sie für „Fairfax“ den Namen „Fairfax County“ anstelle von „Fairfax“ verwenden Daten vom Form-Server.

Diese Regel hat zwei Attribute – sfv und shapeId – die die Anwendung der Regel einschränken. Das Attribut „sfv“ beschränkt die Regel auf Daten aus dem Bundesstaat mit der Abkürzung VA (Virginia) und das Attribut „shapeId“ beschränkt die Regel auf Karten mit den Grenzen der US-Bundesstaaten.

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

Bedeutung: Immer wenn eine Karten-Visualisierung mit Land als primärem Geo-Attribut den Namen „St. Thomas“ als Stadt und „USA“ als Land (in den MicroStrategy-Daten) verwendet wird, sollte der Name „St. „Thomas, Jungferninseln“ anstelle von „St. Thomas“, um Daten vom Form-Server abzurufen.

Diese Regel hat zwei Attribute – sfv und Rolle – die die Anwendung der Regel einschränken. Das Attribut „sfv“ beschränkt die Regel auf das Land „USA“ und das Attribut „role“ beschränkt die Regel auf Karten mit „Land“ als primärem Geo-Attribut.

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

Bedeutung: Immer wenn eine Karten-Visualisierung mit Land als primärem Geo-Attribut den Namen „St. Thomas“ für die Stadt und „USA“ als Land (in den MicroStrategy-Daten) sieht, sollte sie den Namen „St. „Thomas, Jungferninseln“ anstelle von „St. Thomas“, um Daten vom Form-Server abzurufen.

Diese Regel hat zwei Attribute – sfv und Rolle – die die Anwendung der Regel einschränken. Das Attribut „sfv“ beschränkt die Regel auf das Land „USA“ und das Attribut „role“ beschränkt die Regel auf Karten mit „Land“ als primärem Geo-Attribut.

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

Bedeutung: Immer wenn eine Karten-Visualisierung die Zeichenfolge „Delhi“ als Stadt und „Indien“ als Land (in den MicroStrategy-Daten) sieht, sollte sie die Zeichenfolge „Neu-Delhi“ anstelle von „Delhi“ verwenden, um Daten vom Form-Server abzurufen .

Diese Regel hat ein SFV-Attribut, das die Anwendung der Regel auf das Land Indien beschränkt.

Beispiele für die Regelauflösung

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

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

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

• Regel 3 gilt für den Ortsnamen „Russland“, ist aber noch restriktiver. Dadurch wird die Anwendung der Regel auf Visualisierungen mit ESRI als Karten-Shape-Server (Bereich = „1“) beschränkt, die Anwendung wird jedoch auch auf Daten beschränkt, die mit den Grenzen der US-Bundesstaatennamen gerendert werden (ShapeId = „400“).

• Regel 4 gilt für den Ortsnamen „Russland“, ist jedoch die restriktivste. Die Anwendung der Regel wird auf Visualisierungen mit ESRI als Shape-Server (Bereich = „1“) und auf Daten beschränkt, die mit den Grenzen der US-Staatsnamen gerendert werden (ShapeId = „400“). Die Anwendung wird jedoch auch auf Visualisierungen mit „Country“ als primärem Geo-Attribut (Rolle = „3“) beschränkt.

Nachfolgend finden Sie Beispiele für die Regelauflösung für den Namen „Russland“ unter Verwendung der oben beschriebenen Beispielregeln:

• Wenn nur Regel 1 im Plug-In enthalten ist, wird sie verwendet, um Regel 1 in der sofort einsatzbereiten Konfigurationsdatei für die Namenskonvertierung zu überschreiben. Regel1 des Plug-Ins wird auf alle Datenzeilen mit Russland als Ortsnamen angewendet, da es sich um eine universelle Regel handelt, die für alle Kartenvisualisierungen gilt.

• Wenn sowohl Regel 1 als auch Regel 2 im Plug-In enthalten sind, versucht die Visualisierung zuerst, Regel 2 anzuwenden, da diese restriktiver ist als Regel 1. Regel 2 hat ein Gültigkeitsbereichsattribut und eine Regel mit Gültigkeitsbereich hat immer Vorrang vor einer universellen Regel. Wenn ESRI der Shape-Server für die Kartenvisualisierung ist (es gibt eine Übereinstimmung im Bereich), wird Regel 2 auf alle Datenzeilen mit „Russland“ als Standortnamen angewendet; andernfalls wird Regel 1 des Plug-Ins angewendet.

• Wenn Regel 1, Regel 2 und Regel 3 im Plug-In enthalten sind, versucht die Visualisierung zuerst, Regel 3 anzuwenden, da diese restriktiver ist als Regel 2. Es verfügt über ein Formattribut, das restriktiver ist als eine einfache Umfangsbeschränkung. Wenn ESRI der Shape-Server für die Kartenvisualisierung ist (es gibt eine Übereinstimmung im Bereich) und die aktuelle Shape-Datei „Länder der Welt“ (shapeId="400") ist, wird Regel 3 auf alle Datenzeilen mit „Russland“ als Ortsnamen angewendet; andernfalls wird versucht, Regel 2 anzuwenden. Wenn Regel 2 fehlschlägt, wird Regel 1 vom Plug-In angewendet.

• Wenn im Plug-In nur Regel 3 enthalten ist, versucht die Visualisierung zunächst, Regel 3 anzuwenden, da diese restriktiver ist als Regel 1 in der sofort einsatzbereiten Konfigurationsdatei zur Namenskonvertierung. Regel 3 hat ein ShapeId-Attribut, das restriktiver ist als eine einfache Bereichsbeschränkung. Wenn ESRI der Shape-Server für die Kartenvisualisierung ist (es gibt eine Übereinstimmung im Bereich) und die aktuelle Shape-Datei „Länder der Welt“ (shapeId="400") ist, wird Regel 3 auf alle Datenzeilen mit „Russland“ als Ortsnamen angewendet; andernfalls wird Regel 1 aus der vordefinierten Konfigurationsdatei zur Namenskonvertierung angewendet.

• Wenn Regel 1, Regel 2, Regel 3 und Regel 4 alle im Plug-In enthalten sind, versucht die Visualisierung zuerst, Regel 4 anzuwenden, da diese am restriktivsten ist. Es verfügt über ein Rollenattribut, das restriktiver ist als ein Formattribut. Wenn ESRI der Shape-Server für die Kartenvisualisierung ist (es gibt eine Übereinstimmung im Bereich) und das Geo-Attribut „County“ (Rolle „3“) ist, wird Regel 4 auf alle Datenzeilen mit „Russland“ als Ortsnamen (Wert des primären Geo-Attributs) angewendet. Andernfalls wird versucht, Regel 3 anzuwenden. Wenn Regel 3 fehlschlägt, wird versucht, Regel 2 anzuwenden, und wenn Regel 2 fehlschlägt, wird Regel 1 vom Plug-In angewendet.