Origens de mapa para visualizações de dados de mapa geográfico

As visualizações de dados do mapa geográfico estão conectadas a tabelas de localização em uma origem de mapa especial.

As origens de mapa para mapas geográficos são organizadas em hierarquias de origem de mapa. Todas as origens de mapa que fazem referência à mesma tabela estão na mesma hierarquia. Uma hierarquia de origem de mapa consiste em uma origem primária e até quatro níveis de origens secundárias. A origem primária faz referência somente à tabela e as origens secundárias fazem referência aos campos na tabela.

Por padrão, sua instância tem uma hierarquia de origem de mapa para mapas geográficos que faz referência à tabela Local [cmn_location]. Portanto, você pode ter um campo Agrupar por no mapa geográfico que faz referência a um campo em Local. O campo Agrupar por pode estar no nível superior da tabela de fonte de dados ou você pode fazer referência com pontos até ele. Você pode criar hierarquias de origem de mapa adicionais que fazem referência a tabelas de local personalizadas.

Diferenças entre origens de mapa para visualizações de dados e para relatórios

Se você estiver familiarizado com os relatórios de mapa em IU principal, deve ter notado que as origens de mapa para mapas geográficos são diferentes das origens de mapa para relatórios de mapa. Eles são diferentes o suficiente para estar em tabelas de origens de mapa diferentes, sys_report_map_source e viz_map_source. A diferença mais significativa está em como eles fazem referência a tabelas.

Em relatórios de mapa, a origem do mapa faz referência à tabela de fatos, como Incidente [incidente]. A origem do mapa também inclui um campo de referência que aponta para a tabela de locais. As origens de mapa secundário fazem referência com pontos para um campo na tabela de local. Essa estrutura resulta em uma hierarquia de origem de mapa separada para cada tabela de dados que você deseja como fonte de dados para um mapa.

Figura 1. Origens de mapa para relatórios de mapa

As origens de mapa para mapas geográficos apontam diretamente para tabelas de locais. Eles não fazem referência a tabelas de fatos. A tabela de fatos é especificada somente na visualização de dados do mapa geográfico. Com essa estrutura, você pode reutilizar uma hierarquia de mapa para todos os mapas geográficos em sua instância, independentemente dos dados que eles exibem.

Figura 2. Origens de mapa para visualizações de dados de mapa geográfico

Criar uma origem de mapa de visualização de dados

Para usar uma tabela de local personalizada em visualizações de dados de mapa geográfico, defina uma origem de mapa que se vincula à tabela. Adicione mais origens de mapa em diferentes níveis da hierarquia.

Antes de Iniciar

Função necessária: report_admin, viz_admin, pa_admin

Por Que e Quando Desempenhar Esta Tarefa

Procedimento

1. Anexe viz_map_source_list.do ao URL da sua instância no campo URL do navegador.
   Por exemplo, se sua instância for https://instance.example.com, insira https://instance.example.com/viz_map_source_list.do.
2. Verifique se a tabela de locais à qual você deseja fazer referência já foi usada em uma origem de mapa.
   O conjunto de origens de mapa que fazem referência à mesma tabela é chamado de hierarquia de origem de mapa.
3. Se não houver origens de mapa que façam referência à tabela de local desejada, crie a origem de mapa de nível superior para essa tabela:
   1. Selecione Novo.
      Um registro de Origem de mapa [viz_map_source] vazio é aberto.
   2. Especifique as seguintes informações:

      Campo	Descrição
      Nome	Adicione um nome para a origem do mapa. Use um nome descritivo que sugira o conteúdo da tabela. Inclua este nome como parte dos nomes de todas as outras origens de mapa que você criar nesta hierarquia.
      Tabela	Selecione uma tabela de locais que ainda não esteja sendo usada em uma origem de mapa de visualização de dados. A tabela selecionada também não deve fazer referência a uma tabela, como cmn_location, que já está sendo usada em uma origem de mapa de visualização de dados.

   3. Selecione Enviar.
   Agora você tem a origem do mapa primário de uma nova hierarquia de origem de mapa. Você pode adicionar mais níveis à hierarquia.
4. Se houver uma hierarquia de origem de mapa para sua tabela, abra a origem de mapa que está um nível acima da origem de mapa que você deseja criar.
   Nota:

   Você não pode ter mais de quatro níveis de origem de mapa abaixo do primário de nível superior.
5. Na lista relacionada Origens de mapa, selecione Novo.
   Um novo registro de Origem de mapa [viz_map_source] é aberto, com os campos Tabela e Primário somente leitura.
