Paramètres d'administration – Visualisations

Looker inclut une liste complète de types de visualisations intégrés, ce qui vous permet de représenter vos données de différentes manières. Si vous avez besoin d'un type de graphique qui n'est pas inclus dans les types de visualisation intégrés de Looker, Looker propose plusieurs façons d'ajouter des visualisations JavaScript personnalisées à votre instance Looker :

  1. Ajoutez un paramètre visualization au fichier manifeste de votre projet LookML pour ajouter directement à ce dernier des visualisations personnalisées. Pour en savoir plus, consultez la page de documentation sur le paramètre visualization.
  2. Installez une visualisation depuis Marketplace Looker. Lorsque la fonctionnalité Marketplace est activée, vous pouvez installer des packages de visualisation Marketplace Looker.
  3. Utilisez la page Visualisations de la section Plate-forme du menu Admin de Looker pour installer et gérer les visualisations JavaScript personnalisées du dépôt de visualisations personnalisées de Looker.

Cette page explique comment ajouter des visualisations JavaScript personnalisées à l'aide de la page Visualisations du panneau Admin de Looker.

Afficher la liste des visualisations personnalisées

Pour bénéficier de toutes les fonctionnalités des visualisations téléchargées, les administrateurs des déploiements hébergés par le client doivent s'assurer d'installer la version appropriée du rendu Chromium.

La page Visualisations de la section Plate-forme du menu Admin de Looker liste toutes les visualisations personnalisées qui ont été ajoutées à votre instance Looker.

La liste inclut les colonnes suivantes :

Obtenir une visualisation personnalisée

Vous pouvez obtenir des visualisations à personnaliser et à ajouter à votre instance Looker à partir de diverses sources, y compris les suivantes :

  • Looker gère une bibliothèque de visualisations personnalisées pour un usage public sur cette page GitHub Looker. Vous trouverez des instructions pour utiliser l'API Visualization de Looker afin de créer vos propres types de visualisations sur cette page GitHub de Looker.
  • Le Marketplace Looker autonome, où vous pouvez rechercher des visualisations (appelées "plug-ins") et accéder à leur code source.
  • Marketplace Looker accessible depuis votre instance Looker. Depuis cette place de marché, vous pouvez parcourir et installer des visualisations directement dans votre instance Looker. Pour en savoir plus sur l'installation de visualisations depuis le Marketplace Looker, consultez la page de documentation Utiliser Looker Marketplace.

Ajouter une visualisation personnalisée

Une fois que vous savez quelle visualisation vous souhaitez ajouter à votre instance, vous pouvez utiliser la page Visualisations dans la section Plate-forme du menu Admin de Looker pour ajouter une visualisation personnalisée en sélectionnant le bouton Ajouter une visualisation.

Looker affiche la page Nouvelle visualisation. Pour ajouter une visualisation, procédez comme suit :

  1. Dans le champ ID, saisissez l'ID unique de la visualisation défini dans le code JavaScript de la visualisation.

  2. Dans le champ Libellé, saisissez le nom de la visualisation. Looker affiche ce nom dans le menu de visualisation Looker d'une exploration.

  3. Dans le champ Principal, saisissez l'URI du fichier JavaScript principal de la visualisation pour indiquer à Looker le dépôt de votre code JavaScript.

  4. Si le site qui héberge votre code de visualisation personnalisé utilise un hachage SRI (Subresource Integrity) à des fins de validation, saisissez-le dans le champ Hachage SRI. Ce champ se trouve sous Options avancées. Les hôtes de visualisation personnalisée de Looker n'utilisent pas de hachage SRI.

  5. Dans le champ Dépendances, saisissez les URI de tous les autres fichiers dont dépend le JavaScript de la visualisation, puis cliquez sur Ajouter. Vous pouvez saisir plusieurs URI séparés par des virgules ou les ajouter un par un. Le champ Dépendances se trouve sous Options avancées.

  6. Sélectionnez Enregistrer.

Une fois la visualisation ajoutée, elle s'affiche avec le libellé que vous lui avez attribué dans le menu des visualisations d'une exploration. Vous pouvez utiliser le nouveau type de visualisation comme n'importe quel autre type de visualisation Looker existant.

Pour afficher les visualisations personnalisées dans le menu "Visualisation" :

  1. Sélectionnez l'icône à trois points ... dans la barre de menu de la visualisation pour accéder à la visualisation personnalisée.

  2. Une fois la visualisation sélectionnée, son nom s'affiche dans la barre de menu de la visualisation.

Modifier une visualisation personnalisée

Pour modifier une visualisation existante, sélectionnez le bouton Modifier à droite de la visualisation. Looker affiche la même page que celle que vous utilisez pour ajouter une visualisation (décrite dans Ajouter une visualisation personnalisée), mais avec les informations pertinentes déjà renseignées. Apportez les modifications souhaitées, puis cliquez sur Enregistrer.

Supprimer une visualisation personnalisée

Pour supprimer une visualisation, sélectionnez le bouton Supprimer à droite de la visualisation sur la page Visualisations de la section Plate-forme du menu Admin de Looker, puis cliquez sur OK dans la boîte de confirmation.

La suppression d'une visualisation l'élimine de Looker, mais n'a aucune incidence sur le dépôt de code externe de la visualisation.

Si vous supprimez une visualisation, toutes les présentations ou tous les tableaux de bord qui utilisent ce type de visualisation sont désactivés. Pour corriger cela, ajoutez à nouveau la visualisation supprimée en utilisant le même ID de visualisation.

Dépannage

Les visualisations personnalisées sont un effort soutenu par la communauté. L'équipe d'assistance de Looker ne résout pas les problèmes liés aux visualisations personnalisées ni à leur code. Pour suivre et résoudre les bugs, utilisez les problèmes GitHub dans le dépôt de la visualisation personnalisée ou consultez la communauté Looker pour obtenir des tutoriels, des conversations et des conseils sur les visualisations personnalisées.

Visualisations personnalisées vides dans les exportations PDF ou PNG

Les visualisations personnalisées dans les téléchargements PDF ou PNG s'affichent sous forme de pages vierges sur les instances Looker (Google Cloud Core) avec des connexions privées qui n'ont pas accès à Internet pour les connexions sortantes. Ce problème se produit, car le moteur de rendu Chromium ne peut pas récupérer les dépendances JavaScript externes (telles que D3 ou jQuery) hébergées sur des réseaux de diffusion de contenu (CDN) publics lorsque l'accès sortant est limité.

Pour résoudre ce problème, utilisez l'une des solutions suivantes :

  • Regroupez les dépendances dans votre projet LookML :
    1. Téléchargez le fichier de dépendance externe .js requis.
    2. Copiez et collez le code de dépendance brut en haut de votre fichier .js de visualisation personnalisée.
    3. Enregistrez le fichier .js groupé dans votre projet LookML.
    4. Mettez à jour le fichier manifest.lkml pour qu'il pointe vers le fichier local en utilisant le paramètre file au lieu des URL externes dans dependencies ou url.
    5. Déployez les modifications en production pour que Looker diffuse les dépendances en local.
  • Configurer les connexions sortantes pour Private Service Connect : pour les instances qui utilisent Private Service Connect, configurez les connexions sortantes (vers le sud) afin de permettre à l'instance d'accéder aux services externes et aux CDN publics.

Pour en savoir plus sur la résolution des problèmes liés au moteur de rendu, consultez Résoudre les problèmes liés au moteur de rendu Chromium.