Resolver diferenças em nomes de locais

Para exibir dados da MicroStrategy usando uma visualização de mapa, os nomes de local utilizados pela ESRI devem corresponder exclusivamente aos nomes de local (atributo geográfico) utilizados pelo MicroStrategy. Contudo, os nomes utilizados para localizações geográficas nem sempre são únicos ou os mesmos utilizados 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 nos EUA têm o nome "Washington". O nome do condado é único dentro de um estado, mas não fora dele, porque o nome do local principal existe em vários estados. Para identificar exclusivamente esse condado, é necessário qualificá-lo com o nome do estado. Quando você faz isso, Washington AL se torna exclusivamente diferente de Washington GA ou de Washington PA.

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

Para resolver diferenças nos nomes de locais, o MicroStrategy usa um arquivo de configuração, chamado mapNameConversions.xml. Nesse arquivo de configuração, você pode definir regras que permitem associar nomes de locais da MicroStrategy aos nomes de locais usados por fornecedores de mapeamento quando há incompatibilidades, e adicionar 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 fronteira e a mapas que usam um atributo geográfico específico para mapeamento.

O mapNameConversions.xml O arquivo é mostrado abaixo. Ela tem 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 nomes pronto para o uso e adicionar novas regras, crie um cliente mapNameConversions.xml e adicione-o ao seu plug-in, conforme descrito abaixo.

1. Crie um mapNameConversions.xml arquivo com o conteúdo mostrado abaixo e cole-o em WEB-INF/xml/config na pasta do plug-in.

   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 para criar o <elem> elementos, consulte Definição de regra e Resolução da regra de . A definição de regra descreve os atributos que você pode usar para definir uma regra, e a Resolução de regra 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 da regra

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 o uso; caso contrário, as novas regras no plug-in serão adicionadas às regras prontas para uso.

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 procurará uma correspondência no escopo. Por exemplo, existiria uma correspondência se escopo = 1 e a visualização do mapa ESRI estivesse sendo visualizada no MicroStrategy desktop ou no MicroStrategy Web, com ESRI como o servidor de formato do 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 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 em que a visualização está sendo visualizada, a regra será ignorada. A visualização filtra as regras para incluir somente aquelas que têm uma correspondência no escopo ou nenhum atributo de escopo.

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

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

• ID da forma
• função
• sfv

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

Regras de amostra

Regras de amostra são mostradas 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 uma visualização de mapa tiver o nome 'Rússia' (nos dados da MicroStrategy ), ela deve usar o nome 'Rússia Democrática' para obter dados do servidor de formatos.

Essa é chamada de regra universal, porque se aplica a qualquer visualização de mapa, independentemente do servidor de formato. Não há atributo de escopo.

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

Significado: Sempre que uma visualização de mapa ESRI tiver o nome 'Rússia' (nos dados da MicroStrategy ), ela deve usar o nome 'Federação Russa' para obter dados do servidor de formatos ESRI.

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

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

Significado: Sempre que uma visualização de mapa ESRI com fronteiras para países do mundo tiver o nome 'Rússia' (nos dados da MicroStrategy ), ela deve usar o nome 'Rússia Democrática' para obter dados do servidor de formatos ESRI.

Essa regra tem dois atributos, escopo e shapeId, que restringem a aplicação da regra. O atributo de escopo restringe a regra a uma visualização de mapa com ESRI como servidor de forma, e o atributo shapeId restringe a regra a mapas com fronteiras de países do mundo.

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

Significado: Sempre que uma visualização de mapa ESRI com fronteiras para países do mundo e País como atributo geográfico principal tiver o nome 'Rússia' (nos dados da MicroStrategy ), ela deve usar o nome 'Federação Russa' para obter dados do servidor de formatos ESRI.

Essa regra tem três atributos - escopo, shapeId e função - que restringem a aplicação da regra. O atributo de escopo restringe a regra a uma visualização de mapa com ESRI como servidor de forma, o atributo de formaId restringe a regra a mapas com fronteiras de países do mundo, e o atributo de função restringe a regra a mapas com País como atributo geográfico principal.

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

Significado: Sempre que uma visualização de mapa com o Condado como atributo geográfico principal vir o nome 'Fairfax' como o valor do Condado e 'Virgínia' como o valor do estado (nos dados da MicroStrategy ), deverá usar o nome 'Condado de Fairfax' em vez de 'Fairfax' para obter dados do servidor de forma.

