Resolvendo diferenças em nomes de locais

Para exibir dados do MicroStrategy usando uma visualização de mapa, os nomes de localizações usados pelo ESRI devem corresponder de forma exclusiva aos nomes de localizações (atributo geográfico) usados pela MicroStrategy. No entanto, os nomes usados para localizações geográficas nem sempre são exclusivos ou iguais aos que o ESRI utiliza.

• Diferentes localizações podem ter o mesmo nome de localização primário e precisam de um nome de localização secundário para torná-los exclusivos. Por exemplo, muitos municípios nos EUA têm o nome "Washington". Esse nome de município é exclusivo em um estado, mas não fora do estado, porque o nome de localização primário existe em vários estados. Para identificar com exclusividade esse município, você precisa qualificá-lo com o nome do estado. Ao fazer isso, Washington AL torna-se exclusivamente diferente de Washington GA ou Washington PA.

• Às vezes, o ESRI usa nomes de localizações que são diferentes dos nomes usados pela MicroStrategy. Por exemplo, o ESRI refere-se à Rússia como "Russian Federation", enquanto a MicroStrategy se refere a ele como "Russia".

Para resolver diferenças nos nomes dos locais, o MicroStrategy usa um arquivo de configuração, chamado mapNameConversions.xml. Nesse arquivo de configuração, você pode definir regras que permitem mapear nomes de locais do MicroStrategy para os nomes de locais usados pelos 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 formas de mapas), a mapas com um limite específico 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 uma 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 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á uma <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 da regra. A definição de regras descreve os atributos que você pode usar para definir uma regra, enquanto a resolução de regras explica como as regras são aplicadas.

4. Salve suas alterações.

Definição de regras

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 pré-configurado antes que a visualização de 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 pré-configurado. Caso contrário, as novas regras no plug-in serão adicionadas às regras pré-configuradas.

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

1. Uma vez que as regras tiverem sido mescladas, a visualização primeiro procurará um atributo scope em qualquer uma das regras. Se encontrar um atributo scope em uma regra, a visualização verificará se existe uma correspondência no escopo. Por exemplo, uma correspondência existiria se scope = 1 e se a visualização de Mapa ESRI estiver sendo exibida no MicroStrategy Desktop ou no MicroStrategy Web, com o ESRI como servidor de formas de mapa. Uma correspondência também existiria se scope = 2 e se a visualização de Mapa ESRI estiver 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 forma 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 apenas aquelas que têm uma correspondência no escopo ou nenhum atributo de escopo.

2. Em seguida, ela examina cada linha de dados, verificando se existe uma correspondência de nome de localização primário nos dados do MicroStrategy (o valor do atributo n) em qualquer uma das regras (nós <elem>). Se não encontrar uma correspondência, ele passará para a próxima linha de dados e verificará novamente uma correspondência de regra no nome do local principal. Se encontrar uma correspondência, ela filtrará as regras para incluir somente aquelas que têm uma correspondência de nome de localização primário na linha atual de dados.

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

• shapeID
• role
• sfv

Se encontrar uma regra com correspondência no atributo shapeID, a visualização a aplicará imediatamente. Caso contrário, procurará uma regra com o atributo role. Ela continua lista abaixo pelos atributos até encontrar uma correspondência. Em seguida, aplicará a regra e passará para a próxima linha de dados.

Regras de exemplo

Regras de exemplo 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:<code><elem id="1" n="Russia">Democratic Russia</elem> </code>

Significado: Sempre que qualquer visualização de mapa vir o nome 'Russia' (nos dados do MicroStrategy), ela deverá usar o nome 'Democratic Russia' para obter dados do servidor de formas.

Isso é chamado de regra universal, pois é aplicável a qualquer visualização de mapa, independentemente do servidor de formas. Não há um atributo scope.

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

Significado: Sempre que uma visualização de Mapa ESRI vir o nome 'Russia' (nos dados do MicroStrategy), ela deverá usar o nome 'Russian Federation' para obter dados do servidor de formas ESRI.

Essa regra tem um atributo scope que restringe a aplicação da regra a uma visualização de mapa com o ESRI como servidor de formas.

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

Significado: Sempre que uma visualização de Mapa ESRI com limites de países do mundo vir o nome 'Russia' (nos dados do MicroStrategy), ela deverá usar o nome 'Democratic Russia' para obter dados do servidor de formas ESRI.

Essa regra tem dois atributos, scope e shapeId, que restringem sua aplicação. O atributo scope restringe a regra a uma visualização de mapa com o ESRI como servidor de formas, enquanto o atributo shapeId restringe a regra a mapas com limites 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 limites de países do mundo e Country como o atributo geográfico primário vir o nome 'Russia' (nos dados do MicroStrategy), ela deverá usar o nome 'Russian Federation' para obter dados do servidor de formas ESRI.

Essa regra tem três atributos, scope, shapeId e role, que restringem sua aplicação. O atributo scope restringe a regra a uma visualização de mapa com o ESRI como servidor de formas, o atributo shapeId restringe a regra a mapas com limites de países do mundo, enquanto o atributo role restringe a regra a mapas com Country como atributo geográfico primário.

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

