Personnaliser un niveau de source de carte

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 minutes de lecture
  • Une source de carte configure les données à afficher dans un rapport de carte. Personnalisez les sources de carte existantes en fonction de vos besoins.

    Avant de commencer

    Rôle requis : report_admin ou admin

    Pourquoi et quand exécuter cette tâche

    Remarque :
    Un ensemble de sources et de cartes de cartes prédéfinies est disponible par défaut. Utilisez ces objets prédéfinis dans la mesure du possible. Si vous avez besoin d’une source de carte qui n’existe pas, générez-la automatiquement à l’aide du lien Générer les niveaux de source de carte sur le formulaire de source de carte, puis personnalisez-la. Vous pouvez générer automatiquement des niveaux de source de carte uniquement pour les sources de carte qui font référence à la table d’emplacement. Ces sources de carte ont un champ qui se termine par .location.

    Procédure

    1. Accédez à la Tous > Rapports > Administration > Sources de cartes.
    2. Ouvrez la source de la carte dont vous souhaitez personnaliser le niveau, puis accédez au niveau approprié à l’aide des listes connexes Sources de la carte .
      Par exemple, cliquez sur le nom de la source de carte de niveau 1 pour rouvrir le formulaire Source de la carte avec la source de carte de niveau 2 dans la liste connexe, et ainsi de suite.
    3. Modifiez ces champs comme il vous convient.
      Tableau 1. Mapper les champs sources
      Champ Description
      Nom Entrez un nom pour la source de la carte. Inclure le niveau dans les noms des niveaux de source de carte. Par exemple, Incident par emplacement - niveau 2.
      Table La même table est utilisée dans toute la hiérarchie d’une source de carte et est spécifiée dans la source de carte de niveau supérieur.
      Champ Sélectionnez le champ dont vous souhaitez afficher les données sur la carte. Vous pouvez remonter pas à pas vers d’autres champs. Sélectionnez un champ qui est un niveau plus granulaire que la carte sur laquelle vous souhaitez afficher les données.
      Par exemple, imaginez que vous configurez des données pour une source de carte de niveau 1 qui s’affiche sur la carte du monde. Étant donné que les données des pays sont affichées sur la carte du monde, sélectionnez Pays de l’emplacement. De même, si vous configurez des données à afficher sur une carte de l’Allemagne ou des États-Unis, sélectionnez Emplacement, État/Province.
      Remarque :
      L’étiquette de ville est le niveau le plus granulaire pouvant être affiché lors de l’exploration d’un rapport cartographique. Par exemple : si vous souhaitez générer un rapport sur divers emplacements de site au sein d’une ville et définir le champ source de carte de niveau inférieur pour inclure location.name, le rapport de carte affiche les emplacements multiples en tant qu’étiquettes de ville correspondantes. Par conséquent, la génération de rapports sur plusieurs emplacements qui ont la même valeur location.city entraîne l’affichage de plusieurs points de carte avec la même étiquette, mais avec des valeurs agrégées différentes, et qui explorent différents emplacements.

      La plupart des sources de carte utilisent un champ sur la table Emplacement.

      Niveau Sélectionnez un niveau hiérarchique pour cette source de la carte. Vous pouvez avoir un maximum de quatre niveaux. Chaque niveau de source de carte correspond à un niveau d’exploration sur la hiérarchie de carte, et ces niveaux correspondent beaucoup. Chaque niveau ne doit exister qu’une seule fois dans une hiérarchie.
      Actif Décochez cette case pour rendre cette source de carte indisponible lors de la création de rapports de carte.
    4. Dans la section Transformation des données , modifiez ces champs comme il convient.
      Champ Description
      Données Sélectionnez le mode d’utilisation des données dans cette source de carte.
      • Utiliser des données dans une table : utilisez les données de la ServiceNow plateforme sans les transformer. Sélectionnez cette option lorsque les données correspondent déjà aux valeurs de clé JSON auxquelles vous effectuez le mappage.
      • Utiliser le mappage : transformez ces données afin qu’elles correspondent aux valeurs de clé JSON vers lesquelles vous effectuez le mappage. Pour les sources cartographiques géographiques qui utilisent la clé geoJSON hc-key, sélectionnez toujours cette option.
      • Utiliser la longitude et la latitude : utilisez les coordonnées de latitude et de longitude pour tracer vos données. Sélectionnez toujours cette option pour le niveau inférieur de la carte, par exemple le niveau 3. Assurez-vous que vos données ont des valeurs de latitude et de longitude.
        Avertissement :
        Étant donné que l’option Use longitude and latitude (Utiliser la longitude et la latitude ) désactive la carte thermique et l’exploration pour les cartes utilisant cette source de carte, sélectionnez cette option uniquement sur les niveaux de source de carte qui sont le niveau le plus bas d’une hiérarchie.
      Utiliser ces mappages Si vous avez sélectionné Utiliser le mappage, sélectionnez un groupe de mappage à utiliser. Un groupe de mappages est une collection de mappages de paires clé-valeur qui transforment les données. Pour examiner les mappages dans un groupe de mappage, accédez à la table Mappages des emplacements [sys_report_map_source_mapping].

      Par exemple, si vous transformez la valeur de champ USA en valeur de clé hc us, sélectionnez Mappages de pays, qui contient le mappage de paire clé-valeur pertinent.

    5. Dans la section Clé JSON , sélectionnez une clé JSON pour connecter la source de données de la carte aux cartes.
      Les cartes géographiques utilisent généralement hc-key.

      Chaque carte des rapports a une définition JSON. Sélectionnez une paire clé-valeur JSON à laquelle mapper les données. Les données à afficher sur la carte doivent correspondre aux valeurs de clé JSON. Ainsi, la clé que vous sélectionnez détermine si vous devez transformer vos données avec les paramètres de la section Comment utiliser les données . Toutes les cartes et mappages de plateforme par défaut utilisent la clé hc geoJSON et les valeurs standard ISO 3166. Pour les cartes personnalisées, vous pouvez entrer une clé JSON différente.

    6. Cliquez sur Mettre à jour.