Mapeie origens para visualizações de dados do geomap

As visualizações de dados do GeoMap são conectadas a tabelas de localização em uma origem de mapa especial.

As origens do mapa para Geomaps são organizadas em hierarquias de origem do 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 aos campos de referência de origens secundárias na tabela.

Por padrão, sua instância tem uma hierarquia de origem de mapa para Geomaps 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 da fonte de dados ou você pode fazer um passeio 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 relatórios

Se você estiver familiarizado com relatórios de mapa em IU principal, você deve ter notado que as origens de mapa para geomaps 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á na forma como eles fazem referência às 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 localização. Mapa secundário de origens com pontos para um campo na tabela de localização. 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 do mapa para Geomaps apontam diretamente para as tabelas de localização. Eles não fazem referência a tabelas de fatos. A tabela de fatos é especificada somente na visualização de dados do geomap. Graças a essa estrutura, você pode reutilizar uma hierarquia de mapa para todos os Geomaps em sua instância, independentemente dos dados exibidos.

Figura 2. Mapeie origens para visualizações de dados do geomap

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

Para usar uma tabela de local personalizada em visualizações de dados do geomap, defina uma origem de mapa vinculada à 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. Anexar viz_map_source_list.do Para a URL da 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 local que você deseja referenciar já está sendo usada em uma origem de mapa.
   O conjunto de origens de mapa que fazem referência à mesma tabela é chamado A. mapear hierarquia de origem .
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 vazio [viz_map_source] é 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ê cria nesta hierarquia.
      Tabela	Selecione uma tabela de local 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 do mapa. Você pode adicionar mais níveis à hierarquia.
4. Se existir 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 do mapa abaixo do primário de nível superior.
5. Em Origens do mapa lista relacionada, selecione Novo .
   Um novo registro de origem de mapa [viz_map_source] é aberto, com os campos Tabela e Pai somente leitura.
6. Especifique as seguintes informações:

   Tabela 1. Campos de origem do mapa

   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. Em geral, dê a todas as origens de mapa na mesma hierarquia o mesmo nome de 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 localização que seja um nível mais granular do que o mapa em que você está exibindo. Por exemplo, imagine que você está configurando dados para uma fonte de mapa de nível 1 que é exibida no mapa mundial. Como os dados dos países são exibidos no mapa mundial, selecione País do local . Da mesma forma, se você estiver configurando dados para exibir 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 location.city resulta na exibição de vários pontos do mapa com o mesmo rótulo, mas com valores agregados diferentes e que detalham locais diferentes.
   Nível	Selecione um nível de hierarquia para esta origem de mapa. Você deve selecionar um nível um nível menor do que o nível da origem do mapa primário. Você pode ter no máximo quatro níveis. Cada nível de origem de mapa corresponde a um nível de detalhamento na hierarquia de mapa, e esses níveis correspondem muito. Apenas 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. Em Transformação de dados especifique as seguintes informações:

   Campo	Descrição
   Como usar dados	Selecione como usar dados nesta origem de mapa. Use dados na tabela : Use os dados no ServiceNow AI Platform® sem transformar a ti. Selecione esta opção quando os dados já corresponderem aos valores de chave JSON para os quais você está mapeando. Usar mapeamento : 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 Região e estado é o mapeamento de nível mais baixo. Use latitude e longitude : Sempre selecione esta opção para o nível de mapa inferior, como o nível 3. Certifique-se de que seus dados tenham valores de latitude e longitude. Aviso: . Use longitude e latitude a opção desabilita o detalhamento, selecione esta 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 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 para o valor de chave hc eua , selecione Mapeamentos de país , que contém o mapeamento de par chave-valor relevante.

8. Em Chave JSON Selecione uma chave JSON para conectar os dados de origem do mapa aos mapas.
   Os mapas geográficos normalmente usam hc-key.

   Cada geomap tem uma definição JSON. Selecione um par de chave-valor JSON para mapear os dados. 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 no Como usar dados seção. Todos os mapeamentos e mapas de plataforma padrão usam o. GeoJSON Valores padrão hc-KEY e ISO 3166. Para mapas personalizados, você pode inserir uma chave JSON diferente.

9. Selecione Atualizar.