Create a key-value pair mapping

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture

    • Key-value pair mappings transform data in the ServiceNow platform to a value that can be plotted on a map. Mappings are used during map source configuration when data requires transformation. Each mapping exists in a mapping group.

    Avant de commencer

    Role required: report_admin or admin.

    Pourquoi et quand exécuter cette tâche

    Default system key-value pairs map data to geoJSON hc-key values. All hc-key values follow ISO 3166 standards. Default mappings exist for the most commonly used data values. If your data uses a different value, you must create a key-value pair mapping.

    For example, the default mapping for United States of America maps key USA to ISO value us. If your data has value of United States instead of USA, you must make a new key-value pair to map United States to ISO value us.

    Procédure

    1. Navigate to the Locations Mappings [sys_report_map_source_mappings] table.
    2. In the Map Source Mapping column, select the mapping group to add the mapping to.
      Select the mapping group that corresponds to type of object that you want to create a mapping for. For example, if you are creating a mapping for field value United States, select the Country mappings group. Note that the Key and Map values in the row with the mapping aren't taken into account.
      Figure 1. Select map source mapping
      Location mappings table with Map Source Mapping column highlighted
    3. Select New.
    4. Fill in these fields.
      Tableau 1. Locations Mappings form
      Field Description
      Key The field value to transform. For example, USA.
      Value The value to transform the key to. For example, us. This value is typically an ISO 3166 standard value. Each value can be used only once per map.
      Map The map to associate with this mapping. If you do not fill in this field, this mapping can be used with any map.
    5. Select Submit to save your changes.

    Que faire ensuite

    Add the mapping to a report source, so it can be used to map data from that source to a map.