Essa regra tem dois atributos - sfv e role - que restringem sua aplicação. O atributo sfv restringe a regra a dados do estado da Virgínia, e o atributo de função restringe a regra a mapas com Condado como atributo geográfico principal. Ele pode obter dados de qualquer servidor de formato, pois não tem atributo de escopo.

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

Significado: Sempre que uma visualização de mapa com CEPs dos EUA como fronteiras vir o nome 'Fairfax' como o condado e 'Virgínia' como o estado (nos dados da MicroStrategy ), deverá usar o nome 'Condado de Fairfax' em vez de 'Fairfax' para obter os dados do servidor de formas.

Essa regra tem dois atributos — sfv e shapeId — que restringem a aplicação da regra. O atributo sfv restringe a regra a dados do estado da Virgínia, e o atributo shapeId restringe a regra a mapas com fronteiras de condados dos EUA.

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

Significado: Sempre que uma visualização de mapa com condados dos EUA como fronteiras vir o nome 'Fairfax' como condado e 'VA' como estado (nos dados da MicroStrategy ), deverá usar o nome 'Condado de Fairfax' em vez de 'Fairfax' para obter dados de o servidor de formas.

Essa regra tem dois atributos — sfv e shapeId — que restringem a aplicação da regra. O atributo sfv restringe a regra a dados do estado com a abreviação VA (Virgínia), e o atributo shapeId restringe a regra a mapas com fronteiras de condados dos EUA.

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

Significado: Sempre que uma visualização de mapa com País como atributo geográfico principal tiver o nome 'St. Thomas' como cidade e 'USA' como país (nos dados da MicroStrategy ), deve usar o nome 'St. Thomas, Ilhas Virgens' em vez de St. Thomas' para obter dados do servidor de formatos.

Essa regra tem dois atributos - sfv e role - que restringem sua aplicação. O atributo sfv restringe a regra ao país EUA, e o atributo de função restringe a regra a mapas com País como atributo geográfico principal.

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

Significado: Sempre que uma visualização de mapa com País como atributo geográfico principal vir o nome 'São Tomás' como a cidade e 'EUA' como o país (nos dados da MicroStrategy ), ela deve usar o nome 'St. Thomas, Ilhas Virgens' em vez de St. Thomas' para obter dados do servidor de formatos.

Essa regra tem dois atributos - sfv e role - que restringem sua aplicação. O atributo sfv restringe a regra ao país EUA, e o atributo de função restringe a regra a mapas com País como atributo geográfico principal.

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

Significado: Sempre que uma visualização de mapa tiver a string 'Delhi' como a cidade e 'Índia' como o país (nos dados da MicroStrategy ), ela deverá usar a string 'Nova Delhi' em vez de 'Delhi' para obter dados do servidor de formas.

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

Exemplos de resolução de regras

Há 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 o servidor de formato de mapa (escopo = "1").

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

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

Abaixo estão exemplos de resolução de regra para o nome 'Rússia' usando as regras de exemplo descritas acima:

• Se somente a Regra 1 for 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 Rule1 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 as Regras 1 e 2 forem incluídas no plug-in, a visualização tentará primeiro aplicar a Regra 2, porque ela é mais restritiva do que a Regra 1. A regra 2 tem um atributo de escopo, e uma regra com escopo sempre tem precedência sobre uma regra universal. Se ESRI for o servidor de formas para a visualização de 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 Rule 1 do plug-in será aplicada.

• Se as Regras 1, 2 e 3 forem incluídas no plug-in, a visualização tentará primeiro aplicar a Regra 3, porque ela é mais restritiva do que a Regra 2. Ele tem 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 de 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, a Regra 1 do plug-in será aplicada.

• Se somente a Regra 3 for incluída no plug-in, a visualização tentará primeiro aplicar a Regra 3, porque ela é mais restritiva do que a Regra 1 no arquivo de configuração de conversão de nome pronto para uso. A regra 3 tem 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 de 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 o uso.

• Se as Regras 1, 2, 3 e 4 estiverem todas incluídas no plug-in, a visualização tentará primeiro aplicar a Regra 4, porque ela é a mais restritiva. Ele tem um atributo de função que é mais restritivo do que um atributo de forma. Se ESRI for o servidor de formas para a visualização de mapa (há uma correspondência no escopo) e o atributo geográfico for "Condado" (role="3"), a Regra 4 será aplicada a qualquer linha de dados com 'Rússia' como nome do local (valor do atributo geográfico principal); 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.