6. Especifique as seguintes informações:

   Tabela 1. Mapear campos de origem

   Campo	Descrição
   Nome	Insira um nome para a origem do mapa. Inclua o nível nos nomes dos níveis de origem do mapa. Geralmente, atribua a todas as origens de mapa na mesma hierarquia o mesmo nome raiz. Diferencie-os somente por nível, como Mapeamento de local (nível 2) e Mapeamento de local (nível 3).
   Tabela (somente leitura)	A mesma tabela é usada em toda uma hierarquia de origem de mapa e é especificada na origem de mapa de nível superior.
   Campo	Selecione um campo de dados de local que seja um nível mais granular do que o mapa em que você está exibindo. Por exemplo, suponha que você esteja configurando dados para uma origem de mapa de nível 1 que é exibida no mapa-múndi. Como os dados dos países são exibidos no mapa do mundo, selecione País do local. Da mesma forma, se você estiver configurando dados a serem exibidos em um mapa da Alemanha ou dos Estados Unidos, selecione Estado/província do local. Nota: A cidade é o nível de local mais granular que você pode exibir ao detalhar um relatório de mapa. Por exemplo: se você quiser relatar vários locais de site em uma cidade e definir o campo de origem do mapa de nível inferior para incluir location.name, o relatório de mapa exibirá os vários locais como os rótulos de cidade correspondentes. Como resultado, a emissão de relatórios sobre vários locais que têm o mesmo valor de location.city resulta na exibição de vários pontos de mapa com o mesmo rótulo, mas com diferentes valores agregados e que detalham diferentes locais.
   Nível	Selecione um nível de hierarquia para esta origem de mapa. Você deve selecionar um nível que seja um nível inferior ao nível da origem do mapa primário. Você pode ter no máximo quatro níveis. Cada nível de origem do mapa corresponde a um nível de detalhamento na hierarquia do mapa e esses níveis são muito correspondentes. Somente uma origem de mapa do mesmo nível pode existir em uma hierarquia ao mesmo tempo.
   Ativo	Desmarque esta caixa de seleção para tornar esta origem de mapa indisponível ao criar relatórios de mapa.

7. Na seção Transformação de dados, especifique as seguintes informações:

   Campo	Descrição
   Como usar dados	Selecione como usar os dados nesta origem de mapa. Usar dados na tabela: use os dados em Now Platform® sem transformá-los. Selecione esta opção quando os dados já corresponderem aos valores de chave JSON para os quais você está mapeando. Mapeamento de uso: o caso de uso mais comum. Transforme os dados para que correspondam aos valores de chave JSON para os quais você está mapeando. Para origens de mapa geográfico que usam a chave geoJSON hc-key, sempre selecione esta opção. Esta opção não pode ser usada com dados abaixo do nível de estado/província, porque a região e o estado são o mapeamento de nível mais baixo. Usar latitude e longitude: sempre selecione esta opção para o nível inferior do mapa, como o nível 3. Certifique-se de que seus dados tenham valores de latitude e longitude. Aviso: Como a opção Usar longitude e latitude desabilita o detalhamento, selecione essa opção somente nos níveis de origem do mapa que são o nível inferior em uma hierarquia.
   Use estes mapeamentos	Se você selecionou Usar mapeamento, selecione um grupo de mapeamento a ser usado. Um grupo de mapeamento é uma coleção de mapeamentos de pares de chave-valor que transformam dados. Para revisar os mapeamentos em um grupo de mapeamento, acesse a tabela Mapeamentos de locais [sys_report_map_source_mapping]. Por exemplo, se você estiver transformando o valor do campo EUA em hc-key value us, selecione Mapeamentos de país, que contém o mapeamento do par de chave-valor relevante.

8. Na seção Chave JSON, selecione uma chave JSON para conectar os dados de origem do mapa aos mapas.
   Mapas geográficos normalmente usam hc-key.

   Cada mapa geográfico tem uma definição JSON. Selecione um par de chave-valor JSON para o qual os dados serão mapeados. Os dados a serem exibidos no mapa devem corresponder aos valores da chave JSON. Portanto, a chave selecionada determina se você deve transformar seus dados com as configurações na seção Como usar dados. Todos os mapas e mapeamentos de plataforma padrão usam os valores padrão geoJSON hc-key e ISO 3166. Para mapas personalizados, você pode inserir uma chave JSON diferente.

9. Selecione Atualizar.