Resolver diferenças em nomes de locais

Mostrar MicroStrategy dados usando uma visualização de mapa, os nomes de localização usados pela ESRI devem corresponder exclusivamente aos nomes de localização (atributo geográfico) usados por MicroStrategy. No entanto, os nomes usados para localizações geográficas nem sempre são exclusivos ou iguais aos usados pela ESRI.

• Locais diferentes podem ter o mesmo nome de local principal e precisam de um nome de local secundário para torná-los únicos. Por exemplo, muitos condados dos EUA têm o nome “Washington”. Este nome de condado é exclusivo dentro de um estado, mas não fora do estado porque o nome do local principal existe em vários estados. Para identificar exclusivamente tal condado, você precisa qualificá-lo com o nome do estado. Quando você faz isso, Washington AL torna-se exclusivamente diferente de Washington GA ou Washington PA.

• A ESRI às vezes usa nomes de locais diferentes dos nomes usados por MicroStrategy. Por exemplo, a ESRI refere-se ao país da Rússia como “Federação Russa”, enquanto MicroStrategy refere-se a ele como 'Rússia'.

Para resolver diferenças nos nomes dos locais, MicroStrategy usa um arquivo de configuração, chamado mapNameConversions.xml. Neste arquivo de configuração, você pode definir regras que permitem mapear MicroStrategy nomes de locais aos nomes de locais usados pelos fornecedores de mapeamento quando há incompatibilidades e adicione nomes de locais secundários à correspondência quando necessário. Você pode restringir a aplicação da regra a fornecedores de mapeamento específicos (servidores de formato de mapa), a mapas com um tipo específico de limite e a mapas que usam um atributo geográfico específico para mapeamento.

O fora da caixa mapNameConversions.xml arquivo é mostrado abaixo. Possui uma regra, representada por um <elem> nó.

<?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 substituir as regras definidas no arquivo de configuração de conversão de nome pronto para uso e adicionar novas regras, crie um arquivo personalizado mapNameConversions.xml arquivo e adicione-o ao seu plug-in, conforme descrito abaixo.

1. Criar uma mapNameConversions.xml arquivo com o conteúdo mostrado abaixo e cole-o em WEB-INF/xml/config na sua pasta de plug-ins.

   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. Adicione suas próprias regras ao arquivo. Cada regra será separada <elem> elemento, que contém atributos que definem a regra. Para obter ajuda na criação do <elem> elementos, consulte Definição de regra e Resolução de regras. A definição de regras descreve os atributos que você pode usar para definir uma regra e a resolução de regras explica como as regras são aplicadas.

4. Salve suas alterações.

Definição de regra

Cada regra é representada por um <elem> elemento, que contém atributos que definem a regra, conforme descrito na tabela abaixo:

Resolução de regras

As regras no plug-in são mescladas com as regras no arquivo de configuração pronto para uso antes que a visualização do mapa ESRI seja executada. Se a mesma regra existir em ambos os locais, a regra no plug-in substituirá a regra no arquivo de configuração pronto para uso; caso contrário, as novas regras no plug-in serão adicionadas às regras predefinidas.

Os atributos sfv e ShapeId são suportados em mapas Flash, mas não em DHTML.

1. Depois que as regras forem mescladas, a visualização primeiro procurará um atributo de escopo em qualquer uma das regras. Se encontrar um atributo de escopo em uma regra, a visualização verificará uma correspondência no escopo. Por exemplo, existiria uma correspondência se escopo = 1 e a visualização do mapa ESRI estivesse sendo visualizada em MicroStrategy área de trabalho ou MicroStrategy Web, com ESRI como servidor de formato de mapa. Também existiria uma correspondência se escopo = 2 e a visualização do mapa ESRI estivesse sendo visualizada em um dispositivo móvel. Se não houver nenhum atributo de escopo para uma regra, a regra se aplicará a qualquer servidor de formato de mapa. Se houver uma incompatibilidade entre o escopo e o ambiente onde a visualização está sendo visualizada, a regra será ignorada. A visualização filtra as regras para incluir apenas aquelas que têm uma correspondência no escopo ou nenhum atributo de escopo.

2. A visualização analisa cada linha de dados, verificando se há uma correspondência no nome do local principal no MicroStrategy data (o valor do atributo n) em qualquer uma das regras (<elem> nós). Se não encontrar uma correspondência, ele passa para a próxima linha de dados e verifica novamente se há uma correspondência de regra no nome do local principal. Se encontrar uma correspondência, ele filtra as regras para incluir apenas aquelas que têm uma correspondência no nome do local principal na linha atual de dados.

3. Se houver apenas uma regra de conversão de nome correspondente, a visualização a aplicará. Ele substitui o nome do local fornecido como o valor do<elem> nó para o nome do local primário no MicroStrategy dados (valor do atributo n). Se houver diversas regras, a visualização do mapa tentará aplicar primeiro a regra mais restritiva. Os atributos usados para restringir a aplicação de regras estão listados abaixo em ordem decrescente de restrição.

