Personalizar um nível de origem de mapa

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 4 min. de leitura

    • Uma origem de mapa configura os dados a serem exibidos em um relatório de mapa. Personalize as origens de mapa existentes de acordo com suas necessidades.

    Antes de Iniciar

    Função necessária: report_admin ou admin

    Por Que e Quando Desempenhar Esta Tarefa

    Nota:
    Um conjunto de origens de mapa predefinidas e mapas estão disponíveis por padrão. Use esses objetos predefinidos sempre que possível. Se você precisar de uma origem de mapa que não existe, gere-a automaticamente usando o link Gerar níveis de origem de mapa no formulário de origem de mapa e personalize-a. Você pode gerar automaticamente níveis de origem de mapa somente para origens de mapa que fazem referência à tabela de local. Essas origens de mapa têm um campo que termina em .location.

    Procedimento

    1. Navegar até Todos > Relatórios > Administração > Origens do Mapa.
    2. Abra a origem do mapa cujo nível você deseja personalizar e navegue até o nível apropriado usando as listas relacionadas Origens do mapa.
      Por exemplo, clique no nome da origem do mapa de nível 1 para reabrir o formulário de origem do mapa com a origem do mapa de nível 2 na lista relacionadae assim por diante.
    3. Modifique esses campos conforme apropriado.
      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. Por exemplo, Incidente por local - nível 2.
      Tabela A mesma tabela é usada em toda uma hierarquia de origem de mapa e é especificada na origem de mapa de nível superior.
      Campo Selecione o campo cujos dados você deseja exibir no mapa. Você pode fazer referência com pontos em outros campos. Selecione um campo que seja um nível mais granular do que o mapa no qual você deseja exibir os dados.
      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-múndi, 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:
      O rótulo da cidade é o nível mais granular que pode ser exibido ao detalhar um relatório de mapa. Por exemplo: se você quiser gerar relatórios sobre vários locais em uma cidade e definir o campo de origem do mapa de nível inferior para incluir location.name, o relatório do mapa exibirá os vários locais como os rótulos da cidade correspondente. Como resultado, o relatório de 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 locais diferentes.

      A maioria das origens de mapa usa um campo na tabela Local.
      Nível Selecione um nível de hierarquia para esta origem de mapa. 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. Cada nível deve existir em uma hierarquia apenas uma vez.
      Ativo Desmarque esta caixa de seleção para tornar esta origem de mapa indisponível ao criar relatórios de mapa.
    4. Na seção Transformação de dados, modifique esses campos conforme apropriado.
      Campo Descrição
      Dados Selecione como usar os dados nesta origem de mapa.
      • Usar dados na tabela: use os dados na plataforma ServiceNow sem transformá-los. Selecione esta opção quando os dados já corresponderem aos valores da chave JSON para os quais você está mapeando.
      • Usar mapeamento: transforme esses dados para que correspondam aos valores da 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.
      • Usar longitude e latitude: use coordenadas de latitude e longitude para plotar seus dados. 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 mapa térmico e o detalhamento para mapas que usam esta origem de mapa, selecione esta opção somente nos níveis de origem de mapa que estão no 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 chave-valor relevante.
    5. 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 de relatório 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 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.

    6. Clique em Atualizar.