Résolution des différences dans les noms d'emplacements

Pour afficher les données MicroStrategy à l'aide d'une visualisation de carte, les noms d'emplacements utilisés par ESRI doivent correspondre de manière unique aux noms d'emplacements (attributs géographiques) utilisés par MicroStrategy. Cependant, les noms utilisés pour les emplacements géographiques ne sont pas toujours uniques ou identiques à ceux utilisés par ESRI.

• Différents emplacements peuvent avoir le même nom d'emplacement principal et nécessiter un nom d'emplacement secondaire pour les rendre uniques. Par exemple, de nombreux comtés des États-Unis portent le nom de « Washington ». Ce nom de comté est unique au sein d'un État, mais pas en dehors de celui-ci, car le nom de l'emplacement principal existe dans plusieurs États. Pour identifier de manière unique un tel comté, vous devez le qualifier avec le nom de l'État. Lorsque vous faites cela, Washington AL devient particulièrement différent de Washington GA ou Washington PA.

• ESRI utilise parfois des noms d'emplacement différents des noms utilisés par MicroStrategy. Par exemple, ESRI fait référence à la Russie par le terme « Fédération de Russie », tandis que MicroStrategy y fait référence par le terme « Russie ».

Pour résoudre les différences dans les noms d'emplacements, MicroStrategy utilise un fichier de configuration, appelé mapNameConversions.xml. Dans ce fichier de configuration, vous pouvez définir des règles qui vous permettent de mapper les noms d'emplacements MicroStrategy aux noms d'emplacements utilisés par les fournisseurs de mappage en cas d'incompatibilité, et d'ajouter des noms d'emplacements secondaires à la correspondance si nécessaire. Vous pouvez limiter l'application de la règle à des fournisseurs de cartes spécifiques (serveurs de formes de cartes), aux cartes avec un type de limite spécifique et aux cartes qui utilisent un attribut géographique spécifique pour la cartographie.

Le prêt à l'emploi mapNameConversions.xml Le fichier est affiché ci-dessous. Il a une règle, représentée par un <elem> nœud.

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

Pour remplacer les règles définies dans le fichier de configuration de conversion de nom prêt à l'emploi et ajouter de nouvelles règles, créez une clé personnalisée mapNameConversions.xml Fichier et ajoutez-le à votre plug-in, comme indiqué ci-dessous.

1. Créer un mapNameConversions.xml fichier avec le contenu affiché ci-dessous et collez-le sous WEB-INF/xml/config dans votre dossier de plug-ins.

   Copier

   <?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. Ajoutez vos propres règles au fichier. Chaque règle sera séparée <elem> élément qui contient les attributs qui définissent la règle. Pour obtenir de l'aide pour créer <elem> éléments, reportez-vous à Définition de la règle et Résolution de règle. La définition de règle décrit les attributs que vous pouvez utiliser pour définir une règle et la résolution de règle explique comment les règles sont appliquées.

4. Enregistrez vos modifications.

Définition de la règle

Chaque règle est représentée par une <elem> l'élément , qui contient les attributs qui définissent la règle, comme décrit dans le tableau ci-dessous :

Résolution des règles

Les règles du plug-in sont fusionnées avec les règles du fichier de configuration prêt à l'emploi avant l'exécution de la visualisation ESRI Map. Si la même règle existe aux deux endroits, la règle du plug-in écrase la règle du fichier de configuration prêt à l'emploi ; sinon, les nouvelles règles du plug-in sont ajoutées aux règles prêtes à l'emploi.

Les attributs sfv et ShapeId sont pris en charge dans les cartes Flash, mais pas dans DHTML.

