Resolución de diferencias en nombres de ubicación

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

• Distintas ubicaciones pueden tener el mismo nombre de ubicación principal y, por lo tanto, necesitan un nombre de ubicación secundario para diferenciarse. Por ejemplo, muchos condados de EE. UU. tienen el nombre "Washington". Este nombre de condado es único en cada estado, pero no fuera del estado, porque el nombre de ubicación principal existe en varios estados. Para identificar de forma exclusiva un condado de este tipo, es necesario calificarlo con el nombre del estado. De esta forma, Washington AL se diferencia de forma inequívoca de Washington GA o Washington PA.

• En ocasiones, ESRI utiliza nombres de ubicación distintos de los que utiliza MicroStrategy. Por ejemplo, ESRI se refiere a Rusia como 'Russian Federation', mientras que MicroStrategy usa 'Russia'.

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

El listo para usar mapNameConversions.xml archivo se muestra a continuación. 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 agregar nuevas reglas, cree una mapNameConversions.xml y agréguelo a su complemento, como se describe a continuación.

1. Crear un mapNameConversions.xml archivo con el contenido que se muestra a continuación y péguelo debajo WEB-INF/xml/config en su carpeta de complementos.

   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á separada <elem> elemento, que contiene atributos que definen la regla. Para obtener ayuda en la creación de la <elem> elementos, consulte Definición de regla y Resolución de reglas. La primera sección describe los atributos que puede utilizar para definir una regla, mientras que la segunda sección explica cómo se aplican las reglas.

4. Guarde los cambios.

Definición de reglas

Cada regla está representada por un <elem> que contiene atributos que definen la regla, como se describe en la siguiente tabla:

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 de mapa ESRI. Si la misma regla existe en ambos sitios, la regla del complemento sobrescribe la regla en el 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 son compatibles con los mapas Flash, pero no con DHTML.

1. Una vez que las reglas se combinan, lo primero que hace la visualización es comprobar si hay un atributo scope en alguna de las reglas. Si encuentra un atributo scope en una regla, la visualización busca una coincidencia de scope. Por ejemplo, existiría una coincidencia si scope = 1 y la visualización de mapa ESRI se realiza en MicroStrategy Desktop o MicroStrategy Web, con ESRI como servidor de formas de mapa. También existiría una coincidencia si scope = 2 y la visualización de mapa ESRI se realiza en un dispositivo móvil. Si no hay un atributo de ámbito para una regla, la regla se aplica a cualquier servidor de forma de mapa. Si hay una discrepancia entre el ámbito y el entorno donde se visualiza 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 en el nombre de ubicación principal en los datos de MicroStrategy (el valor del atributo n) en cualquiera de las reglas (nodos <elem>). 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 tengan una coincidencia en el nombre de ubicación principal en la fila de datos actual.

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

• shapeID
• role
• sfv

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

Reglas de ejemplo

A continuación se muestran algunas reglas de ejemplo:

<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 ofrece una explicación de cada regla de ejemplo:

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

Significado: cada vez que una visualización de mapa encuentre el nombre 'Russia' (en los datos de MicroStrategy), deberá utilizar el nombre 'Democratic Russia' para obtener datos del servidor de formas.

Esta regla es universal, porque se aplica a todas las visualizaciones de mapa, independientemente del servidor de formas. No hay atributo scope.

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

Significado: cada vez que una visualización de mapa ESRI encuentre el nombre 'Russia' (en los datos de MicroStrategy), deberá utilizar el nombre 'Russian Federation' para obtener datos del servidor de formas ESRI.

Esta regla tiene un atributo scope que restringe su aplicación a las visualizaciones de mapa cuyo servidor de formas sea ESRI.

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

Significado: cada vez que una visualización de mapa ESRI cuyos límites son los países del mundo encuentre el nombre 'Russia' (en los datos de MicroStrategy), deberá utilizar el nombre 'Democratic Russia' para obtener datos del servidor de formas ESRI.

Esta regla tiene dos atributos, scope y shapeId, que restringen su aplicación. El atributo scope restringe la regla a una visualización de mapa cuyo servidor de formas sea ESRI, mientras que el atributo shapeId restringe la regla a los mapas cuyos límites son los países del mundo.

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

Significado: cada vez que una visualización de mapa ESRI cuyos límites son los países del mundo y su atributo geográfico principal sea Country encuentre el nombre 'Russia' (en los datos de MicroStrategy), deberá utilizar el nombre 'Russian Federation' para obtener datos del servidor de formas ESRI.

Esta regla tiene tres atributos, scope, shapeId y role, que restringen su aplicación. El atributo scope restringe la regla a una visualización de mapa cuyo servidor de formas sea ESRI, el atributo shapeId restringe la regla a los mapas cuyos límites sean los países del mundo, y el atributo role restringe la regla a mapas cuyo atributo geográfico principal sea Country.

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

Significado: cada vez que una visualización de mapa cuyo atributo geográfico principal sea County encuentre el nombre 'Fairfax' como el valor de condado y 'Virginia' como el valor del estado (en los datos de MicroStrategy), deberá utilizar el nombre 'Fairfax County' en vez de 'Fairfax' para obtener datos del servidor de formas.