• ID da forma
• papel
• sfv

Se encontrar uma regra com correspondência no atributo shapeID, a visualização a aplica imediatamente; caso contrário, procura uma regra com atributo role. Ele continua descendo a lista de atributos até encontrar uma correspondência. Ele aplica a regra e passa para a próxima linha de dados.

Exemplos de regras

Exemplos de regras são mostrados abaixo:

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

Uma explicação de cada regra de exemplo é fornecida abaixo:

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

Significado: Sempre que qualquer visualização de mapa vê o nome 'Rússia' (no MicroStrategy dados), deveria usar o nome 'Rússia Democrática' para obter dados do servidor shape.

Isso é chamado de regra universal porque se aplica a qualquer visualização de mapa, independentemente do shape server. Não há atributo de escopo.

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

Significado: Sempre que uma visualização do mapa ESRI vê o nome 'Rússia' (no MicroStrategy dados), deverá usar o nome 'Federação Russa' para obter dados do servidor de formato ESRI.

Esta regra possui um atributo de escopo que restringe a aplicação da regra a uma visualização de mapa com ESRI como servidor de formato.

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

Significado: Sempre que uma visualização do mapa ESRI com limites para países do mundo vê o nome 'Rússia' (no MicroStrategy dados), deveria usar o nome 'Rússia Democrática' para obter dados do servidor de formato ESRI.

Esta regra possui dois atributos — escopo e shapeId — que restringem a aplicação da regra. O atributo scope restringe a regra a uma visualização de mapa com ESRI como servidor de formas, e o atributo shapeId restringe a regra a mapas com limites mundiais de países.

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

Significado: Sempre que uma visualização do mapa ESRI com limites para países do mundo e País como atributo geográfico principal vê o nome 'Rússia' (no MicroStrategy dados), deverá usar o nome 'Federação Russa' para obter dados do servidor de formato ESRI.

Esta regra tem três atributos — escopo, shapeId e função — que restringem a aplicação da regra. O atributo scope restringe a regra a uma visualização de mapa com ESRI como servidor de formato, o atributo shapeId restringe a regra a mapas com limites mundiais de países e o atributo role restringe a regra a mapas com Country como o atributo geográfico principal.

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

Significado: Sempre que qualquer visualização de mapa com Condado como atributo geográfico principal vê o nome 'Fairfax' como o valor do condado e 'Virginia' como o valor do estado (no MicroStrategy data), ele deve usar o nome 'Fairfax County' em vez de 'Fairfax' para obter dados do shape server.

Esta regra possui dois atributos – sfv e role – que restringem a aplicação da regra. O atributo sfv restringe a regra aos dados do estado da Virgínia, e o atributo role restringe a regra aos mapas com County como o atributo geográfico principal. Ele pode obter dados de qualquer servidor de formato, pois não possui atributo de escopo.

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

Significado: Sempre que qualquer visualização de mapa com códigos postais dos EUA como limites vê o nome 'Fairfax' como o condado e 'Virginia' como o estado (no MicroStrategy data), ele deve usar o nome 'Fairfax County' em vez de 'Fairfax' para obter dados do shape server.

Esta regra possui dois atributos – sfv e shapeId – que restringem a aplicação da regra. O atributo sfv restringe a regra aos dados do estado da Virgínia, e o atributo shapeId restringe a regra aos mapas com limites de condados dos EUA.

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

Significado: Sempre que qualquer visualização de mapa com condados dos EUA como limites vê o nome 'Fairfax' como o condado e 'VA' como o estado (no MicroStrategy data), ele deve usar o nome 'Fairfax County' em vez de 'Fairfax' para obter dados do shape server.

Esta regra possui dois atributos – sfv e shapeId – que restringem a aplicação da regra. O atributo sfv restringe a regra aos dados do estado com a abreviatura VA (Virgínia), e o atributo shapeId restringe a regra aos mapas com limites de condados dos EUA.

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

Significado: Sempre que qualquer visualização de mapa com País como atributo geográfico principal vê o nome 'St. Thomas' como a cidade e 'EUA' como o país (no MicroStrategy dados), deverá usar o nome 'St. Thomas, Ilhas Virgens' em vez de St. Thomas' para obter dados do servidor de formas.

Esta regra possui dois atributos – sfv e role – que restringem a aplicação da regra. O atributo sfv restringe a regra ao país EUA, e o atributo role restringe a regra a mapas com Country como o atributo geográfico principal.

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

Significado: Sempre que qualquer visualização de mapa com País como atributo geográfico primário vê o nome 'Saint Thomas' como a cidade e 'EUA' como o país (no MicroStrategy dados), deverá usar o nome 'St. Thomas, Ilhas Virgens' em vez de St. Thomas' para obter dados do servidor de formas.

