Sources de cartes pour les visualisations de données de carte géographique

Les visualisations de données de carte géographique sont connectées aux tables d’emplacement dans une source cartographique spéciale.

Les sources cartographiques des géocartes sont organisées en hiérarchies de sources de cartes. Toutes les sources de cartes qui font référence à la même table sont dans la même hiérarchie. Une hiérarchie de source de carte se compose d’une source parente et d’un maximum de quatre niveaux de sources enfants. La source parent fait référence uniquement à la table et les champs de référence des sources enfants dans la table.

Par défaut, votre instance dispose d’une hiérarchie de source de carte pour les géocartes qui fait référence à la table Emplacement [cmn_location]. Vous pouvez donc avoir un champ Grouper par sur votre carte géographique qui fait référence à un champ sur Emplacement. Le champ Group by (Grouper par) peut se trouver au niveau supérieur de la table de sources de données, ou vous pouvez remonter pas à pas vers celui-ci. Vous pouvez créer des hiérarchies de sources de cartes supplémentaires qui font référence à des tables d’emplacement personnalisées.

Différences entre les sources de cartes pour les visualisations de données et pour les rapports

Si vous connaissez les rapports de carte dans Interface utilisateur principale, vous avez peut-être remarqué que les sources de carte pour les géocartes sont différentes des sources de carte pour les rapports de carte. Elles sont suffisamment différentes pour figurer sur différentes tables de sources de carte, sys_report_map_source et viz_map_source. La différence la plus significative réside dans la façon dont ils référencent les tables.

Dans les rapports de carte, la source de la carte fait référence à la table de faits, par exemple Incident [incident]. La source de la carte comprend également un champ de référence qui pointe vers la table d’emplacement. Les sources de cartes enfants remontent à pas vers un champ de la table d’emplacement. Cette structure se traduit par une hiérarchie de source de carte distincte pour chaque table de données que vous souhaitez utiliser comme source de données pour une carte.

Figure 1. Sources de cartes pour les rapports de carte

Les sources de cartes géographiques pointent directement vers les tables d’emplacements. Ils ne font pas référence aux tables de faits. La table des faits est spécifiée uniquement dans la visualisation des données de la carte géographique. Grâce à cette structure, vous pouvez réutiliser une hiérarchie de cartes pour toutes les géocartes de votre instance, quelles que soient les données qu’elles affichent.

Figure 2. Sources de cartes pour les visualisations de données de carte géographique

Créer une source de carte de visualisation des données

Pour utiliser une table d’emplacement personnalisée dans les visualisations de données de carte géographique, définissez une source de la carte qui est liée à la table. Ajoutez d’autres sources de cartes à différents niveaux de la hiérarchie.

Avant de commencer

Rôle requis : report_admin, viz_admin pa_admin

Pourquoi et quand exécuter cette tâche

Procédure

1. Ajoutez viz_map_source_list.do à l’URL de votre instance dans le champ URL du navigateur.
   Par exemple, si votre instance est https://instance.example.com, saisissez https://instance.example.com/viz_map_source_list.do.
2. Vérifiez si la table d’emplacement que vous souhaitez référencer est déjà utilisée dans une source de carte.
   L’ensemble des sources de cartes qui font référence à la même table est appelé hiérarchie de source de carte.
3. Si aucune source de carte ne fait référence à la table d’emplacement souhaitée, créez la source de carte de niveau supérieur pour cette table :
   1. Sélectionnez Nouveau.
      Un enregistrement de source de carte [viz_map_source] vide s’ouvre.
   2. Spécifiez les informations suivantes :

      Champ	Description
      Nom	Ajoutez un nom pour la source de la carte. Utilisez un nom descriptif qui suggère le contenu de la table. Incluez ce nom dans le cadre des noms de toutes les autres sources de cartes que vous créez dans cette hiérarchie.
      Table	Sélectionnez une table d’emplacement qui n’est pas déjà utilisée dans une source de carte de visualisation de données. La table que vous sélectionnez ne doit pas non plus faire référence à une table, telle qu’cmn_location, qui est déjà utilisée dans une source de carte de visualisation de données.

   3. Sélectionnez Soumettre.
   Vous avez maintenant la source de carte parent d’une nouvelle hiérarchie de source de carte. Vous pouvez ajouter d’autres niveaux à la hiérarchie.
4. S’il existe une hiérarchie de source de carte pour votre table, ouvrez la source de carte située un niveau au-dessus de la source de carte que vous souhaitez créer.
   Remarque :

   Vous ne pouvez pas avoir plus de quatre niveaux de source de carte sous le parent de niveau supérieur.
5. Dans la liste connexe des sources de carte , sélectionnez Nouveau.
   Un nouvel enregistrement de source de carte [viz_map_source] s’ouvre, avec les champs Table et Parent en lecture seule.
6. Spécifiez les informations suivantes :

   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 la carte. Attribue généralement le même nom de racine à toutes les sources de carte de la même hiérarchie. Différenciez-les uniquement par niveau, tel que le mappage d’emplacement (niveau 2) et le mappage d’emplacement (niveau 3).
   Table (lecture seule)	La même table est utilisée dans toute une hiérarchie de source de carte et est spécifiée dans la source de carte de niveau supérieur.
   Champ	Sélectionnez un champ de données d’emplacement qui est un niveau plus granulaire que la carte sur laquelle vous l’affichez. 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 État / Province de l’emplacement. Remarque : La ville est le niveau d’emplacement le plus granulaire que vous pouvez afficher lors de l’exploration d’un rapport cartographique. Par exemple : si vous souhaitez générer un rapport 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 location.name, le rapport cartographique affiche les emplacements multiples sous forme d’étiquettes de ville correspondantes. Par conséquent, la création 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 vers différents emplacements.
   Niveau	Sélectionnez un niveau hiérarchique pour cette source de la carte. Vous devez sélectionner un niveau inférieur d’un niveau au niveau de la source de la carte parente. Vous pouvez avoir un maximum de quatre niveaux. Chaque niveau de source de carte correspond à un niveau d’exploration dans la hiérarchie de carte, et ces niveaux correspondent beaucoup. Une seule source de carte du même niveau peut exister dans une hiérarchie en même temps.
   Actif	Décochez cette case pour rendre cette source de carte indisponible lors de la création de rapports de carte.

7. Dans la section Transformation de données , spécifiez les informations suivantes :

   Champ	Description
   Comment utiliser les données	Sélectionnez le mode d’utilisation des données dans cette source de la carte. Utiliser des données sur une table : utilisez les données dans le ServiceNow AI Platform® 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. Mappage d’utilisation : cas d’utilisation le plus courant. Transformez les 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. Cette option ne peut pas être utilisée avec des données en dessous du niveau de l’État/de la province, car la région et l’état constituent le mappage de niveau le plus bas. Utiliser la latitude et la longitude : 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 l’exploration, 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 un ensemble de mappages de paires clé-valeur qui transforment les données. Pour examiner les mappages dans un groupe de mappages, 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.

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

   Chaque carte géographique 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 tous les mappages de plateforme par défaut utilisent la clé hc geoJSON et les valeurs de la norme ISO 3166. Pour les cartes personnalisées, vous pouvez saisir une autre clé JSON.

9. Sélectionnez Mettre à jour.