Sources cartographiques 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 cartes géographiques sont organisées en hiérarchies de sources cartographiques. Toutes les sources cartographiques qui référencent la même table se trouvent dans la même hiérarchie. Une hiérarchie de sources de cartes se compose d’une source parente et d’un maximum de quatre niveaux de sources enfants. La source parente fait uniquement référence à 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 sources de cartes géographiques 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 source de données, ou vous pouvez remonter pas à pas jusqu’à celui-ci. Vous pouvez créer des hiérarchies de sources de cartes supplémentaires qui référencent 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 cartes géographiques sont différentes des sources cartographiques des rapports cartographiques. Ils sont suffisamment différents pour se trouver sur différentes tables, sys_report_map_source et viz_map_source sources Map. 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, telle que Incident [incident]. La source de la carte inclut également un champ de référence qui pointe vers la table d’emplacement. Les sources des cartes enfants retournent pas à pas vers un champ de la table d’emplacement. Cette structure génère une hiérarchie de sources de cartes distincte pour chaque table de données que vous voulez comme source de données pour une carte.

Figure 1. Sources de cartes pour les rapports de carte

Les sources cartographiques des cartes géographiques pointent directement vers des tables d’emplacement. Ils ne font pas référence à des tables de faits La table des faits n’est spécifiée que 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 cartes géographiques de votre instance, quelles que soient les données qu’elles affichent.

Figure 2. Sources cartographiques 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 à 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 sources de cartes.
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 suggérant 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 des données. La table que vous sélectionnez ne doit pas non plus référencer une table, telle que cmn_location, qui est déjà utilisée dans une source de carte de visualisation des données.

   3. Sélectionnez Soumettre.
   Vous avez maintenant la source de carte parente 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 la carte qui se trouve à un niveau au-dessus de la source de la carte que vous voulez créer.
   Remarque :

   Vous ne pouvez pas avoir plus de quatre niveaux de source de carte en dessous du parent de niveau supérieur.
5. Dans la liste connexe Map sources (Sources cartographiques ), sélectionnez New (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. Champs de source de carte

   Champ	Description
   Nom	Entrez un nom pour la source de la carte. Incluez le niveau dans les noms des niveaux de source de carte. Donne généralement le même nom de racine à toutes les sources cartographiques de la même hiérarchie. Différenciez-les uniquement par niveau, comme le mappage des emplacements (niveau 2) et le mappage des emplacements (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 cartographique 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 lorsque vous explorez un rapport cartographique. Par exemple : si vous souhaitez générer des rapports sur différents emplacements du site dans une ville et définir le champ source de la 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 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 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 source de carte correspond à un niveau d’exploration sur la hiérarchie de carte, et ces niveaux correspondent beaucoup. Une seule source de carte de même niveau peut exister dans une hiérarchie à la fois.
   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 de cette source de carte. Utiliser les données dans la table : utiliser 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 sur lesquelles vous effectuez le mappage. Utiliser le mappage : cas d’utilisation le plus courant. Transformez les données afin qu’elles correspondent aux valeurs de clé JSON sur lesquelles vous effectuez le mappage. Pour les sources cartographiques 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 inférieures au niveau de l’état/de la province, car Région et é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, 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 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 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 paires 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 . Toutes les cartes et tous les mappages de plate-forme par défaut utilisent les valeurs de la clé hc geoJSON et de la norme ISO 3166. Pour les cartes personnalisées, vous pouvez saisir une clé JSON différente.

9. Sélectionnez Mettre à jour.