Risoluzione delle differenze nei nomi delle località

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

• Posizioni diverse potrebbero avere lo stesso nome di località principale e richiedere un nome di località secondaria per renderle univoche. Ad esempio, molte contee negli Stati Uniti hanno il nome "Washington". Questo nome di contea è univoco all'interno di uno stato, ma non al di fuori dello stato perché il nome della località 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 straordinariamente diversa da Washington GA o Washington PA.

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

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

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

4. Salvare le modifiche.

Definizione delle regole

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

Risoluzione delle regole

Le regole nel plug-in vengono unite alle regole nel file di configurazione predefinito prima dell'esecuzione della visualizzazione della 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 verranno aggiunte alle regole predefinite.

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

1. Una volta unite le regole, la visualizzazione cerca innanzitutto un attributo di ambito in una qualsiasi delle regole. Se trova un attributo di ambito in una regola, la visualizzazione verifica una corrispondenza nell'ambito. Ad esempio, una corrispondenza esiste se l'ambito = 1 e la visualizzazione Mappa ESRI viene visualizzata in MicroStrategy Desktop o MicroStrategy Web, con ESRI come server della forma della mappa. Esisterà una corrispondenza anche se scope = 2 e la visualizzazione della mappa ESRI viene visualizzata su un dispositivo mobile. Se non è presente alcun attributo di ambito per una regola, la regola si applica a qualsiasi server di forme di mappa. Se esiste una 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 di ambito.

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

3. Se esiste una sola regola di conversione dei nomi corrispondente, la visualizzazione la applica. Sostituisce il nome del percorso fornito come valore di< elem> per il nome del percorso primario nei dati MicroStrategy (valore dell'attributo n). Se sono presenti più regole, la visualizzazione della mappa tenta di applicare prima la regola più restrittiva. Gli attributi utilizzati per limitare l'applicazione delle regole sono elencati di seguito in ordine decrescente di restrizione.

• IDforma
• ruolo
• sfv

Se trova una regola con una corrispondenza sull'attributo shapeID, la visualizzazione la applica immediatamente; altrimenti cerca una regola con l'attributo role. Continua l'elenco degli attributi finché non trova una corrispondenza. Applica la regola e passa alla riga di dati successiva.

Regole di esempio

Di seguito sono riportate 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 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 &quot;Russia&quot; (nei dati di MicroStrategy), è consigliabile utilizzare il nome &quot;Russia democratica&quot; per ottenere i dati dallo shape server.

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

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

Significato: ogni volta che la visualizzazione Mappa ESRI vede il nome &quot;Russia&quot; (nei dati di MicroStrategy), è consigliabile utilizzare il nome &quot;Federazione russa&quot; per ottenere i dati dallo shape server ESRI.

Questa regola ha un attributo di ambito che limita l'applicazione della regola a una visualizzazione 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 confini per paesi del mondo vede il nome &quot;Russia&quot; (nei dati di MicroStrategy), è necessario utilizzare il nome &quot;Russia democratica&quot; per ottenere i dati dallo shape server ESRI.

Questa regola ha due attributi, scope e shapeId, che ne limitano l'applicazione. L'attributo scope limita la regola a una visualizzazione della mappa con ESRI come server di forma e l'attributo shapeId limita la regola alle 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 la visualizzazione di una mappa ESRI con confini per Paesi del mondo e Paese come attributo geografico principale Paese vede il nome &quot;Russia&quot; (nei dati di MicroStrategy), è consigliabile utilizzare il nome &quot;Federazione russa&quot; per ottenere i dati dalla forma ESRI server.

Questa regola ha tre attributi (scope, shapeId e role) che ne limitano l'applicazione. L'attributo scope limita la regola a una visualizzazione della mappa con ESRI come server di 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 Country come attributo geografico primario.

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

Significato: ogni volta che una visualizzazione della mappa con Contea come attributo geografico principale vede il nome 'Fairfax' come valore della contea e 'Virginia' come il valore dello stato (nei dati di MicroStrategy), è consigliabile utilizzare il nome 'Fairfax County' anziché ' Fairfax' 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 ai dati dello stato della Virginia e l'attributo role limita la regola alle mappe con Contea come attributo geografico primario. Può ottenere dati da qualsiasi server di forma poiché non ha attributi scope.

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 &quot;Virginia&quot; come stato (nei dati di MicroStrategy), è necessario utilizzare il nome &quot;Fairfax County&quot; anziché &quot;Fairfax&quot; per ottiene i dati dallo shape server.

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 e l'attributo shapeId limita la regola alle mappe con i confini delle contee degli Stati Uniti.

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

Significato: ogni volta che una visualizzazione mappa con contee degli Stati Uniti come confine vede 'Fairfax' come contea e 'VA' come stato (nei dati MicroStrategy), è necessario utilizzare il nome 'Fairfax County' anziché 'Fairfax' per ottenere dati dallo shape server.

Questa regola ha due attributi, sfv e shapeId, che ne limitano l'applicazione. L'attributo sfv limita la regola ai dati provenienti dallo 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&quot; come città e &quot;USA&quot; come Paese (nei dati MicroStrategy), il nome dovrebbe essere &quot;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 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 Paese come attributo geografico principale vede &quot;Saint Thomas&quot; come città e &quot;USA&quot; come Paese (nei dati MicroStrategy), è consigliabile utilizzare il nome &quot;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 primario.

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

Significato: ogni volta che una visualizzazione mappa vede la stringa &quot;Delhi&quot; come città e &quot;India&quot; come Paese (nei dati di MicroStrategy), è consigliabile utilizzare la stringa &quot;New Delhi&quot; anziché &quot;Delhi&quot; per ottenere i dati dallo shape server .

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

Esempi di risoluzione delle regole

Esistono diverse regole per il nome della località &quot;Russia&quot;: 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 limita l'applicazione della regola alle visualizzazioni con ESRI come server delle forme di 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 di forme di mappa (ambito = "1"), ma limita anche l'applicazione ai dati resi con i confini dei nomi di stato degli Stati Uniti (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 ai dati renderizzati con i confini dei nomi di stato degli Stati Uniti (shapeId= "400"), ma limita anche l'applicazione alle visualizzazioni con Paese come area geografica primaria attributo (ruolo = "3")

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

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

• Se nel plug-in sono incluse sia la Regola 1 che la Regola 2, la visualizzazione proverà prima ad applicare la Regola 2 poiché è più restrittiva della Regola 1. La regola 2 ha un attributo ambito e una regola con 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, Regola 2 e Regola 3 sono incluse nel plug-in, la visualizzazione proverà prima ad applicare la Regola 3 perché è più restrittiva della Regola 2. Ha un attributo di forma che è più restrittivo di una semplice restrizione dell'ambito. Se ESRI è il server dello shape per la visualizzazione della mappa (c'è una corrispondenza nell'ambito) e il file dello shape corrente è "Paesi del mondo" (shapeId="400"), la regola 3 verrà applicata a qualsiasi riga di dati con ' Russia' come nome della località; in caso contrario, tenterà di applicare la regola 2. Se la Regola 2 fallisce, verrà applicata la Regola 1 dal plug-in.

• Se nel plug-in è inclusa solo la regola 3, la visualizzazione proverà prima ad applicare la regola 3 perché è più restrittiva della regola 1 nel file di configurazione di conversione del nome predefinito. La regola 3 ha un attributo shapeId che è più restrittivo di una semplice restrizione dell'ambito. Se ESRI è il server dello shape per la visualizzazione della mappa (c'è una corrispondenza nell'ambito) e il file dello shape corrente è "Paesi del mondo" (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 del file di configurazione di conversione del nome predefinito.

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