Créer un mappage de paire clé-valeur

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 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 ISOus. 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
      Table de mappages des emplacements avec colonne Mappage de source de carte en surbrillance
    3. Sélectionnez Nouveau.
    4. Renseignez les champs suivants.
      Tableau 1. Formulaire Mappages des emplacements
      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.
    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.