Risoluzione delle differenze nei nomi delle località

Per visualizzare i dati MicroStrategy utilizzando la visualizzazione mappa, i nomi delle località usati da ESRI devono corrispondere in modo univoco ai nomi delle località (attributo geografico) usati da MicroStrategy. Tuttavia, i nomi utilizzati per le località geografiche non sono sempre univoci o uguali a quelli utilizzati da ESRI.

• Posizioni diverse potrebbero avere lo stesso nome di posizione principale e richiedere un nome di posizione secondario per essere univoche. Ad esempio, molte contee degli Stati Uniti si chiamano "Washington". Questo nome di contea è univoco all'interno dello stato, ma non all'esterno dello stato, poiché il nome della posizione principale esiste in più stati. Per identificare in modo univoco una contea di questo tipo, è necessario qualificarla con il nome dello stato. Quando si esegue questa operazione, Washington AL diventa completamente diversa da Washington GA o Washington PA.

• Talvolta ESRI utilizza nomi di località diversi da quelli utilizzati da MicroStrategy. Ad esempio, ESRI si riferisce al Paese come "Federazione Russa", mentre MicroStrategy si riferisce al Paese come "Russia".

Per risolvere le differenze nei nomi delle località, MicroStrategy utilizza un file di configurazione, chiamato mapNameConversions.xml. In questo file di configurazione è possibile definire regole che consentono di mappare i nomi delle sedi MicroStrategy ai nomi delle sedi utilizzate dai fornitori di mappatura in caso di errate corrispondenze e di aggiungere nomi di sedi secondarie alla corrispondenza, quando necessario. È possibile limitare l'applicazione della regola a fornitori di mappature specifici (server di forme mappe), mappe con un tipo specifico di confine e mappe che utilizzano uno specifico attributo geografico per la mappatura.

Pronto all'uso mapNameConversions.xml Il file è mostrato di seguito. Ha una regola, rappresentata da an <elem> nodo.

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

Per ignorare le regole impostate nel file di configurazione della conversione dei nomi predefinito e aggiungere nuove regole, creare un'applicazione personalizzata mapNameConversions.xml e aggiungerlo al plug-in, come descritto di seguito.

1. Crea a mapNameConversions.xml con il contenuto mostrato di seguito e incollarlo in WEB-INF/xml/config nella cartella dei plug-in.

   Copia

   <?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. Aggiungi le tue regole al file. Ogni regola sarà separata <elem> che contiene gli attributi che definiscono la regola. Per informazioni sulla creazione di <elem> elementi, fare riferimento a Definizione regola e Risoluzione delle regole. Definizione regola descrive gli attributi che è possibile utilizzare per definire una regola, mentre Risoluzione regola spiega come vengono applicate le regole.

4. Salvare le modifiche.

Definizione regola

Ogni regola è rappresentata da <elem> che contiene gli attributi che definiscono la regola, come descritto nella tabella seguente:

Risoluzione delle regole

Le regole nel plug-in vengono unite con le regole nel file di configurazione predefinito prima dell'esecuzione della visualizzazione Mappa ESRI. Se la stessa regola esiste in entrambe le posizioni, la regola nel plug-in sovrascrive la regola nel file di configurazione predefinito; in caso contrario, le nuove regole nel plug-in vengono aggiunte a quelle predefinite.

Gli attributi sfv e ShapeId sono supportati nelle mappe Flash, ma non in DHTML.

1. Una volta unite le regole, la visualizzazione cerca prima un attributo di ambito in una qualsiasi delle regole. Se trova un attributo di ambito in una regola, la visualizzazione verifica la presenza di una corrispondenza nell'ambito. Ad esempio, una corrispondenza esisterebbe se ambito = 1 e la visualizzazione Mappa ESRI viene visualizzata in MicroStrategy desktop o MicroStrategy Web, con ESRI come server per le forme della mappa. Una corrispondenza esisterebbe anche se l'ambito = 2 e la visualizzazione Mappa ESRI viene visualizzata su un dispositivo mobile. Se non sono presenti attributi di ambito per una regola, la regola si applica a qualsiasi server forma mappa. In caso di non corrispondenza tra l'ambito e l'ambiente in cui è visualizzata la visualizzazione, la regola viene ignorata. La visualizzazione filtra le regole in modo da includere solo quelle che hanno una corrispondenza nell'ambito o nessun attributo dell'ambito.

