Resolver diferencias en los nombres de las ubicaciones

Para mostrar los datos de MicroStrategy mediante una visualización de mapa, los nombres de ubicación utilizados por ESRI deben coincidir de forma exclusiva con los nombres de ubicaciones (atributos geográficos) utilizados por MicroStrategy. Sin embargo, los nombres utilizados para las ubicaciones geográficas no siempre son únicos o iguales a los que utiliza ESRI.

• Diferentes ubicaciones pueden tener el mismo nombre de ubicación principal y necesitar un nombre de ubicación secundaria para que sean únicas. Por ejemplo, muchos condados de EE. UU. tienen el nombre "Washington". El nombre de este condado es único dentro de un estado, pero no fuera del estado porque el nombre de la ubicación principal existe en varios estados. Para identificar de forma única dicho condado, debe calificarlo con el nombre del estado. Cuando haces esto, Washington AL se vuelve excepcionalmente diferente de Washington GA o Washington PA.

• ESRI utiliza a veces nombres de ubicación distintos de los nombres que utiliza MicroStrategy. Por ejemplo, ESRI se refiere al país Rusia como "Federación de Rusia", mientras que MicroStrategy se refiere a él como "Rusia".

Para resolver las diferencias en los nombres de las ubicaciones, MicroStrategy utiliza un archivo de configuración denominado mapNameConversions.xml. En este archivo de configuración puede definir reglas que le permitan asignar nombres de ubicaciones de MicroStrategy a los nombres de ubicaciones utilizados por los proveedores de mapeo cuando haya discrepancias, y agregar nombres de ubicaciones secundarios a la coincidencia cuando sea necesario. Puede restringir la aplicación de la regla a proveedores de mapas específicos (servidores de formas de mapas), a mapas con un tipo específico de límite y a mapas que utilizan un atributo geográfico específico para el mapeo.

El listo para usar mapNameConversions.xml A continuación se muestra el archivo. Tiene una regla, representada por un <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> 

Para anular las reglas establecidas en el archivo de configuración de conversión de nombres listo para usar y añadir nuevas reglas, cree un mapNameConversions.xml y añádalo a su complemento, tal y como se describe a continuación.

1. Crear una mapNameConversions.xml con el contenido que se muestra a continuación y péguelo bajo WEB-INF/xml/config en la carpeta de sus módulos.

   Copiar

   <?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. Agregue sus propias reglas al archivo. Cada regla será una <elem> que contiene los atributos que definen la regla. Para obtener ayuda para crear el <elem> elementos, consulte Definición de regla y Regla de resolución. La definición de regla describe los atributos que puede utilizar para definir una regla y la resolución de regla explica cómo se aplican las reglas.

4. Guarde los cambios.

Definición de regla

Cada regla se representa con un <elem> que contiene atributos que definen la regla, tal y como se describe en la tabla siguiente:

Resolución de reglas

Las reglas del complemento se combinan con las reglas del archivo de configuración listo para usar antes de ejecutar la visualización del mapa ESRI. Si existe la misma regla en ambos lugares, la regla del complemento sobrescribe la regla del archivo de configuración listo para usar; de lo contrario, las nuevas reglas del complemento se agregan a las reglas listas para usar.

Los atributos sfv y ShapeId se admiten en mapas Flash, pero no en DHTML.

1. Una vez que se han combinado las reglas, la visualización primero busca un atributo de alcance en cualquiera de las reglas. Si encuentra un atributo de alcance en una regla, la visualización busca una coincidencia en el alcance. Por ejemplo, existiría una coincidencia si ámbito = 1 y la visualización del mapa de ESRI se está haciendo en MicroStrategy Desktop o MicroStrategy Web, con ESRI como servidor de formas de mapa. También existiría una coincidencia si el alcance = 2 y la visualización del mapa ESRI se está viendo en un dispositivo móvil. Si no hay ningún atributo de alcance para una regla, la regla se aplica a cualquier servidor de formas de mapas. Si hay una discrepancia entre el alcance y el entorno donde se ve la visualización, se ignora la regla. La visualización filtra las reglas para incluir solo aquellas que tienen una coincidencia en el alcance o ningún atributo de alcance.

2. A continuación, la visualización examina cada fila de datos y comprueba si hay una coincidencia para el nombre de la ubicación principal en los datos de MicroStrategy (el valor del atributo n) en alguna de las reglas (< elemento> nodos). Si no encuentra una coincidencia, pasa a la siguiente fila de datos y vuelve a comprobar si hay una coincidencia de regla en el nombre de la ubicación principal. Si encuentra una coincidencia, filtra las reglas para incluir solo aquellas que tienen una coincidencia en el nombre de la ubicación principal en la fila de datos actual.

3. Si solo hay una regla de conversión de nombre coincidente, la visualización la aplica. Sustituye el nombre de ubicación proporcionado como valor del< elemento> para el nombre de la ubicación primaria en los datos de MicroStrategy (valor del atributo n). Si hay varias reglas, la visualización del mapa intenta aplicar primero la regla más restrictiva. Los atributos utilizados para restringir la aplicación de reglas se enumeran a continuación en orden de restricción decreciente.

