visualisation

Utilisation

visualization: {
  id: "unique-id" 
  label: "Visualization Label" 
  url: "visualization_url" 
  sri_hash: "SRI hash" 
  dependencies: ["dependency_url_1","dependency_url_2"]
  file: "visualization_file_path" 
}
Hiérarchie
visualization
Valeur par défaut
Aucun

Règles spéciales
visualization doit comporter un paramètre url ou file, mais pas les deux.

Définition

Le paramètre visualization ajoute une visualisation personnalisée à votre projet LookML, à laquelle les utilisateurs peuvent accéder depuis l'onglet Visualisation des explorations du projet. La visualisation personnalisée doit être définie dans un fichier JavaScript, qui peut être inclus dans les fichiers de votre projet LookML ou hébergé ailleurs.

Le paramètre visualization comporte les sous-paramètres suivants :

Paramètre Description
id Spécifie un identifiant unique pour la visualisation affichée sur la page Visualisations du menu Admin de Looker.
label Fournit le libellé de la visualisation affichée dans l'onglet Visualisation des Explorations de votre projet et dans la page Visualisations du menu Admin de Looker.
url Le paramètre url fournit l'URL du fichier JavaScript de la visualisation, si le fichier est stocké sur un serveur en dehors de l'instance Looker. Au lieu d'utiliser le paramètre url, vous pouvez faire glisser et déposer le fichier dans l'IDE Looker, puis utiliser le paramètre file pour pointer vers le fichier.

NOTE : L'application doit comporter un paramètre url ou un paramètre file, mais pas les deux.
sri_hash Le hachage SRI n'est utilisé que lorsque le fichier JavaScript de la visualisation est spécifié avec le paramètre url. 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 sri_hash.
dependencies  Fournit une liste d'URL de dépendances séparées par une virgule, nécessaires pour charger la visualisation.
file Spécifie le chemin d'accès à un fichier JavaScript (avec une extension .js) qui définit la visualisation. Le chemin d'accès est relatif à la racine du projet. L'exemple de la colonne suivante pointe vers le fichier calendar-heatmap.js dans le répertoire visualizations du projet LookML.

NOTE : L'application doit comporter un paramètre url ou un paramètre file, mais pas les deux.

Exemple : Ajouter une URL de visualisation personnalisée à votre projet LookML

Pour ajouter une visualisation personnalisée à votre projet LookML, vous pouvez utiliser l'URL d'un fichier de visualisation personnalisée. Par exemple, l'ajout de ce code LookML au fichier manifeste d'un projet ajoute une visualisation personnalisée CDN à valeurs multiples au projet Looker. Cette visualisation est définie dans un fichier JavaScript situé sur la place de marché Looker :

visualization: {
  id: "spider-marketplace-dev"
  label: "Spider Viz"
  url: "https://marketplace-api.looker.com/viz-dist/spider.js"
  sri_hash: "oqVuAfXRKap7fdgcCY5uykM6+R9GqQ8K/uxy9rx7HNQlGYl1kPzQho1wx4JwY8wC"
  dependencies: ["https://code.jquery.com/jquery-2.2.4.min.js","https://cdnjs.cloudflare.com/ajax/libs/underscore.js/1.9.1/underscore-min.js","https://cdnjs.cloudflare.com/ajax/libs/d3/3.5.6/d3.min.js","https://cdnjs.cloudflare.com/ajax/libs/d3-legend/1.13.0/d3-legend.min.js"]
}

Une fois que vous avez validé vos modifications et que vous les avez déployées en production, Looker affiche le nom de la visualisation personnalisée comme option dans l'onglet Visualisation des explorations de votre projet.

La visualisation sera également listée sur la page Visualisations de la section Plate-forme du menu Admin de Looker. Pour en savoir plus, consultez la page de documentation Paramètres d'administration : visualisations.

Exemple : Ajouter un fichier de visualisation personnalisée à votre projet LookML

Vous pouvez également ajouter le fichier JavaScript de la visualisation personnalisée à votre projet LookML à l'aide de l'IDE Looker :

  1. Dans l'IDE Looker, glissez-déposez le fichier JavaScript qui définit votre visualisation personnalisée dans votre projet LookML.
  2. Vous pouvez également déplacer le fichier de visualisation dans un dossier de l'IDE Looker ou créer un dossier pour le fichier de visualisation.
  3. Cliquez sur le fichier de visualisation dans le panneau de l'explorateur de fichiers pour afficher son contenu, puis cliquez sur Enregistrer pour enregistrer le fichier.
  4. Dans le fichier manifeste du projet, définissez les paramètres de visualisation. Par exemple, ce LookML ajoute une visualisation personnalisée de jauge radiale au projet Looker. La visualisation est définie dans un fichier JavaScript situé dans le répertoire visualizations du projet LookML :
  visualization: {
  id: "radial_gauge"
  label: "Radial Gauge"
  file: "visualizations/radialgauge_v2.js"
   }

  1. Validez vos modifications et déployez-les en production.

    Vous devez déployer les mises à jour de la visualisation pour voir l'option de visualisation client dans une exploration (il ne suffit pas d'enregistrer les mises à jour, même en mode Développement).

Une fois vos modifications déployées, Looker affiche le nom de la visualisation personnalisée comme option dans l'onglet Visualisation des explorations de votre projet.

La visualisation est également listée sur la page Visualisations de la section Plate-forme du menu Admin de Looker. Pour en savoir plus, consultez la page de documentation Paramètres d'administration : visualisations.