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 :
- Ajoutez un paramètre
visualization
au fichier manifeste de votre projet LookML pour ajouter des visualisations personnalisées directement à votre projet LookML. Pour en savoir plus, consultez la page de documentation sur le paramètrevisualization
. - Installez une visualisation depuis Looker Marketplace. Si la fonctionnalité Marketplace est activée, vous pouvez installer des packages de visualisation Looker Marketplace.
- 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 :
- ID : ID unique attribué à la visualisation personnalisée. Cette valeur est attribuée dans le code JavaScript, ou lorsque vous ajoutez ou modifiez une visualisation à l'aide de la page Admin, ou dans le paramètre
id
de la visualisation lorsque vous ajoutez une visualisation à l'aide du fichier manifeste du projet LookML. - Libellé : nom donné au type de visualisation dans le menu des visualisations Looker. Cette valeur est attribuée lorsque vous ajoutez ou modifiez une visualisation à l'aide de la page "Admin", ou dans le paramètre
label
de 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 "Admin", ou dans le paramètre
url
de 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 paramètre
visualization
.
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 à 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.
- La place de marché 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 Looker Marketplace, consultez la page de documentation Utiliser le 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 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 indiquer à Looker le dépôt de votre 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 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 le JavaScript de visualisation dépend, 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.
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.
Pour afficher des visualisations personnalisées dans le menu "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'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 seront 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.