Paramètres d'administration – Visualisations

Looker inclut une liste complète de types de visualisations intégrés, qui vous permettent de représenter vos données de différentes manières. Si vous avez besoin d'un type de graphique qui ne figure pas dans les types de visualisation natifs de Looker, plusieurs options s'offrent à vous pour 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 des visualisations personnalisées à ce dernier. Pour en savoir plus, consultez la page de documentation du paramètre visualization.
2. Installer une visualisation depuis Looker Marketplace Lorsque la fonctionnalité Place de marché est activée, vous pouvez installer des plug-ins Looker Marketplace, y compris des types de visualisation que vous pouvez ajouter à la bibliothèque de visualisation intégrée de Looker. Pour en savoir plus sur l'installation de plug-ins depuis Looker Marketplace, consultez la page de documentation Utiliser Looker Marketplace. Pour savoir comment créer une visualisation pouvant être ajoutée au Marketplace Looker et accessible par d'autres utilisateurs de Looker, consultez la page de documentation Développer une visualisation personnalisée pour le Marketplace Looker.
3. Utilisez la page Visualisations de la section Plate-forme du menu Administration de Looker pour installer et gérer 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 Administration de Looker.

Remarque :Pour accéder à toutes les pages d'administration de Looker, vous devez disposer du rôle Administrateur. Si vous disposez d'une autorisation qui n'active que certaines parties du panneau Administration, comme manage_schedules ou manage_themes, mais que vous ne disposez pas du rôle Administrateur, il est possible que Looker n'affiche pas la ou les pages décrites dans cet article dans le panneau Administration. En outre, l'autorisation see_admin accorde un accès en lecture seule à la plupart (mais pas à toutes) des pages d'administration. Pour en savoir plus, consultez la description de see_admin.

Afficher la liste des visualisations personnalisées

Pour que les visualisations téléchargées fonctionnent pleinement, 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 Administration de Looker répertorie toutes les visualisations personnalisées qui ont été ajoutées à votre instance Looker.

La liste comprend 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 Administration, 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 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 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 "Administration", 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.

Ajouter une visualisation personnalisée

Vous trouverez la liste des blocs de visualisation de Looker dans le Marketplace Looker. Looker gère également une bibliothèque de visualisations personnalisées à usage public sur cette page GitHub de Looker. Pour savoir comment utiliser l'API de visualisation de Looker afin de créer vos propres types de visualisation, consultez la page GitHub de Looker.

Une fois que vous avez déterminé la visualisation que vous souhaitez ajouter à votre instance, vous pouvez utiliser la page Visualisations de la section Plate-forme du menu Administration 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éfinie 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 rediriger Looker vers votre dépôt de code JavaScript.

4. Si le site qui héberge votre code de visualisation personnalisé utilise un hachage de l'intégrité des sous-ressources (SRI) à des fins de validation, saisissez le hachage SRI dans le champ SRI Hash (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 Dependencies (Dépendances), saisissez les URI de tous les autres fichiers dont dépend le code JavaScript de la visualisation, puis cliquez sur Add (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.

6. Sélectionnez Enregistrer.

Une fois la visualisation ajoutée, vous la verrez telle que vous l'avez étiquetée dans le menu de visualisation d'une exploration. Vous pouvez utiliser le nouveau type de visualisation comme n'importe quel autre type de visualisation existant dans Looker.

Pour afficher des visualisations personnalisées depuis le menu de 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 la section 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, dans la section Plate-forme du menu Administration de Looker, puis cliquez sur OK dans la boîte de confirmation.

Si vous supprimez une visualisation, elle est supprimée de Looker, mais rien n'est modifié dans 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 résoudre ce problème, ajoutez à nouveau la visualisation supprimée avec le même ID.

Dépannage

Les visualisations personnalisées sont un effort collectif. 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ée. Pour suivre et résoudre les bugs, utilisez les problèmes GitHub dans le dépôt de la visualisation personnalisée ou accédez à la communauté Looker pour obtenir des tutoriels, des discussions et des conseils sur les visualisations personnalisées.