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

Pour afficher Strategy à l'aide d'une visualisation de carte, les noms d'emplacements utilisés par ESRI doivent correspondre uniquement aux noms d'emplacements (attributs géographiques) utilisés par Strategy. Cependant, les noms utilisés pour les emplacements géographiques ne sont pas toujours uniques ou les mêmes que ceux qu'ESRI utilise.

• Différents emplacements peuvent avoir le même nom d'emplacement principal et avoir besoin d'un nom d'emplacement secondaire pour les rendre uniques. Par exemple, de nombreux comtés aux États-Unis portent le nom de « Washington ». Ce nom de comté est unique au sein d'un État, mais pas en dehors de l'État, car le nom d'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 unique et différent de Washington GA ou de Washington PA.

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

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

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 des règles décrit les attributs que vous pouvez utiliser pour définir une règle et la résolution des règles 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 de règle

Les règles dans le plug-in sont fusionnées avec les règles dans le fichier de configuration prêt à l'emploi avant l'exécution de la visualisation de la carte ESRI. Si la même règle existe aux deux endroits, la règle dans le plug-in écrase la règle dans le fichier de configuration prête à l'emploi ; sinon, les nouvelles règles dans le 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 d'étendue dans l'une des règles. Si elle trouve un attribut d'étendue dans une règle, la visualisation recherche une correspondance au niveau de l'étendue. Par exemple, une correspondance existerait si étendue = 1 et que la visualisation de la carte ESRI est affichée dans MicroStrategy Desktop ou StrategyWeb, avec ESRI comme serveur de formes de carte. Une correspondance existerait également si étendue = 2 et que la visualisation de la carte ESRI est affichée sur un appareil mobile. En l'absence d'attribut d'étendue pour une règle, la règle s'applique à tous les serveurs de formes de carte. En cas d'incompatibilité entre l'étendue et l'environnement où 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 l'étendue ou aucun attribut d'étendue.

2. La visualisation examine ensuite chaque ligne de données, en vérifiant s'il y a une correspondance avec le nom de l'emplacement principal dans la Strategy des données (la valeur de l'attribut n) dans l'une des règles (nœuds <elem>). Si elle ne trouve pas de correspondance, elle passe à la ligne de données suivante et recherche une nouvelle fois une correspondance de règle sur le nom de l'emplacement principal. Si elle trouve une correspondance, elle filtre les règles pour inclure uniquement celles qui ont une correspondance au niveau du nom de l'emplacement principal dans la ligne de données actuelle.

3. S'il y a une seule règle de conversion de nom correspondante, la visualisation l'applique. Il substitue le nom de l'emplacement fourni comme valeur du nœud <elem> au nom de l'emplacement principal dans Strategy data (valeur de l'attribut n). S'il y a plusieurs règles, la visualisation de carte tente d'appliquer d'abord 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.

• shapeID
• rôle
• sfv

Si elle trouve une règle avec une correspondance sur l'attribut shapeID, la visualisation l'applique immédiatement ; Sinon, elle recherche une règle avec l'attribut de rôle. Il continue 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 affiché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 Strategy données), elle doit utiliser le nom « Russie démocratique » pour obtenir des données à partir du serveur de la 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 forme. Il n'y a aucun attribut d'étendue.

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 Strategy données), elle doit utiliser le nom « Fédération de Russie » pour obtenir des données à partir du serveur de formes ESRI.

Cette règle a un attribut d'étendue qui restreint l'application de la règle à une visualisation de carte avec ESRI comme serveur de forme.

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 Strategy données), elle doit utiliser le nom « Russie démocratique » pour obtenir des données à partir du serveur de forme ESRI.

Cette règle a deux attributs, étendue et formeId, qui restreignent l'application de la règle. L'attribut d'étendue restreint la règle à une visualisation de carte avec ESRI comme serveur de forme, 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 le pays comme attribut géographique principal voit le nom « Russie » (dans Strategy données), elle doit utiliser le nom « Fédération de Russie » pour obtenir des données à partir du serveur de formes ESRI.

Cette règle possède trois attributs : étendue, formeId et rôle, qui restreignent l'application de la règle. L'attribut d'étendue restreint la règle à une visualisation de carte avec ESRI comme serveur de forme, l'attribut shapeId restreint la règle aux cartes avec les frontières des pays du monde et l'attribut de rôle restreint la règle aux cartes avec Pays 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 la Strategy données), il doit utiliser le nom « Comté de Fairfax » au lieu de « Fairfax » pour obtenir des données à partir du serveur de la forme.

