Resolviendo las diferencias en los nombres de las ubicaciones

Para mostrar 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 ubicación (atributo geográfico) utilizados por MicroStrategy. Sin embargo, los nombres utilizados para las ubicaciones geográficas no siempre son únicos o iguales que los que utiliza ESRI.

• Es posible que distintas ubicaciones tengan el mismo nombre de ubicación principal y necesiten un nombre de ubicación secundaria para ser ú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 ubicación principal existe en varios estados. Para identificar de forma exclusiva un condado de este tipo, debe calificarlo con el nombre del estado. Al hacer esto, Washington AL se vuelve totalmente diferente de Washington GA o Washington PA.

• ESRI utiliza a veces nombres de ubicación distintos de los nombres utilizados por MicroStrategy. Por ejemplo, ESRI se refiere al país Rusia como "Federación de Rusia" y 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 asignación cuando haya discrepancias, y agregar nombres de ubicaciones secundarias a la coincidencia cuando sea necesario. Puede restringir la aplicación de la regla a proveedores de representación cartográfica 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 la representación cartográfica.

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 debajo de WEB-INF/xml/config en su carpeta de 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. Añada 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. Definición de regla describe los atributos que puede utilizar para definir una regla y 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 los atributos que definen la regla, tal y como se describe en la tabla siguiente:

Regla de resolución

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 la misma regla existe en ambos lugares, la regla del complemento sobrescribe la regla del archivo de configuración original; de lo contrario, las nuevas reglas del complemento se añaden a las reglas originales.

Los atributos sfv y ShapeId son compatibles con los mapas Flash, pero no con DHTML.

1. Una vez que se han combinado las reglas, la visualización busca primero un atributo de ámbito en cualquiera de las reglas. Si encuentra un atributo de ámbito en una regla, la visualización comprueba si hay una coincidencia en el ámbito. Por ejemplo, existiría una coincidencia si ámbito = 1 y la visualización del mapa ESRI se está realizando 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 del mapa ESRI se está viendo en un dispositivo móvil. Si no hay un atributo de ámbito para una regla, la regla se aplica a cualquier servidor de formas de mapa. Si hay una discordancia entre el ámbito y el entorno en el que se está visualizando, la regla se ignora. La visualización filtra las reglas para incluir solo aquellas con una coincidencia en el atributo de ámbito o sin él.

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

3. Si solo hay una regla de conversión de nombre que coincide, la visualización la aplica. Sustituye el nombre de la ubicación principal proporcionado como valor del nodo <elem> por el nombre de la ubicación principal en los datos de MicroStrategy (valor del atributo n). Si hay varias reglas, la visualización de mapa intentará 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 decreciente de restricción.

• formaID
• rol
• sfv

Si encuentra una regla con una coincidencia en el atributo ID de forma, la visualización la aplica de inmediato; de lo contrario, busca una regla con el atributo de rol. Continúa hacia abajo en 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 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 proporciona una explicación de cada regla de ejemplo:

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 ), debe 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 mapa, independientemente del servidor de formas. No hay atributo de ámbito.

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

Significado: Siempre que una visualización de mapa ESRI vea el nombre "Rusia" (en los datos de MicroStrategy ), debe utilizar el nombre "Rusia" para obtener los datos del servidor de formas ESRI.

Esta regla tiene un atributo de ámbito 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 "Rusia" (en los datos de MicroStrategy ), debe usar el nombre "Democrático de Rusia" para obtener los datos del servidor de formas ESRI.

Esta regla tiene dos atributos, scope y shapeId, que restringen la aplicación de la regla. El atributo scope 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 "Rusia" (en los datos de MicroStrategy ), debe utilizar el nombre "Rusia" para obtener los datos del servidor de formas ESRI.

Esta regla tiene tres atributos (ámbito, formaId y rol) que restringen la aplicación de la regla. El atributo de ámbito restringe la regla a una visualización de mapa con ESRI como servidor de formas, el atributo de Id de forma restringe la regla a mapas con límites de países del mundo y el atributo de rol 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 el valor de Condado y "Virginia" como el valor de estado (en los datos de MicroStrategy ), debe usar el nombre "Fairfax County" en lugar de "Fairfax" para obtener datos del servidor de formas.

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

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 vea el nombre “Fairfax” como condado y “Virginia” como el estado (en los datos de MicroStrategy ), debe usar el nombre “Condado de Fairfax” 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 los datos del estado de Virginia y el atributo shapeId restringe la regla a los mapas con límites de condado de EE. UU.

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

Significado: Siempre que una visualización de mapa con condados de EE. UU. como límites vea el nombre “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 los datos de el servidor de forma.

Esta regla tiene dos atributos, sfv y shapeId, que restringen la aplicación de la regla. El atributo sfv restringe la regla a los datos del estado con la abreviatura VA (Virginia) y el atributo shapeId restringe la regla a los mapas con límites de condado 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 indique el nombre "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 formas.

Esta regla tiene dos atributos, sfv y rol, que restringen la aplicación de la regla. El atributo sfv restringe la regla al país EE. UU. y el atributo de rol la restringe 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 "Saint Thomas" como la ciudad y "EE.UU." como el 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 formas.

Esta regla tiene dos atributos, sfv y rol, que restringen la aplicación de la regla. El atributo sfv restringe la regla al país EE. UU. y el atributo de rol la restringe 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 'Delhi' como la ciudad y 'India' como el país (en los datos de MicroStrategy ), debe usar la cadena 'New Delhi' en lugar de 'Delhi' para obtener datos del servidor de forma.

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

Ejemplos de resolución de reglas

Hay varias reglas para el nombre de ubicación 'Rusia': 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 las visualizaciones con ESRI como servidor de formas de mapa (ámbito = "1").

• La regla 3 se aplica al nombre de ubicación "Rusia", pero es aún más restrictiva. Restringe la aplicación de la regla a las visualizaciones con ESRI como servidor de formas de mapa (ámbito = "1"), pero también restringe la aplicación a los datos representados con límites de nombre de estado 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 (ámbito = "1") y datos representados con límites de nombre de estado 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" con 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 regla1 del complemento se aplicará a cualquier fila de datos con Rusia como nombre de ubicación porque se trata de una regla universal que se aplica a cualquier visualización de mapa.

• Si tanto la regla 1 como la regla 2 se incluyen en el complemento, la visualización intentará aplicar primero la regla 2 porque es más restrictiva que la regla 1. La regla 2 tiene un atributo de ámbito y una regla con ámbito siempre tiene prioridad sobre una regla universal. Si ESRI es el servidor de formas para la visualización de mapa (hay una coincidencia en el ámbito), 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 se incluyen en el complemento, la visualización intentará aplicar primero 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 ámbito. Si ESRI es el servidor de formas para la visualización del mapa (hay una coincidencia en el ámbito) 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 ubicación; de lo contrario, intentará aplicar la regla 2. Si la regla 2 falla, se aplicará la regla 1 del complemento.

• Si solo se incluye la regla 3 en el complemento, la visualización intentará aplicar primero 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 ámbito. Si ESRI es el servidor de formas para la visualización del mapa (hay una coincidencia en el ámbito) 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 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 se incluyen en el complemento, la visualización intentará aplicar primero 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 de mapa (hay una coincidencia en el ámbito) y el atributo geográfico es "Condado" (role="3"), la regla 4 se aplicará a cualquier fila de datos con "Rusia" como nombre de 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; si la regla 2 falla, aplicará la regla 1 desde el complemento.