• ID de forma
• role
• sfv

Si encuentra una regla que coincide con el atributo shapeID, la visualización la aplica inmediatamente; en caso contrario, busca una regla con atributo de rol. Continúa bajando por la lista de atributos hasta que encuentra una coincidencia. Aplica la regla y pasa a la siguiente fila de datos.

Reglas de muestra

A continuación se muestran ejemplos de reglas:

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

A continuación se proporciona una explicación de cada regla de muestra:

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

Significado: siempre que una visualización de mapa vea el nombre “Rusia” (en los datos de MicroStrategy), debería utilizar el nombre “Democrático de Rusia” para obtener los datos del servidor de formas.

Esto se denomina regla universal porque se aplica a cualquier visualización de mapas, independientemente del servidor de formas. No hay ningún atributo de alcance.

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

Significado: siempre que una visualización de mapa ESRI vea el nombre &quot;Rusia&quot; (en los datos de MicroStrategy), debería utilizar el nombre &quot;Federación de Rusia&quot; para obtener los datos del servidor de formas de ESRI.

Esta regla tiene un atributo de alcance que restringe la aplicación de la regla a una visualización de mapa con ESRI como servidor de formas.

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

Significado: siempre que una visualización de mapa ESRI con límites para países del mundo vea el nombre &quot;Rusia&quot; (en los datos de MicroStrategy), debe usar el nombre &quot;Democrático de Rusia&quot; para obtener los datos del servidor de formas de ESRI.

Esta regla tiene dos atributos (alcance y shapeId) que restringen la aplicación de la regla. El atributo alcance restringe la regla a una visualización de mapa con ESRI como servidor de formas, y el atributo shapeId restringe la regla a mapas con límites de países del mundo.

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

Significado: Siempre que una visualización de mapa ESRI con límites para países del mundo y País como atributo geográfico primario vea el nombre &quot;Rusia&quot; (en los datos de MicroStrategy), debe usar el nombre &quot;Federación de Rusia&quot; para obtener los datos de la forma de ESRI server.

Esta regla tiene tres atributos (alcance, shapeId y rol) que restringen la aplicación de la regla. El atributo de alcance restringe la regla a una visualización de mapa con ESRI como servidor de formas, el atributo shapeId restringe la regla a mapas con límites de países del mundo y el atributo de función restringe la regla a mapas con País como atributo geográfico principal.

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

Significado: siempre que una visualización de mapa con condado como atributo geográfico primario vea el nombre “Fairfax” como valor de condado y “Virginia” como valor de estado (en los datos de MicroStrategy), debería usar el nombre “condado de Fairfax” en lugar de “ Fairfax' para obtener datos del servidor de formas.

Esta regla tiene dos atributos (sfv y rol) que restringen su aplicación. El atributo sfv restringe la regla a datos del estado de Virginia y el atributo de rol restringe la regla a mapas con el condado como atributo geográfico principal. Puede obtener datos de cualquier servidor de formas ya que no tiene atributo de alcance.

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

Significado: siempre que una visualización de mapa con códigos postales de EE. UU. como límites muestre el nombre “Fairfax” como el condado y “Virginia” como el estado (en los datos de MicroStrategy), debe utilizar el nombre “Fairfax County” en lugar de “Fairfax” para obtener datos del servidor de formas.

Esta regla tiene dos atributos (sfv y shapeId) que restringen la aplicación de la regla. El atributo sfv restringe la regla a datos del estado de Virginia y el atributo shapeId restringe la regla a mapas con límites de condados de EE. UU.

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

Significado: siempre que cualquier visualización de mapa con condados de EE. UU. como límites vea “Fairfax” como el condado y “VA” como el estado (en los datos de MicroStrategy), debe utilizar el nombre “Fairfax County” en lugar de “Fairfax” para obtener del servidor de formas.

Esta regla tiene dos atributos (sfv y shapeId) que restringen la aplicación de la regla. El atributo sfv restringe la regla a datos del estado con la abreviatura VA (Virginia) y el atributo shapeId restringe la regla a mapas con límites de condados de EE. UU.

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

Significado: siempre que en cualquier visualización de mapa con País como atributo geográfico primario se muestra el nombre &quot;St. Thomas' como ciudad y 'USA' como país (en los datos de MicroStrategy), debe usar el nombre 'St. Thomas, Islas Vírgenes' en lugar de St. Thomas' para obtener datos del servidor de forma.

Esta regla tiene dos atributos (sfv y rol) que restringen su aplicación. El atributo sfv restringe la regla al país EE. UU. y el atributo de rol restringe la regla a mapas con País como atributo geográfico principal.

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

Significado: siempre que una visualización de mapa con País como atributo geográfico primario vea el nombre &quot;Saint Thomas&quot; como la ciudad y &quot;USA&quot; como el país (en los datos de MicroStrategy), debería usar el nombre &quot;St. Thomas, Islas Vírgenes' en lugar de St. Thomas' para obtener datos del servidor de forma.

