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 de carte spéciale.

Les sources de cartes pour les cartes géographiques sont organisées en hiérarchies de sources de cartes. Toutes les sources de carte qui font référence à la même table sont dans la même hiérarchie. Une hiérarchie de sources de carte se compose d’une source parente et d’un maximum de quatre niveaux de sources enfants. La source parente 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 des sources de cartes 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 Grouper par peut se trouver au niveau supérieur de la table de sources de données, ou vous pouvez effectuer une remontée 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 cartographiques dans Interface utilisateur principale, vous avez peut-être remarqué que les sources cartographiques des géocartes sont différentes de celles des rapports cartographiques. Ils sont suffisamment différents pour figurer sur différentes tables, sys_report_map_source et viz_map_source sources de cartes. 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. Remontée pas à pas des sources de cartes enfants 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 à des tables de faits. La table de 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 carte 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 carte qui font référence à la même table est appelé hiérarchie de source de carte.
3. S’il n’existe aucune source de carte qui 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. Renseignez 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 que 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 Sources de carte , sélectionnez Nouveau.
   Un nouvel enregistrement Source de carte [viz_map_source] s’ouvre, avec les champs Table et Parent en lecture seule.
6. Renseignez les informations suivantes :

   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. En général, attribuez le même nom de racine à toutes les sources de carte d’une 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 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 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 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 : La ville est le niveau d’emplacement le plus granulaire que vous pouvez afficher lorsque vous explorez un rapport de carte. 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.
   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’analyse sur la hiérarchie des cartes, 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 des données , spécifiez les informations suivantes :

   Champ	Description
   Comment utiliser les données	Sélectionnez comment utiliser les données dans cette source de la carte. Utiliser les données sur la table : utilisez les données dans le Now 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 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.

8. 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 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 . 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.

9. Sélectionnez Mettre à jour.