2. La visualizzazione esamina quindi ogni riga di dati per verificare se esiste una corrispondenza tra il nome della posizione primaria nei dati di MicroStrategy (il valore dell'attributo n) in una qualsiasi delle regole (nodi <elem>). Se non trova corrispondenze, passa alla riga di dati successiva e verifica nuovamente la presenza di una corrispondenza con la regola per il nome della posizione principale. Se trova una corrispondenza, filtra le regole in modo da includere solo quelle che hanno una corrispondenza nel nome della posizione primaria nella riga di dati corrente.

3. Se esiste solo una regola di conversione del nome corrispondente, verrà applicata dalla visualizzazione. Sostituisce il nome della posizione fornito come valore del nodo <elem> con il nome della posizione principale nei dati MicroStrategy (valore dell'attributo n). Se sono presenti più regole, la visualizzazione mappa cerca di applicare per prima la regola più restrittiva. Gli attributi utilizzati per limitare l'applicazione delle regole sono elencati di seguito in ordine decrescente di restrizione.

• shapeID
• ruolo
• sfv

Se trova una regola con una corrispondenza nell'attributo shapeID, la visualizzazione la applica; in caso contrario, cerca una regola con l'attributo role. Prosegue l'elenco di attributi finché non trova una corrispondenza. Applica la regola e passa alla riga di dati successiva.

Regole di esempio

Di seguito sono riportati alcuni esempi di regole:

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

Di seguito viene fornita una spiegazione di ciascuna regola di esempio:

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

Significato: Ogni volta che una visualizzazione mappa vede il nome "Russia" (nei dati di MicroStrategy ), è consigliabile utilizzare il nome "Russia democratica" per ottenere i dati dallo shape server.

Questa regola è chiamata regola universale perché si applica a qualsiasi visualizzazione mappa, indipendentemente dallo shape server. Non è presente alcun attributo di ambito.

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

Significato: Ogni volta che una visualizzazione Mappa ESRI vede il nome "Russia" (nei dati di MicroStrategy ), è consigliabile utilizzare il nome "Federazione russa" per ottenere i dati dallo shape server ESRI.

Questa regola ha un attributo di ambito che limita l'applicazione della regola alla visualizzazione di una mappa con ESRI come server di forma.

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

Significato: Ogni volta che la visualizzazione della mappa ESRI con i confini dei paesi del mondo vede il nome "Russia" (nei dati di MicroStrategy ), è necessario usare il nome "Russia democratica" per ottenere i dati dallo shape server ESRI.

Questa regola ha due attributi, scope e shapeId, che limitano l'applicazione della regola. L'attributo scope limita la regola a una visualizzazione di mappe con ESRI come server di forma, mentre l'attributo shapeId limita la regola alle mappe con i confini mondiali.

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

Significato: Ogni volta che la visualizzazione della mappa ESRI con confini per Paesi del mondo e Paese come attributo geografico primario vede il nome "Russia" (nei dati di MicroStrategy ), è necessario usare il nome "Federazione Russa" per ottenere i dati dallo shape server ESRI.

Questa regola ha tre attributi (ambito, shapeId e ruolo) che limitano l'applicazione della regola. L'attributo scope limita la regola alla visualizzazione di mappe con ESRI come server di forma, l'attributo shapeId limita la regola alle mappe con i confini mondiali e l'attributo role limita la regola alle mappe con Paese come attributo geografico principale.

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

Significato: Ogni volta che una visualizzazione mappa con Contea come attributo geografico principale vede il nome 'Fairfax' come valore per la contea e "Virginia" come valore per lo stato (nei dati MicroStrategy ), è consigliabile utilizzare il nome "Fairfax County" anziché "Fairfax" per ottenere i dati dal server di forme.

Questa regola ha due attributi, sfv e role, che ne limitano l'applicazione. L'attributo sfv limita la regola ai dati dello stato della Virginia, mentre l'attributo role limita la regola alle mappe con County come attributo geografico primario. Può ottenere dati da qualsiasi server di forme poiché non dispone di attributi di ambito.

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

Significato: Ogni volta che una visualizzazione mappa con codici postali statunitensi come confini vede 'Fairfax' come la contea e "Virginia" come stato (nei dati di MicroStrategy ), è consigliabile utilizzare il nome "Fairfax County" anziché "Fairfax" per ottenere i dati dal server forme.

Questa regola ha due attributi, sfv e shapeId, che ne limitano l'applicazione. L'attributo sfv limita la regola ai dati dello stato della Virginia, mentre l'attributo shapeId limita la regola alle mappe con i confini di contee degli Stati Uniti.

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

Significato: Ogni volta che una visualizzazione di mappa con le contee degli Stati Uniti come confini vede 'Fairfax' come la contea e "VA" come lo stato (nei dati di MicroStrategy ), è necessario utilizzare il nome "Fairfax County" anziché "Fairfax" per ottenere i dati da il server forme.

Questa regola ha due attributi, sfv e shapeId, che ne limitano l'applicazione. L'attributo sfv limita la regola ai dati dello stato con l'abbreviazione VA (Virginia) e l'attributo shapeId limita la regola alle mappe con i confini delle contee degli Stati Uniti.

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

Significato: Ogni volta che una visualizzazione mappa con Paese come attributo geografico principale vede il nome 'St. Thomas" come città e "USA" come Paese (nei dati MicroStrategy ), il nome dovrebbe essere "St. Thomas, Isole Vergini anziché St. Thomas per ottenere i dati dallo shape server.

Questa regola ha due attributi, sfv e role, che ne limitano l'applicazione. L'attributo sfv limita la regola al paese USA, mentre l'attributo role limita la regola alle mappe con Paese come attributo geografico principale.

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

Significato: Ogni volta che una visualizzazione della mappa con Paese come attributo geografico principale vede "Saint Thomas" come città e "USA" come Paese (nei dati di MicroStrategy ), è consigliabile utilizzare il nome "St. Thomas, Isole Vergini anziché St. Thomas per ottenere i dati dallo shape server.

Questa regola ha due attributi, sfv e role, che ne limitano l'applicazione. L'attributo sfv limita la regola al paese USA, mentre l'attributo role limita la regola alle mappe con Paese come attributo geografico principale.

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

Significato: Ogni volta che una visualizzazione mappa vede la stringa 'Delhi' come la città e "India" come il Paese (nei dati di MicroStrategy ), dovrebbe usare la stringa "New Delhi" invece di "Delhi" per ottenere i dati dallo shape server.

Questa regola ha un attributo sfv che limita l'applicazione della regola al Paese India.

Esempi di risoluzione di regole

Esistono più regole per il nome della località "Russia": Regole 1, 2, 3 e 4.

• La regola 1 è una regola universale che si applica al nome della località principale "Russia" senza altre restrizioni.

• La regola 2 si applica al nome della località "Russia", ma l'applicazione della regola alle visualizzazioni con ESRI come server delle forme mappa (ambito = "1").

• La regola 3 si applica al nome della località "Russia", ma è ancora più restrittiva. Limita l'applicazione della regola alle visualizzazioni con ESRI come server delle forme mappa (ambito = "1"), ma limita l'applicazione anche ai dati renderizzati con i confini del nome di stato USA (shapeId = "400").

• La regola 4 si applica al nome della località "Russia", ma è la più restrittiva. Limita l'applicazione della regola alle visualizzazioni con ESRI come server di forma (ambito = "1") e i dati di rendering con i confini di uno stato degli Stati Uniti (shapeId= "400"), ma limita anche l'applicazione alle visualizzazioni con Paese come geografia principale attributo (ruolo = "3")

Di seguito sono riportati esempi di risoluzioni di regole per il nome "Russia" utilizzando le regole di esempio sopra descritte:

• Se nel plug-in è inclusa solo la regola 1, questa verrà utilizzata per sovrascrivere la regola 1 nel file di configurazione predefinito per la conversione del nome. La regola 1 del plug-in sarà applicata a qualsiasi riga di dati con la Russia come nome della posizione perché è una regola universale che si applica a qualsiasi visualizzazione mappa.

• Se sia la regola 1 che la regola 2 sono incluse nel plug-in, la visualizzazione tenterà prima di applicare la regola 2, poiché è più restrittiva della regola 1. La regola 2 ha un attributo di ambito e una regola con un ambito ha sempre la precedenza su una regola universale. Se ESRI è lo shape server per la visualizzazione della mappa (c'è una corrispondenza nell'ambito), la Regola 2 verrà applicata a qualsiasi riga di dati con "Russia" come nome della posizione; in caso contrario, verrà applicata la regola 1 del plug-in.

• Se la regola 1, la regola 2 e la regola 3 sono incluse nel plug-in, la visualizzazione tenterà prima di applicare la regola 3, poiché è più restrittiva della regola 2. Ha un attributo di forma che è più restrittivo di una semplice restrizione di ambito. Se ESRI è lo shape server per la visualizzazione della mappa (c'è una corrispondenza sull'ambito) e il file di forma corrente è "Paesi del mondo" (shapeId="400"), la Regola 3 sarà applicata a qualsiasi riga di dati con ' Russia' come nome della località; in caso contrario, cercherà di applicare la regola 2. Se la regola 2 non funziona, verrà applicata la regola 1 dal plug-in.

• Se nel plug-in è inclusa solo la regola 3, la visualizzazione tenterà prima di applicare la regola 3, poiché è più restrittiva della regola 1 nel file di configurazione della conversione dei nomi predefinito. La regola 3 ha un attributo shapeId che è più restrittivo di una semplice restrizione di ambito. Se ESRI è lo shape server per la visualizzazione della mappa (c'è una corrispondenza sull'ambito) e il file di forma corrente è "Paesi del mondo" (shapeId="400"), la Regola 3 sarà applicata a qualsiasi riga di dati con ' Russia' come nome della località; in caso contrario, applicherà la regola 1 nel file di configurazione della conversione del nome predefinito.

• Se la regola 1, la regola 2, la regola 3 e la regola 4 sono incluse nel plug-in, la visualizzazione tenterà prima di applicare la regola 4, in quanto è la più restrittiva. Ha un attributo role più restrittivo dell'attributo forma. Se ESRI è lo shape server per la visualizzazione della mappa (c'è una corrispondenza sull'ambito) e l'attributo geografico è "County" (role="3"), la Regola 4 sarà applicata a qualsiasi riga di dati con "Russia" come nome della posizione (valore dell'attributo geografico primario); in caso contrario, cercherà di applicare la regola 3. Se la regola 3 non funziona, cercherà di applicare la regola 2, se la regola 2 non funziona, applicherà la regola 1 dal plug-in.