Looker inclut une liste complète de types de visualisation 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, vous pouvez ajouter des visualisations JavaScript personnalisées à votre instance Looker de plusieurs manières :
- Ajoutez un paramètre
visualizationau fichier manifeste de votre projet LookML pour ajouter directement des visualisations personnalisées à votre projet LookML. Pour en savoir plus, consultez la page de documentation sur le paramètrevisualization. - Installez une visualisation depuis le Marketplace Looker. Si la fonctionnalité Marketplace est activée, vous pouvez installer des packages de visualisation du Marketplace Looker.
- Utilisez la page Visualisations de la section Plate-forme du menu Admin de Looker pour installer et administrer des visualisations JavaScript personnalisées à partir 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 moteur de 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 comprend les colonnes suivantes :
- ID : identifiant unique attribué à la visualisation personnalisée. Cette valeur est attribuée dans le code JavaScript, lorsque vous ajoutez ou modifiez une visualisation à l'aide de la page Admin ou dans le paramètre
idde la visualisation lorsque vous ajoutez une visualisation à l'aide du fichier manifeste du projet LookML. - Libellé : nom attribué au type de visualisation dans le menu de visualisation Looker. Cette valeur est attribuée lorsque vous ajoutez ou modifiez une visualisation à l'aide de la page Administration ou dans le paramètre
labelde la visualisation lorsque vous ajoutez une visualisation à l'aide du fichier manifeste du projet LookML. - Principal : URI du code JavaScript principal de la visualisation. Cette valeur est attribuée lorsque vous ajoutez ou modifiez une visualisation à l'aide de la page Administration ou dans le paramètre
urlde la visualisation lorsque vous ajoutez une visualisation à l'aide du fichier manifeste du projet LookML. - Actions : boutons permettant de modifier ou de supprimer la configuration de la visualisation. Ces boutons ne s'affichent pas pour les visualisations ajoutées à l'aide du fichier manifeste du projet LookML. Pour modifier ces visualisations, accédez au fichier manifeste du projet LookML et modifiez directement le
visualizationparamètre.
Obtenir une visualisation personnalisée
Vous pouvez obtenir des visualisations à personnaliser et à ajouter à votre instance Looker à partir de différentes sources, y compris les suivantes :
- Looker gère une bibliothèque de visualisations personnalisées à usage public sur cette page GitHub Looker. Vous trouverez des instructions pour utiliser l'API de visualisation de Looker afin de créer vos propres types de visualisation sur cette page GitHub Looker.
- Le Marketplace Looker autonome, où vous pouvez rechercher des visualisations (appelées "plug-ins") et accéder à leur code source.
- Le Marketplace Looker accessible depuis votre instance Looker. Depuis ce Marketplace, vous pouvez parcourir et installer des visualisations directement dans votre instance Looker. Pour en savoir plus sur l'installation de visualisations à partir du Marketplace Looker, consultez la page de documentation Utiliser le Marketplace Looker.
Ajouter une visualisation personnalisée
Une fois que vous savez quelle visualisation vous souhaitez ajouter à votre instance, vous pouvez utiliser la page Visualisations de 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 :
Dans le champ ID, saisissez l'ID unique de la visualisation défini dans le code JavaScript de la visualisation.
Dans le champ Libellé, saisissez le nom de la visualisation. Looker affiche ce nom dans le menu de visualisation Looker d'une exploration.
Dans le champ Principal, saisissez l'URI du fichier JavaScript principal de la visualisation pour rediriger Looker vers votre dépôt de code JavaScript.
Si le site qui héberge votre code de visualisation personnalisé utilise un hachage d'intégrité des sous-ressources (SRI) à des fins de validation, saisissez le hachage SRI 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.
Dans le champ Dépendances, saisissez les URI de tous les autres fichiers dont dépend le code JavaScript de la visualisation, puis cliquez sur Ajouter. Vous pouvez saisir plusieurs URI séparés par des virgules ou ajouter plusieurs URI un par un. Le champ Dépendances se trouve sous Options avancées.
Sélectionnez Enregistrer.
Une fois la visualisation ajoutée, elle s'affiche dans le menu de visualisation d'une exploration avec le libellé que vous lui avez attribué. Vous pouvez utiliser le nouveau type de visualisation comme n'importe quel autre type de visualisation existant dans Looker.
Pour afficher les visualisations personnalisées dans le menu de visualisation :
Sélectionnez l'icône à trois points
...dans la barre de menu de la visualisation pour accéder à la visualisation personnalisée.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 la supprime de Looker, mais n'affecte rien dans le dépôt de code externe de la visualisation.
La suppression d'une visualisation désactive toutes les présentations ou tous les tableaux de bord qui utilisent ce type de visualisation. Vous pouvez corriger ce problème en ajoutant à nouveau la visualisation supprimée avec 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 à votre code de visualisation personnalisé. 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 articles pratiques, des conversations et des conseils concernant les visualisations personnalisées.