Esta regla tiene dos atributos (sfv y rol) que restringen su aplicación. El atributo sfv restringe la regla al país EE. UU. y el atributo de rol restringe la regla a mapas con País como atributo geográfico principal.

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

Significado: siempre que una visualización de mapa vea la cadena &quot;Delhi&quot; como la ciudad e &quot;India&quot; como el país (en los datos de MicroStrategy), debe usar la cadena &quot;Nueva Delhi&quot; en lugar de &quot;Delhi&quot; para obtener datos del servidor de formas .

Esta regla tiene un atributo sfv que restringe la aplicación de la regla al país de India.

Ejemplos de resolución de reglas

Hay varias reglas para el nombre de ubicación &quot;Rusia&quot;: las reglas 1, 2, 3 y 4.

• La regla 1 es una regla universal que se aplica al nombre de ubicación principal "Rusia" sin otras restricciones.

• La regla 2 se aplica al nombre de ubicación 'Rusia', pero restringe la aplicación de la regla a visualizaciones con ESRI como servidor de formas de mapas (alcance = "1").

• La regla 3 se aplica al nombre del lugar "Rusia", pero es aún más restrictiva. Restringe la aplicación de la regla a visualizaciones con ESRI como servidor de formas de mapas (alcance = "1"), pero también restringe la aplicación a datos representados con límites de nombres de estados de EE. UU. (shapeId = "400").

• La regla 4 se aplica al nombre de ubicación "Rusia", pero es la más restrictiva. Restringe la aplicación de la regla a visualizaciones con ESRI como servidor de formas (alcance = "1") y datos representados con límites de nombres de estados de EE. UU. (shapeId = "400"), pero también restringe la aplicación a visualizaciones con País como ubicación geográfica principal. atributo (rol = "3")

A continuación se muestran ejemplos de resolución de reglas para el nombre 'Rusia' utilizando las reglas de ejemplo descritas anteriormente:

• Si solo se incluye la Regla 1 en el complemento, se utilizará para sobrescribir la Regla 1 en el archivo de configuración de conversión de nombres listo para usar. La regla 1 del complemento se aplicará a cualquier fila de datos con Rusia como nombre de ubicación porque es una regla universal que se aplica a cualquier visualización de mapa.

• Si tanto la Regla 1 como la Regla 2 están incluidas en el complemento, la visualización intentará primero aplicar la Regla 2 porque es más restrictiva que la Regla 1. La regla 2 tiene un atributo de alcance y una regla con alcance siempre tiene prioridad sobre una regla universal. Si ESRI es el servidor de formas para la visualización del mapa (hay una coincidencia en el alcance), la Regla 2 se aplicará a cualquier fila de datos con 'Rusia' como nombre de ubicación; de lo contrario, se aplicará la regla 1 del complemento.

• Si la Regla 1, la Regla 2 y la Regla 3 están incluidas en el complemento, la visualización intentará primero aplicar la Regla 3 porque es más restrictiva que la Regla 2. Tiene un atributo de forma que es más restrictivo que una simple restricción de alcance. Si ESRI es el servidor de formas para la visualización del mapa (hay una coincidencia en el alcance) y el archivo de formas actual es "Países del mundo" (shapeId="400"), la Regla 3 se aplicará a cualquier fila de datos con ' Rusia' como nombre de la ubicación; en caso contrario, intentará aplicar la Regla 2. Si la regla 2 falla, aplicará la regla 1 del complemento.

• Si solo se incluye la Regla 3 en el complemento, la visualización primero intentará aplicar la Regla 3 porque es más restrictiva que la Regla 1 en el archivo de configuración de conversión de nombres listo para usar. La regla 3 tiene un atributo shapeId que es más restrictivo que una simple restricción de alcance. Si ESRI es el servidor de formas para la visualización del mapa (hay una coincidencia en el alcance) y el archivo de formas actual es "Países del mundo" (shapeId="400"), la Regla 3 se aplicará a cualquier fila de datos con ' Rusia' como nombre de la ubicación; de lo contrario, aplicará la Regla 1 del archivo de configuración de conversión de nombres listo para usar.

• Si la Regla 1, la Regla 2, la Regla 3 y la Regla 4 están incluidas en el complemento, la visualización intentará primero aplicar la Regla 4 porque es la más restrictiva. Tiene un atributo de rol que es más restrictivo que un atributo de forma. Si ESRI es el servidor de formas para la visualización del mapa (hay una coincidencia en el alcance) y el atributo geográfico es "Condado" (rol="3"), la Regla 4 se aplicará a cualquier fila de datos con "Rusia" como nombre de la ubicación (valor del atributo geográfico principal); en caso contrario, intentará aplicar la Regla 3. Si la Regla 3 falla, intentará aplicar la Regla 2, y si la Regla 2 falla, aplicará la Regla 1 del complemento.