Personnaliser un niveau de source de carte

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 4 minutes de lecture
  • 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.

    Avant de commencer

    Rôle requis : report_admin ou admin

    Pourquoi et quand exécuter cette tâche

    Remarque :
    Un ensemble de sources 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 Tout > Rapports > Administration > Sources de cartes.
    2. Ouvrez la source de carte dont vous souhaitez personnaliser le niveau, puis accédez au niveau approprié à l’aide des listes connexes Sources de carte .
      Par exemple, cliquez sur le nom de la source de la carte de niveau 1 pour rouvrir le formulaire de la source de la carte avec la source de la carte de niveau 2 dans la liste connexe, et ainsi de suite.
    3. Modifiez ces champs comme il convient.
      Tableau 1. Mapper les champs sources
      Champ Description
      Nom Saisissez un nom pour la source de la carte. Incluez le niveau dans les noms des niveaux de source de la carte. Par exemple, Incident par emplacement - niveau 2.
      Table La même table est utilisée dans l’ensemble d’une hiérarchie de 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 effectuer une remontée 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 affichée 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 État/Province de l’emplacement.
      Remarque :
      L’étiquette de ville est le niveau le plus granulaire pouvant être affiché lors de l’exploration dans un rapport cartographique. Par exemple : si vous souhaitez générer des rapports sur différents emplacements de site au sein d’une ville et définir le champ source de la carte de niveau inférieur pour inclure les location.name, le rapport cartographique affiche les emplacements multiples sous forme d’é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 cartographiques 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’analyse sur la hiérarchie des cartes, 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 de données , modifiez ces champs comme il convient.
      Champ Description
      Données Sélectionnez comment utiliser les données dans cette source de la carte.
      • Utiliser des données sur une table : utilisez les données dans la ServiceNow plateforme sans les transformer. Sélectionnez cette option lorsque les données correspondent déjà aux valeurs de clé JSON vers lesquelles vous effectuez le mappage.
      • Utiliser le mappage : transformez ces données pour qu’elles correspondent aux valeurs de clé JSON vers lesquelles vous effectuez le mappage. Pour les sources de cartes 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, tel que le niveau 3. Assurez-vous que vos données ont des valeurs de latitude et de longitude.
        Avertissement :
        Étant donné que l’option 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 inférieur 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 mappage est une collection de mappages de paires clé-valeur qui transforment les données. Pour examiner les mappages d’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 de rapport 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 . Tous les mappages et cartes de plateforme par défaut utilisent les valeurs de la norme geoJSON hc-key et ISO 3166. Pour les cartes personnalisées, vous pouvez entrer une clé JSON différente.

    6. Cliquez sur Mettre à jour.