Esta regla tiene dos atributos, sfv y role, que restringen su aplicación. El atributo sfv restringe la regla a los datos del estado de Virginia, mientras que el atributo role restringe la regla a los mapas cuyo atributo geográfico principal es County. Puede obtener datos de cualquier servidor de formas, ya que carece de un atributo scope.

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

Significado: cada vez que una visualización de mapa cuyos límites sean los códigos postales estadounidenses encuentre el nombre 'Fairfax' como el condado y 'Virginia' como el estado (en los datos de MicroStrategy), deberá utilizar el nombre 'Fairfax County' en vez de 'Fairfax' para obtener datos del servidor de formas.

Esta regla tiene dos atributos, sfv y shapeId, que restringen su aplicación. El atributo sfv restringe la regla a los datos del estado de Virginia, mientras que el atributo shapeId restringe la regla a los mapas cuyos límites son los condados estadounidenses.

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

Significado: cada vez que una visualización de mapa cuyos límites sean los condados estadounidenses encuentre el nombre 'Fairfax' como el condado y 'VA' como el estado (en los datos de MicroStrategy), deberá utilizar el nombre 'Fairfax County' en vez de 'Fairfax' para obtener datos del servidor de formas.

Esta regla tiene dos atributos, sfv y shapeId, que restringen su aplicación. El atributo sfv restringe la regla a los datos del estado con la abreviatura VA (Virginia), mientras que el atributo shapeId restringe la regla a los mapas cuyos límites son los condados estadounidenses.

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

Significado: cada vez que una visualización de mapa cuyo atributo geográfico principal sea Country encuentre el nombre 'St. Thomas' como la ciudad y 'USA' como el país (en los datos de MicroStrategy), deberá utilizar el nombre 'St. Thomas, Virgin Islands' en vez de 'St. Thomas' para obtener datos del servidor de formas.

Esta regla tiene dos atributos, sfv y role, que restringen su aplicación. El atributo sfv restringe la regla al país de Estados Unidos, mientras que el atributo role restringe la regla a los mapas cuyo atributo geográfico principal es Country.

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

Significado: cada vez que una visualización de mapa cuyo atributo geográfico principal sea Country encuentre el nombre 'Saint Thomas' como la ciudad y 'USA' como el país (en los datos de MicroStrategy), deberá utilizar el nombre 'St. Thomas, Virgin Islands' en vez de 'St. Thomas' para obtener datos del servidor de formas.

Esta regla tiene dos atributos, sfv y role, que restringen su aplicación. El atributo sfv restringe la regla al país de Estados Unidos, mientras que el atributo role restringe la regla a los mapas cuyo atributo geográfico principal es Country.

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

Significado: cada vez que una visualización de mapa encuentre la cadena 'Delhi' como la ciudad e 'India' como el país (en los datos de MicroStrategy), deberá utilizar la cadena 'New Delhi' en vez de 'Delhi' para obtener datos del servidor de formas.

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

Ejemplos de resolución de reglas

Hay varias reglas para el nombre de ubicación 'Russia': las reglas 1, 2, 3 y 4.

• La regla 1 es una regla universal que se aplica al nombre de ubicación principal 'Russia' sin ningún tipo de restricción.

• La regla 2 se aplica al nombre de ubicación 'Russia', pero restringe la aplicación de la regla a las visualizaciones cuyo servidor de formas de mapa sea ESRI (scope = "1").

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

• La regla 4 se aplica al nombre de ubicación 'Russia', pero es la más restrictiva. Restringe la aplicación de la regla a visualizaciones con ESRI como servidor de forma (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 geo principal. atributo (rol = "3")

A continuación se muestran ejemplos de resolución de reglas para el nombre 'Russia' que utilizan las reglas de ejemplo anteriores:

• Si en el complemento solo se incluye la regla 1, 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 todas las filas de datos cuyo nombre de ubicación sea Russia, ya que 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 primero intentará aplicar la Regla 2 porque es más restrictiva que la Regla 1. La regla 2 tiene un atributo scope, y las reglas con este atributo siempre tienen preferencia respecto a una regla universal. Si ESRI es el servidor de forma 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 en el complemento se incluyen las reglas 1, 2 y 3, la visualización intentará aplicar primero la regla 3 porque es más restrictiva que la regla 2. Tiene un atributo shape que es más restrictivo que una sencilla restricción scope. 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 el nombre de la ubicación; de lo 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 sencilla restricción scope. 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 el 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 en el complemento se incluyen las reglas 1, 2, 3 y 4, la visualización intentará aplicar primero la regla 4 porque es la más restrictiva. Tiene un atributo role que es más restrictivo que un atributo shape. Si ESRI es el servidor de forma 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 el nombre de la ubicación (valor del atributo geográfico principal); de lo contrario, intentará aplicar la Regla 3. Si la regla 3 falla, intentará aplicar la regla 2 y si esta también falla, intentará aplicar la regla 1 del complemento.