1. Une fois les règles fusionnées, la visualisation recherche d'abord un attribut de portée dans l'une des règles. Si elle trouve un attribut de portée dans une règle, la visualisation recherche une correspondance sur la portée. Par exemple, une correspondance existerait si l'étendue = 1 et que la visualisation de la carte ESRI est affichée dans MicroStrategy Desktop ou MicroStrategy Web, avec ESRI comme serveur de forme de carte. Une correspondance existerait également si la portée = 2 et que la visualisation ESRI Map est affichée sur un appareil mobile. S'il n'existe aucun attribut de portée pour une règle, celle-ci s'applique à n'importe quel serveur de formes de carte. S'il existe une inadéquation entre la portée et l'environnement dans lequel la visualisation est affichée, la règle est ignorée. La visualisation filtre les règles pour inclure uniquement celles qui ont une correspondance sur la portée ou aucun attribut de portée.

2. La visualisation examine ensuite chaque ligne de données, pour vérifier s'il y a une correspondance entre le nom de l'emplacement principal dans les données MicroStrategy (la valeur de l'attribut n) et l'une des règles (< élément> nœuds). S'il ne trouve pas de correspondance, il passe à la ligne de données suivante et vérifie à nouveau une correspondance de règle sur le nom de l'emplacement principal. S'il trouve une correspondance, il filtre les règles pour inclure uniquement celles qui correspondent au nom de l'emplacement principal dans la ligne de données actuelle.

3. S'il n'existe qu'une seule règle de conversion de nom correspondant, la visualisation l'applique. Il remplace le nom d'emplacement fourni comme valeur de< élément> nœud pour le nom de l'emplacement principal dans les données MicroStrategy (valeur de l'attribut n). S'il existe plusieurs règles, la visualisation cartographique tente d'appliquer en premier la règle la plus restrictive. Les attributs utilisés pour restreindre l'application des règles sont répertoriés ci-dessous par ordre décroissant de restriction.

• ID de forme
• rôle
• SFV

Si elle trouve une règle avec une correspondance sur l'attribut shapeID, la visualisation l'applique immédiatement ; sinon, il recherche une règle avec un attribut de rôle. Il continue à parcourir la liste des attributs jusqu'à ce qu'il trouve une correspondance. Il applique la règle et passe à la ligne de données suivante.

Exemples de règles

Des exemples de règles sont présentés ci-dessous :

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

Une explication de chaque exemple de règle est fournie ci-dessous :

Règle 1:<elem id="1" n="Russia">Democratic Russia</elem>

Signification : Chaque fois que une visualisation de carte voit le nom « Russie » (dans les données MicroStrategy), elle doit utiliser le nom « Russie démocratique » pour obtenir les données du serveur de forme.

C'est ce qu'on appelle une règle universelle, car elle s'applique à toute visualisation de carte, quel que soit le serveur de formes. Il n’y a pas d’attribut scope.

Règle 2 :<elem id="2" n="Russia" scope="1">Russian Federation</elem>

Signification : Chaque fois qu'une visualisation de carte ESRI voit le nom « Russie » (dans les données MicroStrategy), elle doit utiliser le nom « Fédération de Russie » pour obtenir les données du serveur de formes ESRI.

Cette règle possède un attribut de portée qui restreint son application à une visualisation de carte avec ESRI comme serveur de formes.

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

Signification : Chaque fois qu'une visualisation de carte ESRI avec des frontières pour des pays du monde voit le nom « Russie » (dans les données MicroStrategy), elle doit utiliser le nom « Russie démocratique » pour obtenir des données à partir du serveur de formes ESRI.

Cette règle possède deux attributs (scope et shapeId) qui limitent l'application de la règle. L'attribut scope restreint la règle à une visualisation de carte avec ESRI comme serveur de formes, et l'attribut shapeId restreint la règle aux cartes avec les frontières des pays du monde.

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

Signification : Chaque fois qu'une visualisation de carte ESRI avec des frontières pour les pays du monde et un pays comme attribut géographique principal voit le nom « Russie » (dans les données MicroStrategy), elle doit utiliser le nom « Fédération de Russie » pour obtenir des données à partir de la forme ESRI serveur.

Cette règle possède trois attributs (scope, shapeId et role) qui limitent l'application de la règle. L'attribut scope restreint la règle à une visualisation de carte avec ESRI comme serveur de formes, l'attribut shapeId restreint la règle aux cartes avec les limites des pays du monde et l'attribut role restreint la règle aux cartes avec Country comme attribut géographique principal.

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

Signification : Chaque fois qu'une visualisation de carte avec un comté comme attribut géographique principal voit le nom « Fairfax » comme valeur de comté et « Virginie » comme valeur d'état (dans les données MicroStrategy), elle doit utiliser le nom « Fairfax County » au lieu de « Fairfax' pour obtenir des données à partir du serveur de forme.

Cette règle possède deux attributs (sfv et role) qui limitent son application. L'attribut sfv restreint la règle aux données de l'État de Virginie, et l'attribut role restreint la règle aux cartes avec le comté comme attribut géographique principal. Il peut obtenir des données de n'importe quel serveur de formes puisqu'il n'a pas d'attribut scope.

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

Signification : Chaque fois qu'une visualisation de carte avec des codes postaux américains comme frontières voit le nom « Fairfax » comme comté et « Virginie » comme État (dans les données MicroStrategy), elle doit utiliser le nom « Fairfax County » au lieu de « Fairfax » pour obtenir des données à partir du serveur de forme.

Cette règle possède deux attributs (sfv et shapeId) qui limitent son application. L'attribut sfv restreint la règle aux données de l'État de Virginie, et l'attribut shapeId restreint la règle aux cartes comportant les limites des comtés américains.

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

Signification : Chaque fois qu'une visualisation de carte avec des comtés américains comme frontières voit le nom « Fairfax » comme comté et « VA » comme État (dans les données MicroStrategy), elle doit utiliser le nom « Fairfax County » au lieu de « Fairfax » pour obtenir données du serveur de forme.

Cette règle possède deux attributs (sfv et shapeId) qui limitent son application. L'attribut sfv restreint la règle aux données de l'État portant l'abréviation VA (Virginie), et l'attribut shapeId restreint la règle aux cartes comportant les limites des comtés américains.

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

Signification : Chaque fois qu'une visualisation de carte avec Pays comme attribut géographique principal voit le nom « St. Thomas » comme ville et « États-Unis » comme pays (dans les données MicroStrategy), elle devrait utiliser le nom « St. Thomas, Îles Vierges au lieu de Saint-Thomas pour obtenir les données du serveur de forme.

Cette règle possède deux attributs (sfv et role) qui limitent son application. L'attribut sfv restreint la règle au pays USA, et l'attribut role restreint la règle aux cartes avec Country comme attribut géographique principal.

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

Signification : Chaque fois qu'une visualisation de carte avec le pays comme attribut géographique principal voit le nom « Saint Thomas » comme ville et « États-Unis » comme pays (dans les données MicroStrategy), elle doit utiliser le nom « St ». Thomas, Îles Vierges au lieu de Saint-Thomas pour obtenir les données du serveur de forme.

Cette règle possède deux attributs (sfv et role) qui limitent son application. L'attribut sfv restreint la règle au pays USA, et l'attribut role restreint la règle aux cartes avec Country comme attribut géographique principal.

Règle 10:<elem id="9" n="Delhi" sfv="India">New Delhi</elem>

Signification : Chaque fois qu'une visualisation de carte voit la chaîne « Delhi » comme ville et « Inde » comme pays (dans les données MicroStrategy), elle doit utiliser la chaîne « New Delhi » au lieu de « Delhi » pour obtenir des données à partir du serveur de formes .

Cette règle possède un attribut sfv qui restreint son application au pays de l'Inde.

Exemples de résolution de règles

Il y a plusieurs règles pour le nom d'emplacement « Russie » : règles 1, 2, 3 et 4.

• La règle 1 est une règle universelle qui s'applique au nom de lieu principal « Russie » sans aucune autre restriction.

• La règle 2 s'applique au nom de lieu « Russie », mais restreint l'application de la règle aux visualisations avec ESRI comme serveur de forme de carte (portée = « 1 »).

• La règle 3 s'applique au nom de lieu « Russie », mais est encore plus restrictive. Il restreint l'application de la règle aux visualisations avec ESRI comme serveur de forme de carte (scope = "1"), mais il restreint également l'application aux données rendues avec les limites des noms d'État américains (shapeId = "400").

• La règle 4 s'applique au nom de lieu « Russie », mais elle est la plus restrictive. Elle restreint l'application de la règle aux visualisations avec ESRI comme serveur de formes (scope = "1") et aux données rendues avec les limites des noms d'états américains (shapeId = "400"), mais elle restreint également l'application aux visualisations avec Country comme géolocalisation principale. attribut (rôle = "3")

Vous trouverez ci-dessous des exemples de résolution de règles pour le nom « Russie » à l'aide des exemples de règles décrits ci-dessus :

• Si seule la règle 1 est incluse dans le plug-in, elle sera utilisée pour écraser la règle 1 dans le fichier de configuration de conversion de nom prêt à l'emploi. La règle 1 du plug-in sera appliquée à toute ligne de données comportant la Russie comme nom de lieu, car il s'agit d'une règle universelle qui s'applique à toute visualisation cartographique.

• Si les règles 1 et 2 sont incluses dans le plug-in, la visualisation tentera d'abord d'appliquer la règle 2 car elle est plus restrictive que la règle 1. La règle 2 possède un attribut scope et une règle avec scope est toujours prioritaire sur une règle universelle. Si ESRI est le serveur de formes pour la visualisation de la carte (il existe une correspondance sur la portée), la règle 2 sera appliquée à toute ligne de données avec « Russie » comme nom d'emplacement ; sinon, la règle 1 du plug-in sera appliquée.

• Si les règles 1, 2 et 3 sont incluses dans le plug-in, la visualisation tentera d'abord d'appliquer la règle 3 car elle est plus restrictive que la règle 2. Il possède un attribut de forme qui est plus restrictif qu'une simple restriction de portée. Si ESRI est le serveur de formes pour la visualisation de la carte (il existe une correspondance sur la portée) et que le fichier de formes actuel est « Pays du monde » (shapeId="400"), la règle 3 sera appliquée à n'importe quelle ligne de données avec ' Russie » comme nom de lieu ; sinon, il tentera d'appliquer la règle 2. Si la règle 2 échoue, la règle 1 du plug-in sera appliquée.

• Si seule la règle 3 est incluse dans le plug-in, la visualisation tentera d'abord d'appliquer la règle 3 car elle est plus restrictive que la règle 1 dans le fichier de configuration de conversion de nom prêt à l'emploi. La règle 3 a un attribut shapeId qui est plus restrictif qu'une simple restriction de portée. Si ESRI est le serveur de formes pour la visualisation de la carte (il existe une correspondance sur la portée) et que le fichier de formes actuel est « Pays du monde » (shapeId="400"), la règle 3 sera appliquée à n'importe quelle ligne de données avec ' Russie » comme nom de lieu ; sinon, il appliquera la règle 1 du fichier de configuration de conversion de nom prêt à l'emploi.

• Si les règles 1, 2, 3 et 4 sont toutes incluses dans le plug-in, la visualisation tentera d'abord d'appliquer la règle 4 car elle est la plus restrictive. Il possède un attribut de rôle qui est plus restrictif qu'un attribut de forme. Si ESRI est le serveur de formes pour la visualisation de la carte (il existe une correspondance sur la portée) et que l'attribut géographique est « Comté » (role="3"), la règle 4 sera appliquée à toute ligne de données avec « Russie » comme paramètre. nom de l'emplacement (valeur de l'attribut géographique principal) ; sinon, il tentera d’appliquer la règle 3. Si la règle 3 échoue, il tentera d'appliquer la règle 2, et si la règle 2 échoue, il appliquera la règle 1 du plug-in.