---
sourceDocument: Yokohama Platform Analytics
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/now-intelligence

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Crie um mapeamento de par chave-valor

# Crie um mapeamento de par chave-valor {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

Os mapeamentos de pares chave-valor transformam dados no ServiceNowpara um valor que pode ser plotado em um mapa. Os mapeamentos são usados durante a configuração da origem do mapa quando os dados exigem transformação. Cada mapeamento existe em um grupo de mapeamento.

## Antes de Iniciar

Função necessária: Report_admin ou admin.

## Por Que e Quando Desempenhar Esta Tarefa

Os pares de chave-valor do sistema padrão mapeiam dados para valores de chave hc geoJSON. Todos os valores de hc-key seguem as normas ISO 3166. Existem mapeamentos padrão para os valores de dados mais usados. Se seus dados usarem um valor diferente, você deverá criar um mapeamento de par chave-valor.

Por exemplo, o mapeamento padrão para Estados Unidos da América mapeia a chave EUA para `ISO `valor `eua `. Se seus dados tiverem valor de Estados Unidos em vez de EUA, você deverá criar um novo par chave-valor para mapear `Estados Unidos `Para o valor ISO `eua `.

## Procedimento

1. Navegue até a tabela Mapeamentos de locais \[sys_report_map_source_mappings\].
2. Em Mapeamento de origem do mapa selecione o grupo de mapeamento ao qual adicionar o mapeamento.  
   Selecione o grupo de mapeamento que corresponde ao tipo de objeto para o qual você deseja criar um mapeamento. Por exemplo, se você estiver criando um mapeamento para o valor de campo Estados Unidos, selecione Mapeamentos de país grupo. Observe que os valores de Chave e Mapa na linha com o mapeamento não são levados em consideração. Figura 1. Selecione Mapeamento de origem do mapa
3. Selecione Novo.
4. Preencha estes campos.  
   {#t_CreateKeyValuePairMapping__table_pkd_3xx_bv__entry__2}

   | Campo | Descrição |
   |-|-|
   | Chave | O valor de campo para transformar. Por exemplo, EUA. |
   | Valor | O valor para transformar a chave. Por exemplo, nós. Normalmente, este valor é um valor padrão ISO 3166. Cada valor pode ser usado apenas uma vez por mapa. |
   | Mapa | O mapa a ser associado a este mapeamento. Se você não preencher este campo, este mapeamento poderá ser usado com qualquer mapa. |
   [Tabela 1. Formulário de Mapeamentos de locais]

   {#t_CreateKeyValuePairMapping__table_pkd_3xx_bv}
5. Selecione Enviar para salvar suas mudanças.

## O que Fazer Depois

Adicione o mapeamento a uma origem de relatório para que ele possa ser usado para mapear dados dessa origem para um mapa.
**Conceitos relacionados**   

* [Objetos de relatório do mapa](https://servicenow-prod.fluidtopics.net/jSua6KeiEQzXGm8~lWWHaw "Os objetos de mapa definem os diferentes níveis que os usuários podem detalhar em um relatório de mapa e os dados exibidos nesses níveis. Os administradores podem criar e gerenciar esses objetos.")  
**Tarefas relacionadas**   

* [Gere automaticamente uma hierarquia de origem do mapa](https://servicenow-prod.fluidtopics.net/VlZqFdBVx6Ak5qAmwuYVSg "Uma hierarquia de origem de mapa é uma fonte de dados usada para criar um relatório de mapa. Com exceção do wrapper de nível superior, cada nível de origem de mapa na hierarquia define os dados para um nível de detalhamento de mapa.")
* [Personalize um nível de origem do mapa](https://servicenow-prod.fluidtopics.net/E_mLw3NPpY52~dLZ90kbEQ "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.")
* [Crie um mapa](https://servicenow-prod.fluidtopics.net/PBdXyGxVYRwfZ71b8wEEkg#t_CreateAMap "Crie um mapa que possa ser usado em uma hierarquia de mapa.")