Utiliser une instance de données locale avec une visualisation des données

Pour un contrôle plus précis de la source de données qu’avec des sources de données préconfigurées, créez une instance de données locale. Liez ensuite l’instance de données locale à la dataPassthrough propriété de visualisation des données.

Avant de commencer

Important :

Il s’agit d’une procédure avancée. Déterminez si vous avez besoin d’une instance de données locale ou si vous pouvez utiliser une source de données standard.

Avant de poursuivre, examinez Dynamically expose data in UI Builder pages (advanced feature).

Rôle requis : ui_builder_admin, admin

Procédure

1. Ouvrez le tableau de bord technique ou une autre Générateur d'IU page dans Générateur d'IU.
2. Dans le tiroir Données et scripts, sous Ressources de données, sélectionnez + Ajouter une ressource de données.
   
   
   
3. Dans la fenêtre Sélectionner une ressource de données, recherchez Visualisation des données.
   Vous obtenez une sélection des ressources de données que vous pouvez utiliser.
   
   
4. Sélectionnez une ressource de données qui correspond au type de données que vous souhaitez afficher.
5. Lisez le volet d’informations et copiez ou prenez des notes sur les détails de configuration.
6. Sélectionnez Ajouter.
7. Complétez les options de configuration dont vous avez besoin pour le type de visualisation avec lequel vous prévoyez d’utiliser cette instance de données.
   Créez et configurez une instance de données locale distincte pour chaque type de visualisation dans lequel vous souhaitez utiliser les mêmes données. Par exemple, si vous prévoyez d’avoir une barre et une série chronologique qui affichent les scores du même indicateur, créez deux instances de données locales : une pour les visualisations de barres et une pour les visualisations de séries chronologiques, mais toutes deux sur le même indicateur.

   Conseil :

   Vous pouvez ajouter la visualisation des données à la page et comparer son panneau de configuration aux options de l’instance de données locale.
8. Copiez la liaison de données @data pour cette source de données.
   
   
   
9. Ajoutez le composant de visualisation des données souhaité à la page.
10. Dans le panneau de configuration de cette visualisation de données, dans la section Sources de données, activez l’option Définir les données manuellement.
11. Pour le champ Données , sélectionnez Lier les données ou Utiliser des scripts.
    
    
    
12. Dans la boîte de dialogue Lier les données aux données, sous Types de données, sélectionnez Ressource de données.
13. Double-cliquez sur la section Ajouter une sortie de données à cette zone et collez la liaison de données à votre instance de données locale dans la zone bleue.
14. Ajoutez .output.result à la fin de la liaison de données.
    Par exemple, la liaison de données terminée au data_visualization_api_for_table_data_source_1 d’instance de données local est @data.data_visualization_api_for_table_data_source_1.output.result.
    
    
15. Sélectionnez Appliquer.

Résultats

Vous avez créé une instance de données locale et l’avez liée à une visualisation de données. Vous pouvez maintenant terminer la configuration de votre visualisation de données.

Activer les filtres à appliquer à une instance de données locale

Pour permettre à une visionneuse de basculer entre les valeurs de champ ou les éléments de répartition qu’elle voit dans une visualisation de données, ajoutez des composants de filtre à la Générateur d'IU page. Pour que ces filtres s’appliquent à une instance de données locale, configurez cette instance en conséquence.

Avant de commencer

Rôle requis : ui_builder_admin, admin

Pourquoi et quand exécuter cette tâche

Pour activer l’application des filtres à une source de données locale, vous devez d’abord créer un paramètre d’état client nommé parFilters , puis ajouter ce paramètre d’état à l’instance de données locale.

Procédure

1. Ouvrez la Générateur d'IU page avec l’instance de données locale et les visualisations de données que vous souhaitez filtrer.
2. Dans le tiroir Données et scripts, sélectionnez Paramètres de l’état du client.
3. Sélectionnez + Ajouter.
4. Dans la boîte de dialogue Modifier les paramètres de l’état du client, nommez le nouveau paramètre parFilters, affectez-lui le type JSON et définissez la valeur initiale {}.
   
   
   
5. Fermez la boîte de dialogue Modifier les paramètres de l’état du client.
6. Dans le tiroir Données et scripts, sous Ressources de données, sélectionnez l’instance de données locale souhaitée.
7. Dans la boîte de dialogue Modifier <nom de l’instance de données locale> faites défiler vers le bas jusqu’au champ Configurations des filtres .
8. Entrez @state.parFilters dans le champ Configuration des filtres et fermez l’éditeur d’instances de données.
9. Dans le panneau de configuration d’une visualisation de données qui utilise cette ressource de données locale, activez Suivre les filtres dans la section Mise à jour des données.
10. Facultatif : Activez l’icône Afficher le filtre.
11. Enregistrez la Générateur d'IU page.

Que faire ensuite

Ajoutez des composants de filtre à la page et configurez-les pour les Générateur d'IU valeurs pertinentes à partir de l’instance de données locale.

Concepts associés

• Filtres dans Platform Analytics

Activer la mise en cache de données pour une instance de données locale

Pour réduire le temps de chargement des visualisations de données, et si des données en temps réel ou très récentes ne sont pas nécessaires, activez la mise en cache des données sur la source de données.

Avant de commencer

Rôle requis : ui_builder_admin, admin

Procédure

1. Ouvrez la Générateur d'IU page contenant l’instance de données locale dont vous souhaitez mettre en cache les données.
2. Dans le tiroir Données et scripts, sous Ressources de données, sélectionnez l’instance de données locale souhaitée.
3. Faites défiler vers le bas jusqu’à Utiliser le cache de données et activez-le.
   Toute visualisation de données qui utilise cette source de données utilise les paramètres de cache sur la source de données. Les paramètres de cache de données sur la visualisation elle-même sont supprimés du panneau de configuration.
4. Définissez d’autres propriétés de mise en cache selon les besoins.

   Propriété	Description
   Délai d'expiration du cache	Durée de conservation du cache, une fois créé, avant d’être mis à jour dans la tâche d’actualisation du cache.
   Invalider le cache	Utilisez ce paramètre avec la logique supplémentaire que vous créez pour invalider le cache et extraire des données fraîches. Par exemple, vous pouvez ajouter un composant Button à la page et un script à son gestionnaire d’événements pour invalider le cache.
   Clé supplémentaire	Entrez une chaîne qui contribuera à générer la clé de hachage unique pour chaque cache de données créé sur cette instance de données. Utilisez une valeur de clé supplémentaire unique pour chaque instance de données locale.