Risoluzione delle differenze nei nomi delle posizioni

Per visualizzare i dati MicroStrategy utilizzando una visualizzazione mappa, è necessario che i nomi di località utilizzati da ESRI corrispondano in modo univoco ai nomi di località (attributo geografico) utilizzati da MicroStrategy. Tuttavia, i nomi utilizzati per le località geografiche non sono sempre univoci o gli stessi utilizzati da ESRI.

• Diverse località possono avere lo stesso nome primario e necessitano di un nome secondario per renderle univoche. Ad esempio, negli USA esistono molte contee denominate "Washington". Il nome di questa contea è univoco all'interno di uno stato, ma non all'esterno dello stato perché il nome della località primaria esiste in diversi stati. Per identificare in modo univoco questa contea, è pertanto necessario qualificarla con il nome dello stato. In questo modo, Washington AL risulta diverso rispetto a Washington GA o Washington PA, identificando così le località in modo univoco.

• ESRI utilizza a volte nomi di località diversi rispetto ai nomi utilizzati da MicroStrategy. Ad esempio, ESRI fa riferimento al paese denominato Russia come "Federazione Russa", mentre MicroStrategy fa riferimento a questo paese con il nome "Russia".

Per risolvere le differenze nei nomi delle posizioni, MicroStrategy utilizza un file di configurazione, chiamato mapNameConversions.xml. In questo file di configurazione è possibile definire regole che consentono di mappare i nomi di posizione di MicroStrategy ai nomi di posizione utilizzati dai fornitori di mappatura in caso di discrepanze e di aggiungere nomi di posizione secondari alla corrispondenza quando necessario. È possibile limitare l'applicazione della regola a fornitori di mappatura specifici (server della forma della mappa), a mappe con tipi specifici di confine e a mappe che utilizzano un attributo geografico specifico per la mappatura.

Il fuori dagli schemi 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 pronto all'uso e aggiungere nuove regole, crea un'applicazione personalizzata mapNameConversions.xml file e aggiungilo al tuo plug-in, come descritto di seguito.

1. Creare un mapNameConversions.xml file con il contenuto mostrato di seguito e incollalo sotto 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. Aggiungere le proprie regole al file. Ogni regola sarà separata <elem> element, che contiene gli attributi che definiscono la regola. Per aiuto nella creazione del <elem> elementi, fare riferimento Definizione di regole e Risoluzione del regolamento. La sezione Definizione delle regole descrive gli attributi che è possibile utilizzare per definire una regola, mentre la sezione Risoluzione delle regole illustra come vengono applicate le regole.

4. Salvare le modifiche.

Definizione delle regole

Ogni regola è rappresentata da un <elem> elemento, 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 pronto all'uso prima dell'esecuzione della visualizzazione Mappa ESRI. Se è presente la stessa regola in entrambe le posizioni, la regola nel plug-in sovrascrive la regola nel file di configurazione pronto all'uso; altrimenti, le nuove regole nel plug-in vengono aggiunte alle regole pronte all'uso.

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

1. Una volta unite le regole, la visualizzazione cerca prima un attributo scope in una qualsiasi delle regole. Se trova un attributo scope in una regola, la visualizzazione cerca una corrispondenza nell'ambito. Ad esempio, è presente una corrispondenza se scope = 1 e la visualizzazione Mappa ESRI viene visualizzata in MicroStrategy Desktop o MicroStrategy Web, con ESRI come server della forma della mappa. È inoltre presente una corrispondenza se scope = 2 e la visualizzazione Mappa ESRI viene visualizzata in un dispositivo mobile. Se non esiste un attributo scope per una regola, la regola si applica a qualsiasi server map shape. In caso di mancata corrispondenza tra l'ambito e l'ambiente in cui viene visualizzata la visualizzazione, la regola viene ignorata. La visualizzazione filtra le regole per includere solo quelle che hanno una corrispondenza nell'ambito o nessun attributo dell'ambito.