Esta regra possui dois atributos – sfv e role – que restringem a aplicação da regra. O atributo sfv restringe a regra ao país EUA, e o atributo role restringe a regra a mapas com Country como o atributo geográfico principal.

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

Significado: Sempre que qualquer visualização de mapa vê a string 'Delhi' como a cidade e 'Índia' como o país (no MicroStrategy data), ele deve usar a string 'New Delhi' em vez de 'Delhi' para obter dados do shape server.

Esta regra possui um atributo sfv que restringe a aplicação da regra ao país Índia.

Exemplos de resolução de regras

Existem várias regras para o nome do local 'Rússia': Regras 1, 2, 3 e 4.

• A Regra 1 é uma regra universal que se aplica ao nome do local principal 'Rússia' sem outras restrições.

• A regra 2 se aplica ao nome do local 'Rússia', mas restringe a aplicação da regra a visualizações com ESRI como servidor de formato de mapa (escopo = "1").

• A regra 3 aplica-se ao nome do local “Rússia”, mas é ainda mais restritiva. Ela restringe a aplicação da regra a visualizações com ESRI como servidor de formato de mapa (escopo = "1"), mas também restringe a aplicação a dados renderizados com limites de nome de estado dos EUA (shapeId = "400").

• A regra 4 aplica-se ao nome do local “Rússia”, mas é a mais restritiva. Ela restringe a aplicação da regra a visualizações com ESRI como servidor de formas (escopo = "1") e dados renderizados com limites de nomes de estados dos EUA (shapeId= "400"), mas também restringe a aplicação a visualizações com País como localização geográfica primária. atributo (função = "3")

Abaixo estão exemplos de resolução de regras para o nome 'Rússia' usando os exemplos de regras descritos acima:

• Se apenas a Regra 1 estiver incluída no plug-in, ela será usada para substituir a Regra 1 no arquivo de configuração de conversão de nome pronto para uso. A regra1 do plug-in será aplicada a qualquer linha de dados com Rússia como nome do local porque é uma regra universal que se aplica a qualquer visualização de mapa.

• Se a Regra 1 e a Regra 2 estiverem incluídas no plug-in, a visualização tentará primeiro aplicar a Regra 2 porque ela é mais restritiva que a Regra 1. A regra 2 possui um atributo de escopo, e uma regra com escopo sempre tem precedência sobre uma regra universal. Se o ESRI for o servidor de formato para a visualização do mapa (há uma correspondência no escopo), a Regra 2 será aplicada a qualquer linha de dados com 'Rússia' como nome do local; caso contrário, a Regra 1 do plug-in será aplicada.

• Se a Regra 1, a Regra 2 e a Regra 3 estiverem incluídas no plug-in, a visualização tentará primeiro aplicar a Regra 3 porque ela é mais restritiva que a Regra 2. Possui um atributo de forma que é mais restritivo do que uma simples restrição de escopo. Se ESRI for o servidor de formas para a visualização do mapa (há uma correspondência no escopo) e o arquivo de formas atual for "Países do mundo" (shapeId="400"), a Regra 3 será aplicada a qualquer linha de dados com ' Rússia' como nome do local; caso contrário, tentará aplicar a Regra 2. Se a Regra 2 falhar, será aplicada a Regra 1 do plug-in.

• Se apenas a Regra 3 estiver incluída no plug-in, a visualização tentará primeiro aplicar a Regra 3 porque ela é mais restritiva que a Regra 1 no arquivo de configuração de conversão de nome pronto para uso. A regra 3 possui um atributo shapeId que é mais restritivo do que uma simples restrição de escopo. Se ESRI for o servidor de formas para a visualização do mapa (há uma correspondência no escopo) e o arquivo de formas atual for "Países do mundo" (shapeId="400"), a Regra 3 será aplicada a qualquer linha de dados com ' Rússia' como nome do local; caso contrário, aplicará a Regra 1 do arquivo de configuração de conversão de nome pronto para uso.

• Se a Regra 1, a Regra 2, a Regra 3 e a Regra 4 estiverem incluídas no plug-in, a visualização tentará primeiro aplicar a Regra 4 porque é a mais restritiva. Possui um atributo role que é mais restritivo que um atributo shape. Se ESRI for o servidor de formato para a visualização do mapa (há uma correspondência no escopo) e o atributo geográfico for "County" (role="3"), a Regra 4 será aplicada a qualquer linha de dados com 'Rússia' como o nome do local (valor do atributo geográfico primário); caso contrário, tentará aplicar a Regra 3. Se a Regra 3 falhar, ele tentará aplicar a Regra 2 e, se a Regra 2 falhar, aplicará a Regra 1 do plug-in.