---
sourceDocument: Analyse de la plateforme Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Analyse de la plateforme Xanadu

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Créer un mappage de paire clé-valeur

# Créer un mappage de paire clé-valeur {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute de lecture

Les mappages de paires clé-valeur transforment les données de la ServiceNow plateforme en une valeur qui peut être tracée sur une carte. Les mappages sont utilisés pendant la configuration de la source de la carte lorsque les données nécessitent une transformation. Chaque mappage existe dans un groupe de mappage.

## Avant de commencer

Rôle requis : report_admin ou admin.

## Pourquoi et quand exécuter cette tâche

Les paires clé-valeur système par défaut mappent les données aux valeurs de clé hc GeoJSON. Toutes les valeurs de clé hc sont conformes à la norme ISO 3166. Des mappages par défaut existent pour les valeurs de données les plus couramment utilisées. Si vos données utilisent une valeur différente, vous devez créer un mappage de paires clé-valeur.

Par exemple, le mappage par défaut pour États-Unis d'Amérique mappe la clé USA à la valeur `ISO``us`. Si vos données ont la valeur États-Unis au lieu de États-Unis, vous devez créer une nouvelle paire clé-valeur pour mapper `États-Unis` à la valeur ISO `us`.

## Procédure

1. Accédez à la table Mappages des emplacements \[sys_report_map_source_mappings\].
2. Dans la colonne Mappage de la source de la carte, sélectionnez le groupe de mappage auquel ajouter le mappage.  
   Sélectionnez le groupe de mappage correspondant au type d'objet pour lequel vous souhaitez créer un mappage. Par exemple, si vous créez un mappage pour la valeur de champ États-Unis, sélectionnez le groupe Country mappings (Mappages de pays). Notez que les valeurs Clé et Carte de la ligne avec le mappage ne sont pas prises en compte. Figure 1. Sélectionner un mappage de source de carte
3. Sélectionnez Nouveau.
4. Renseignez les champs suivants.  
   {#t_CreateKeyValuePairMapping__table_pkd_3xx_bv__entry__2}

   | Champ | Description |
   |-|-|
   | Clé | La valeur de champ à transformer. Par exemple, les États-Unis. |
   | Valeur | Valeur à laquelle la clé doit être transformée. Par exemple, nous. Il s'agit généralement d'une valeur standard ISO 3166. Chaque valeur ne peut être utilisée qu'une seule fois par carte. |
   | Carte | Carte à associer à ce mappage. Si vous ne renseignez pas ce champ, ce mappage peut être utilisé avec n'importe quelle carte. |
   [Tableau 1. Formulaire Mappages d'emplacements]

   {#t_CreateKeyValuePairMapping__table_pkd_3xx_bv}
5. Sélectionnez Soumettre pour enregistrer vos changements.

## Que faire ensuite

Ajoutez le mappage à une source de rapport afin qu'il puisse être utilisé pour mapper les données de cette source à une carte.
**Concepts associés**   

* [Mapper des objets de rapport](https://servicenow-prod.fluidtopics.net/Zkjncb_WnhcIExu2S28vNA "Les objets de carte définissent les différents niveaux que les utilisateurs peuvent explorer dans un rapport de carte et les données affichées à ces niveaux. Les administrateurs peuvent créer et gérer ces objets.")  
**Tâches associées**   

* [Générer automatiquement une hiérarchie de la source de la carte](https://servicenow-prod.fluidtopics.net/u61hzWXITvjeDh5LtTkM2g "Une hiérarchie de source de carte est une source de données qui est utilisée pour créer un rapport de carte. À l’exception de la couche de niveau supérieur, chaque niveau de source de carte de la hiérarchie définit les données d’un niveau d’exploration de carte.")
* [Personnaliser un niveau de source de carte](https://servicenow-prod.fluidtopics.net/WdBnwEJEsziR54kBzVVfzg "Une source de carte configure les données à afficher dans un rapport de carte. Personnalisez les sources cartographiques existantes en fonction de vos besoins.")
* [Créer une carte](https://servicenow-prod.fluidtopics.net/u558BCLfsa5OKahaVLutOg#t_CreateAMap "Créez une carte qui peut être utilisée dans une hiérarchie de carte.")