2. La visualizzazione quindi controlla ciascuna riga di dati per vedere se è presente una corrispondenza nel nome della località primario nei dati MicroStrategy (il valore dell'attributo n) in qualsiasi regola (nodi <elem>). Se non trova una corrispondenza, passa alla riga di dati successiva e verifica nuovamente la corrispondenza della regola sul nome della posizione principale. Se viene trovata una corrispondenza, le regole vengono filtrate in modo da includere solo quelle che hanno una corrispondenza nel nome della località primario nella riga di dati corrente.

3. Se è presente una sola regola di conversione del nome corrispondente, viene applicata dalla visualizzazione. La regola sostituisce il nome della località fornito come valore del nodo <elem> per il nome della località primario nei dati MicroStrategy (valore dell'attributo n). Se sono presenti più regole, la visualizzazione mappa prova ad applicare per prima la regola più restrittiva. Di seguito vengono elencati gli attributi utilizzati per limitare l'applicazione di regole, in ordine decrescente di capacità di limitazione.

• shapeID
• role
• sfv

Se viene trovata una regola con una corrispondenza nell'attributo shapeID, la visualizzazione la applica immediatamente, altrimenti cercherà una regola con attributo di ruolo. La ricerca continua nell'elenco di attributi finché non viene trovata una corrispondenza, quindi viene applicata la regola e si passa alla riga successiva di dati.

Regole di esempio

Di seguito vengono illustrate alcune regole di esempio:

<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 riportata una spiegazione di ciascuna regola di esempio:

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

Significato: Ogni volta che la visualizzazione mappa trova il nome "Russia" (nei dati MicroStrategy), deve utilizzare il nome "Democratic Russia" per ottenere i dati dal server della forma.

Questa viene denominata regola universale, perché si applica a qualsiasi visualizzazione mappa indipendentemente dal server della forma. Non è presente alcun attributo scope.

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

Significato: Ogni volta che una visualizzazione mappa ESRI trova il nome "Russia" (nei dati MicroStrategy), deve utilizzare il nome "Russan Federation" per ottenere i dati dal server della forma ESRI.

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

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

Significato: Ogni volta che una visualizzazione mappa ESRI con confini di paesi del mondo trova il nome "Russia" (nei dati MicroStrategy), deve utilizzare il nome "Democratic Russia" per ottenere i dati dal server della forma ESRI.

Questa regola dispone di due attributi, ovvero scope e shapeId, che limitano l'applicazione della regola. L'attributo scope limita la regola a una visualizzazione mappa con ESRI come server della forma, mentre l'attributo shapeId limita la regola a mappe con confini di paesi del mondo.

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

Significato: Ogni volta che una visualizzazione mappa ESRI con confini di paesi del mondo e Paese come attributo geografico primario trova il nome "Russia" (nei dati MicroStrategy), deve utilizzare il nome "Russian Federation" per ottenere i dati dal server della forma ESRI.

Questa regola dispone di tre attributi, ovvero scope, shapeId e role, che limitano l'applicazione della regola. L'attributo scope limita la regola a una visualizzazione mappa con ESRI come server della forma, l'attributo shapeId limita la regola alle mappe con confini di paesi del mondo e l'attributo role limita la regola alle mappe con Paese come attributo geografico primario.

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 primario trova il nome "Fairfax" come valore della contea e "Virginia" come valore dello stato (nei dati MicroStrategy), deve utilizzare il nome "Fairfax County" anziché "Fairfax" per ottenere i dati dal server della forma.

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

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

Significato: Ogni volta che una visualizzazione mappa con CAP USA come confini trova il nome 'Fairfax" come contea e "Virginia" come stato (nei dati MicroStrategy), deve utilizzare il nome "Fairfax County" anziché "Fairfax" per ottenere i dati dal server della forma.

Questa regola dispone di due attributi, ovvero sfv e shapeId, che limitano l'applicazione della regola. L'attributo sfv limita la regola ai dati dello stato della Virginia, mentre l'attributo shapeId limita la regola a mappe con confini di contee USA.

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

Significato: Ogni volta che una visualizzazione mappa con contee USA come confini trova il nome "Fairfax" come contea e "VA" come stato (nei dati MicroStrategy), deve utilizzare il nome "Fairfax County" anziché "Fairfax" per ottenere i dati dal server della forma.

Questa regola dispone di due attributi, ovvero sfv e shapeId, che limitano l'applicazione della regola. L'attributo sfv limita la regola ai dati dello stato con abbreviazione VA (Virginia), mentre l'attributo shapeId limita la regola a mappe con confini di contee USA.

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 la contea come attributo geografico primario trova il nome "St. Thomas" come città e "USA" come paese (nei dati MicroStrategy), deve usare il nome "St. Thomas, Virgin Islands" anziché St. "Thomas" per ottenere i dati dal server della forma.

Questa regola dispone di due attributi, ovvero sfv e role, che limitano l'applicazione della regola. L'attributo sfv limita la regola al paese USA, mentre l'attributo role limita la regola alle mappe con il paese come attributo geografico primario.

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

Significato: Ogni volta che una visualizzazione mappa con il paese come attributo geografico primario trova il nome "Saint Thomas" come città e "USA" come paese (nei dati MicroStrategy), deve utilizzare il nome "St. Thomas, Virgin Islands" anziché St. "Thomas" per ottenere i dati dal server della forma.

Questa regola dispone di due attributi, ovvero sfv e role, che limitano l'applicazione della regola. L'attributo sfv limita la regola al paese USA, mentre l'attributo role limita la regola alle mappe con il paese come attributo geografico primario.

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

Significato: Ogni volta che una visualizzazione mappa trova la stringa "Delhi" come città e "India" come paese (nei dati MicroStrategy), deve utilizzare la stringa "New Delhi" anziché "Delhi" per ottenere i dati dal server della forma.

Questa regola dispone di un attributo sfv che limita l'applicazione della regola al paese India.

Esempi di risoluzione della regola

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

• La Regola 1 rappresenta una regola universale che si applica al nome di località primario 'Russia' senza altre restrizioni.

• La Regola 2 si applica al nome di località "Russia", ma limita l'applicazione della regola alle visualizzazioni con ESRI come server della forma della mappa (scope = "1").

• La Regola 3 si applica al nome di località "Russia", ma è ancora più restrittiva. Limita l'applicazione della regola alle visualizzazioni con ESRI come server della forma della mappa (ambito = "1"), ma limita anche l'applicazione ai dati resi con i confini dei nomi degli stati statunitensi (shapeId = "400").

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

Di seguito vengono riportati esempi di risoluzione della regola per il nome "Russia" utilizzando le regole di esempio descritte sopra:

• Se nel plug-in viene inclusa solo la Regola 1, verrà utilizzata per sovrascrivere la Regola 1 nel file di configurazione della conversione del nome pronto all'uso. La Regola 1 dal plug-in verrà applicata a qualsiasi riga di dati con Russia come nome di località perché si tratta di una regola universale che si applica a qualsiasi visualizzazione mappa.

• Se nel plug-in sono incluse sia la Regola 1 che la Regola 2, la visualizzazione proverà prima ad applicare la Regola 2 perché è più restrittiva della Regola 1. La Regola 2 dispone di un attributo scope e una regola con l'attributo scope ha sempre la precedenza rispetto a 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 nel plug-in vengono incluse la Regola 1, la Regola 2 e la Regola 3, la visualizzazione cercherà innanzitutto di applicare la Regola 3 perché è più restrittiva della Regola 2. È presente l'attributo shape che è più restrittivo di una semplice restrizione di tipo scope. Se ESRI è lo shape server per la visualizzazione della mappa (c'è una corrispondenza nell'ambito) e lo shape file corrente è "Countries of the world" (shapeId="400"), la Regola 3 verrà 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 va a buon fine, 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 perché è più restrittiva della regola 1 nel file di configurazione della conversione del nome pronto all'uso. La Regola 3 dispone di un attributo shapeId che è più restrittivo di una semplice restrizione di tipo scope. Se ESRI è lo shape server per la visualizzazione della mappa (c'è una corrispondenza nell'ambito) e lo shape file corrente è "Countries of the world" (shapeId="400"), la Regola 3 verrà applicata a qualsiasi riga di dati con ' Russia' come nome della località; in caso contrario, applicherà la Regola 1 dal file di configurazione della conversione del nome pronto all'uso.

• Se nel plug-in vengono incluse la Regola 1, la Regola 2, la Regola 3 e la Regola 4, la visualizzazione cercherà innanzitutto di applicare la Regola 4 perché è la più restrittiva. Dispone di un attributo role, che è più restrittivo di un attributo shape. Se ESRI è lo shape server per la visualizzazione della mappa (c'è una corrispondenza nell'ambito) e l'attributo geo è "County" (role="3"), la Regola 4 verrà 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 va a buon fine, si tenterà di applicare la Regola 2, e se questa non va a buon fine, verrà applicata la Regola 1 del plug-in.