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

 Release :

    - yokohama

ft:locale :

    - fr-FR

ft:publication_title :

    - Yokohama Platform Analytics

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: Yokohama
* 
* Mis à jour 30 janv. 2025
* 
* ![](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 lors de 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 geoJSON hc-key. Toutes les valeurs hc-key suivent les normes ISO 3166. Les 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 paire clé-valeur.

Par exemple, le mappage par défaut pour États-Unis d'Amérique mappe les États-Unis clés à 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 source de carte, sélectionnez le groupe de mappage auquel ajouter le mappage.  
   Sélectionnez le groupe de mappage qui correspond 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 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 le mappage de la source de la carte
3. Sélectionnez Nouveau.
4. Renseignez ces champs.  
   {#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. Cette valeur est généralement 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 des 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 les objets de rapport](https://servicenow-prod.fluidtopics.net/9l3_SjnB~_DUfPR~3AofcQ "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/ULa09syxlnXRtMAyoD_cmw "Une hiérarchie de source de carte est une source de données utilisée pour créer un rapport de carte. À l’exception de la couche de niveau supérieur, chaque niveau de source de carte dans la hiérarchie définit les données pour un niveau d’exploration de carte.")
* [Personnaliser un niveau de source de la carte](https://servicenow-prod.fluidtopics.net/7B~~MFNTovPmIsBHu5vCGQ "Une source de carte configure les données à afficher dans un rapport de carte. Personnalisez les sources de cartes existantes en fonction de vos besoins.")
* [Créer une carte](https://servicenow-prod.fluidtopics.net/bvovWoN8c_NsLhJaTHff1A#t_CreateAMap "Créez une carte qui peut être utilisée dans une hiérarchie de carte.")