Cette règle possède deux attributs, sfv et rôle, qui restreignent l'application de la règle. L'attribut sfv restreint la règle aux données de l'État de Virginie et l'attribut rôle restreint la règle aux cartes avec le comté comme attribut géographique principal. Il peut obtenir des données à partir de n'importe quel serveur de forme, car il n'a pas d'attribut d'étendue.

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 « Virginia » comme État (dans la Strategy données), il doit utiliser le nom « Comté de Fairfax » au lieu de « Fairfax » pour obtenir des données à partir du serveur de la forme.

Cette règle possède deux attributs, sfv et shapeId, qui restreignent l'application de la règle. 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 contenant les frontières 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 » pour le comté et « VA » pour l'État (dans la Strategy données), il doit utiliser le nom « Comté de Fairfax » au lieu de « Fairfax » pour obtenir des données à partir du serveur de la forme.

Cette règle possède deux attributs, sfv et shapeId, qui restreignent l'application de la règle. L'attribut sfv restreint la règle aux données de l'État avec l'abréviation VA (Virginia), et l'attribut shapeId restreint la règle aux cartes avec les frontières 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 « USA » comme pays (dans la Strategy données), 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 rôle, qui restreignent l'application de la règle. L'attribut sfv restreint la règle au pays États-Unis et l'attribut rôle restreint la règle aux cartes contenant le pays 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 la Strategy données), 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 rôle, qui restreignent l'application de la règle. L'attribut sfv restreint la règle au pays États-Unis et l'attribut rôle restreint la règle aux cartes contenant le pays 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 la Strategy data), elle doit utiliser la chaîne « New Delhi » au lieu de « Delhi » pour obtenir des données à partir du serveur de la forme.

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

Exemples de résolution de règles

Il existe 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 d'emplacement principal « Russie », sans autre restriction.

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

• La règle 3 s'applique au nom de l'emplacement « Russie », mais est encore plus restrictive. Cela restreint l'application de la règle aux visualisations avec ESRI comme serveur de forme de carte (étendue = « 1 », mais elle restreint également l'application aux données rendues avec les frontières du nom de l'État américain (shapeId = « 400 »).

• La règle 4 s'applique au nom d'emplacement « Russie », mais elle est la plus restrictive. Elle restreint l'application de la règle aux visualisations avec ESRI comme serveur de forme (étendue = « 1 ») et aux données rendues avec les frontières du nom de l'État américain (shapeId= « 400 »), mais elle restreint également l'application aux visualisations avec Pays comme zone géographique principale attribut (rôle = « 3 »)

Vous trouverez ci-dessous des exemples de résolution de règle pour le nom « Russie » utilisant les 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 remplacer 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 avec la Russie comme nom d'emplacement, car il s'agit d'une règle universelle qui s'applique à toute visualisation de carte.

• Si la règle 1 et la règle 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 a un attribut d'étendue, et une règle avec une étendue a toujours priorité sur une règle universelle. Si ESRI est le serveur de forme pour la visualisation de carte (il y a une correspondance sur l'étendue), 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 la règle 1, la règle 2 et la règle 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. Son attribut de forme est plus restreint qu'une simple restriction d'étendue. Si ESRI est le serveur de forme pour la visualisation de carte (il y a une correspondance sur l'étendue) et que le fichier de forme actuel est « Pays du monde » (shapeId="400 »), la règle 3 sera appliquée à toute ligne de données avec ' Russie' comme nom d'emplacement ; sinon, elle 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 restreint qu'une simple restriction d'étendue. Si ESRI est le serveur de forme pour la visualisation de carte (il y a une correspondance sur l'étendue) et que le fichier de forme actuel est « Pays du monde » (shapeId="400 »), la règle 3 sera appliquée à toute ligne de données avec ' Russie' comme nom d'emplacement ; sinon, il appliquera la Règle 1 du fichier de configuration de conversion de nom prêt à l'emploi.

• Si la règle 1, la règle 2, la règle 3 et la règle 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. Son attribut de rôle est plus restreint qu'un attribut de forme. Si ESRI est le serveur de forme pour la visualisation de carte (il y a une correspondance sur l'étendue) et que l'attribut géographique est « Pays » (rôle="3 ), la règle 4 sera appliquée à toutes les lignes de données avec « Russie » nom de l'emplacement (valeur de l'attribut géographique principal) ; sinon, elle tentera d'appliquer la règle 3. Si la règle 3 échoue, elle tentera d'appliquer la règle 2, et si la règle 2 échoue, elle appliquera la règle 1 du plug-in.