Significado: Sempre que qualquer visualização de mapa com County como atributo geográfico primário vir o nome 'Fairfax' como o valor de município e 'Virginia' como valor de estado (nos dados do MicroStrategy), ela deverá usar o nome 'Fairfax County' em vez de 'Fairfax' para obter dados do servidor de formas.

Essa regra tem dois atributos, sfv e role, que restringem sua aplicação. O atributo sfv restringe a regra a dados do estado de Virgínia, enquanto o atributo role restringe a regra a mapas com County como o atributo geográfico primário. Ele pode obter dados de qualquer servidor de formas, desde que não tenha nenhum atributo scope.

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 vir o nome 'Fairfax' como município e 'Virginia' como estado (nos dados do MicroStrategy), ela deverá usar o nome 'Fairfax County' em vez de 'Fairfax' para obter dados do servidor de formas.

Essa regra tem dois atributos, sfv e shapeId, que restringem sua aplicação. O atributo sfv restringe a regra a dados do estado de Virgínia, enquanto o atributo shapeId restringe a regra a mapas com limites de municípios 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 municípios dos EUA como limites vir o nome 'Fairfax' como município e 'VA' como estado (nos dados do MicroStrategy), ela deverá usar o nome 'Fairfax County' em vez de 'Fairfax' para obter dados do servidor de formas.

Essa regra tem dois atributos, sfv e shapeId, que restringem sua aplicação. O atributo sfv restringe a regra a dados do estado com a abreviação VA (Virgínia), enquanto o atributo shapeId restringe a regra a mapas com limites de municípios 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 Country como o atributo geográfico primário vir o nome 'St. Thomas' como cidade e 'USA' como país (nos dados do MicroStrategy), ela deverá usar o nome 'St. Thomas, Virgin Islands' em vez de 'St. Thomas' para obter dados do servidor de formas.

Essa regra tem dois atributos, sfv e role, que restringem sua aplicação. O atributo sfv restringe a regra ao país USA, enquanto o atributo role restringe a regra a mapas com Country como o atributo geográfico primário.

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 Country como o atributo geográfico primário vir o nome 'St. Thomas' como cidade e 'USA' como país (nos dados do MicroStrategy), ela deverá usar o nome 'St. Thomas, Virgin Islands' em vez de 'St. Thomas' para obter dados do servidor de formas.

Essa regra tem dois atributos, sfv e role, que restringem sua aplicação. O atributo sfv restringe a regra ao país USA, enquanto o atributo role restringe a regra a mapas com Country como o atributo geográfico primário.

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

Significado: Sempre que qualquer visualização de mapa vir o nome 'Delhi' como cidade e 'India' como país (nos dados do MicroStrategy), ela deverá usar a cadeia 'New Delhi' em vez de 'Delhi' para obter dados do servidor de formas.

Essa regra tem 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 da localização 'Russia': Regras 1, 2, 3 e 4.

• A Regra 1 é uma regra universal que se aplica ao nome da localização principal 'Russia', sem nenhuma outra restrição.

• A Regra 2 é aplicável ao nome da localização 'Russia', mas restringe a aplicação da regra a visualizações com o ESRI como servidor de formas de mapa (scope = "1").

• A Regra 3 é aplicável ao nome da localização 'Russia', mas é ainda mais restritiva. Ele 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 limites de nome de estado dos EUA (shapeId = "400").

• A Regra 4 é aplicável ao nome da localização 'Russia', mas é a mais restritiva de todas. Ela restringe a aplicação da regra a visualizações com ESRI como servidor de forma (escopo = "1") e dados renderizados com limites de nome de estado dos EUA (shapeId = "400"), mas também restringe a aplicação a visualizações com País como a área geográfica primária atributo (função = "3")

Veja a seguir alguns exemplos de resolução de regras para o nome 'Russia' usando as amostras de regras descritas 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 nomes pré-configurado. A Regra 1 do plug-in será aplicada a qualquer linha de dados com 'Russia' como o nome da localização, pois é uma regra universal aplicável 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 tem um atributo scope, e uma regra com esse atributo sempre tem precedência sobre uma regra universal. Se ESRI for o servidor de forma 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 o 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, pois ela é mais restritiva que a Regra 2. Ela tem atributo shape, que é mais restritivo que uma simples restrição de escopo. Se ESRI for o servidor de forma para a visualização do mapa (há uma correspondência no escopo) e o arquivo de forma atual for "Países do mundo" (shapeId="400"), a Regra 3 será aplicada a qualquer linha de dados com ' Rússia' como o 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 apenas 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 que uma simples restrição de escopo. Se ESRI for o servidor de forma para a visualização do mapa (há uma correspondência no escopo) e o arquivo de forma atual for "Países do mundo" (shapeId="400"), a Regra 3 será aplicada a qualquer linha de dados com ' Rússia' como o nome do local; caso contrário, ele 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 Regra 4 estiverem incluídas no plug-in, a visualização tentará primeiro aplicar a Regra 4, pois ela é a mais restritiva de todas. Ela tem um atributo role, que é mais restritivo que um atributo shape. Se ESRI for o servidor de forma para a visualização do mapa (há uma correspondência no escopo) e o atributo geo 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, ela tentará aplicar a Regra 2 e, se a Regra 2 falhar, a Regra 1 do plug-in será aplicada.