Painel de Mapa

App Builder tem uma opção de painel Mapa que suporta a exibição de um Mapa onde os Controles podem ser visualizados por meio da localização geográfica. Diferentes mapas fornecidos pela API Highmaps podem ser escolhidos com base nos dados que você deseja exibir.

Os nomes das regiões do mapa no seu Objeto de Negócio subjacente devem corresponder aos identificadores dos mapas de origem do Highmaps; isso pode exigir atenção extra para garantir que a chave do seu Objeto de Negócio possa ser reconhecida pelo mapa de origem.

Por exemplo, se você tiver um Objeto Comercial com nomes de Condados dos EUA, os nomes de Condados podem não ser exclusivos; nesse caso, você deve ter uma coluna que corresponda à chave do Highmaps.

A seguir estão os dados dos condados dos EUA recuperados da API Highmaps:

Se seus dados tiverem um hífen, o mapa de origem será unido por padrão por hc-key, caso contrário, será unido ao nome. Dependendo do mapa de origem escolhido, pode haver padrões intermediários aos quais o mapa de origem tentará se unir em seus dados fornecidos.

Por favor, consulte https://api.highcharts.com/highmaps/ para documentação sobre mapas de origem fornecidos no painel de mapas. Você também pode visitar http://code.highcharts.com/mapdata/ para demonstrações dos conjuntos de dados.

Os painéis de mapa permitem que um usuário ampliar o próprio gráfico, para visualizar uma determinada região de informações ampliada do gráfico. Para ampliar, clique com o botão esquerdo e role para frente, depois clique com o botão esquerdo e arraste o mapa na direção que puxa a área de foco desejada para o centro da tela. Para diminuir o zoom, clique com o botão esquerdo e role para trás.

Para criar um painel de mapa, você precisará de um objeto de negócios que contenha informações para os controles que o gráfico requer. Como outros painéis de gráfico, Categoria e Valor são controles obrigatórios; Cor e Objeto de opções JSON são valores opcionais que também podem ser armazenados.

Um objeto de negócios de exemplo terá uma localização geográfica como uma categoria e uma quantidade de algum atributo associado à localização como um valor.

Dados de Exemplo

O Business Object usado para criar este mapa usou a tabela Northwinds Customers e tem apenas duas colunas: Country e CountryCount (usando a expressão Count(1)). Isso fornece ao Map Panel o Country Name e o número de registros Customer por país.

A coluna País corresponde à propriedade "nome" da API do Highmaps, o que neste caso não causou problemas, pois os nomes dos países eram exclusivos.

Como Criar um Painel de Mapa

Isso pressupõe que você já tenha um Objeto de Negócios que contém todos os Controles com os quais você precisa trabalhar para o Painel de Mapa.

1. Crie uma Página Dinâmica para conter o painel de Mapa
2. Adicione um painel à página, selecione Mapa como o Tipo
3. Para a Fonte selecione o Objeto de Negócios criado para o Painel de Mapa

4. Para Fonte do Mapa escolha um mapa que melhor represente seus dados.

   • Exemplo é custom/world/world

5. Adicione os Controles necessários para o tipo de Painel de Mapa que está sendo criado:

   • Categoria é necessária. Por exemplo: País
   • Valor é necessário. Por exemplo: Contagem de País
   • Objeto de Opção JSON é opcional Cor é opcional

6. Execute a Página e teste o Painel de Mapa