Vous consultez la documentation de Looker 22.16. Pour accéder à la documentation la plus récente, cliquez ici.

Créer des tableaux de bord LookML

Les tableaux de bord LookML sont créés par les développeurs LookML et stockés en tant que fichiers avec contrôle des versions. Ils apparaissent par défaut dans le dossier Tableaux de bord LookML de votre instance Looker.

Pour comparer les tableaux de bord LookML et les tableaux de bord définis par l'utilisateur, consultez la page de documentation Comparer des tableaux de bord définis par l'utilisateur et LookML.

Pour créer un tableau de bord LookML, vous devez disposer des autorisations Looker suivantes:

De plus, vous devez avoir accès aux modèles LookML pour toutes les données que vous souhaitez utiliser dans le tableau de bord.

Créer un fichier de tableau de bord LookML

Pour créer un tableau de bord LookML, commencez par créer un fichier de tableau de bord avec l'extension .dashboard.lookml (bien que la partie .lookml de l'extension soit silencieuse dans l'IDE). Pour ce faire, procédez comme suit:

Activez le mode Développement.
Dans le menu Develop (Développer), accédez à votre projet.
Sélectionnez l'icône Plus Add file or folder (Ajouter un fichier ou un dossier) en haut du panneau de l'explorateur de fichiers de l'IDE Looker pour créer un fichier de tableau de bord LookML en dehors des dossiers de projet existants. Vous pouvez également cliquer sur le menu Options de dossier à trois points pour créer le fichier à l'intérieur du dossier. Cliquez sur Créer un tableau de bord pour créer le fichier correspondant.
Une fenêtre Créer un fichier s'affiche. Dans la fenêtre, nommez le tableau de bord dans le champ d'écriture et sélectionnez Créer.

Modifier les fichiers du tableau de bord LookML

Lorsque vous créez un fichier de tableau de bord LookML, Looker préremplit le fichier avec plusieurs paramètres de tableau de bord de base, qui implémentent des paramètres pour l'ensemble du tableau de bord. Il préremplit également le fichier avec plusieurs exemples de paramètres d'élément de tableau de bord, regroupés sous le paramètre de tableau de bord elements, et qui définissent la fonction et l'apparence des tuiles, du texte et des boutons du tableau de bord. Un fichier .dashboard.lookml créé récemment contient un tableau de bord semblable à celui-ci:

- dashboard: order_analysis
  title: Order Analysis
  layout: newspaper
  preferred_viewer: dashboards-next
  tile_size: 100

  filters:

  elements:
    - name: hello_world
      type: looker_column

Vous pouvez modifier le fichier du tableau de bord dans l'IDE à votre guise, tant que vous êtes en mode développement.

Vous disposez de plusieurs options pour créer votre tableau de bord:

Création manuelle:vous pouvez créer manuellement un tableau de bord à l'aide des paramètres du tableau de bord et de l'élément du tableau de bord.
Copier un tableau de bord défini par l'utilisateur:vous pouvez créer une copie d'un tableau de bord défini par l'utilisateur en supprimant le LookML du tableau de bord prérempli du fichier, en le copiant et en le collant dans le fichier correspondant.
Copier le style des éléments du tableau de bord:vous pouvez copier le style du tableau de bord à partir de l'onglet Explorer ou Look et le coller dans le fichier du tableau de bord.

Lorsque vous créez un tableau de bord, suivez les bonnes pratiques associées. Pour obtenir des informations et des recommandations sur la création de tableaux de bord performants, consultez l'article Bonnes pratiques pour la création de tableaux de bord Looker.

Ajouter une visualisation à un tableau de bord LookML existant

Le moyen le plus simple d'ajouter une visualisation à un tableau de bord LookML existant consiste à utiliser la page Explorer pour créer une requête que vous souhaitez transformer en élément de tableau de bord:

Une fois que vous avez créé la requête et la visualisation que vous souhaitez ajouter à un tableau de bord, cliquez sur le menu représenté par une roue dentée Explorer les actions.
Sélectionnez Get LookML pour l'exposer.
Une fenêtre Get LookML s'affiche. Sélectionnez Dashboard (Tableau de bord) dans la fenêtre, puis sélectionnez l'ensemble de LookML et copiez-le.

Ensuite, collez LookLook dans le fichier LookML de votre tableau de bord. Lorsque vous modifiez le fichier LookML du tableau de bord, veillez à:

Vérifiez que vous êtes en mode Développement afin de pouvoir modifier le fichier du tableau de bord.
Collez LookML sous le paramètre elements du tableau de bord.
Utilisez le retrait approprié lorsque vous collez LookML dans le fichier du tableau de bord. Si possible, faites correspondre le retrait aux éléments existants déjà dans le fichier du tableau de bord.

Si vous le souhaitez, vous pouvez ajuster les paramètres LookML à l'aide des paramètres décrits dans les pages de documentation pour chaque type d'élément individuel.

Ajouter des filtres

Une fois que les éléments du tableau de bord sont enregistrés, vous pouvez ajouter des filtres pour permettre aux lecteurs de filtrer tout ou partie des éléments. Les filtres peuvent être utiles pour de nombreuses raisons, par exemple:

Ajuster la période affichée
Ajuster la catégorie de produit, le type de client, etc.
Fournir une fonctionnalité de "recherche" à un client

Veillez à créer le type de filtre de votre choix. Les deux types sont les suivants:

Filtres codés en dur dans les éléments du tableau de bord, que les lecteurs de tableau de bord ne peuvent pas modifier
Filtres du tableau de bord que les lecteurs de tableau de bord peuvent modifier

Filtres codés en dur dans les éléments du tableau de bord

Les filtres que vous intégrez en dur aux éléments du tableau de bord (que les utilisateurs ne peuvent pas modifier) sont généralement créés automatiquement à l'étape de copie LookML pour une visualisation ou pour un tableau de bord. Dans un tableau de bord LookML, ces filtres utilisent le paramètre d'élément de tableau de bord filters et ressemblent à ceci:

- name: element_name
  # lots of other element parameters here
  filters:
    dimension_or_measure_name: 'looker filter expression'

Filtres de tableau de bord

Vous pouvez créer des filtres de tableau de bord qu'un utilisateur peut modifier en deux étapes:

Créez le filtre du tableau de bord à l'aide du paramètre du tableau de bord filters et de ses sous-paramètres.
Appliquez le filtre au tableau de bord à l'aide du paramètre d'élément listen.

Créer un filtre de tableau de bord

La première étape consiste à créer les filtres avec lesquels les utilisateurs interagissent. Pour ce faire, ajoutez une section filters à votre fichier de tableau de bord, qui doit se présenter comme suit:

- dashboard: dashboard_name
  # possibly some other dashboard parameters here

  filters:
  - name: date
    title: 'Date Range'
    type: date_filter
    default_value: 30 days

  - name: category_name
    type: field_filter
    model: ecommerce
    explore: product
    field: category.name

Les différents paramètres et options de ces filtres sont décrits plus en détail sur la page de documentation Paramètres du tableau de bord. L'un des points les plus importants à retenir est le type d'informations que vous attendez de vos utilisateurs. Vous pouvez attribuer une type au filtre afin qu'il accepte un type d'entrée spécifique, tel que des nombres, des dates ou des chaînes. Vous pouvez également utiliser le filtre type pour associer un filtre à un champ LookML sous-jacent. Dans ce cas, Looker sélectionne automatiquement le type d'entrée approprié et, si le champ LookML sous-jacent est défini sur type: string, fournit des suggestions de filtre aux lecteurs du tableau de bord.

Comme indiqué sur la page de documentation Paramètres du tableau de bord, seuls les filtres avec type: field filter utilisent les paramètres explore et field. Si vous incluez les paramètres explore et field avec un autre type de filtre, vous obtiendrez des erreurs de validation LookML.

Appliquer un filtre au tableau de bord

Une fois que vous avez créé un filtre de tableau de bord, vous devez l'appliquer aux éléments appropriés à l'aide du paramètre listen. L'idée est de faire en sorte que l'élément "écoute" un ou plusieurs filtres pour l'entrée utilisateur, puis de s'ajuster en conséquence. Ce paramètre s'applique à tous les types d'éléments autres que type: text et type: button. Des informations sur son utilisation apparaissent sur les pages de documentation de chaque type de visualisation. Pour obtenir un exemple représentatif du fonctionnement de listen, consultez la section Paramètres des graphiques en aires pour les tableaux de bord LookML.

Par exemple, vous pouvez avoir un élément qui ressemble à ceci:

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: order
  dimensions: [order.created_date]
  measures: [order.count]
  filters:
    order.status: 'approved'

Comme vous pouvez le constater, cet élément comporte déjà un paramètre filters qui le limite aux commandes approuvées (à l'aide du filtre order.status: 'approved'). L'utilisateur ne peut pas le modifier.

Supposons que vous souhaitiez que l'utilisateur puisse filtrer cet élément à l'aide des filtres du tableau de bord créés plus tôt dans cet exemple. Pour ce faire, ajoutez un paramètre listen comme suit:

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: order
  dimensions: [order.created_date]
  measures: [order.count]
  filters:
    order.status: 'approved'
  listen:
    category_name: category.name
    date: order.created_date

Si vous ne souhaitez pas que les utilisateurs puissent modifier la date ou la catégorie, il vous suffit de ne pas ajouter le paramètre listen. Il vous suffit d'ajouter un listen aux éléments que l'utilisateur doit pouvoir ajuster.

Vous constaterez que la syntaxe listen fonctionne en écrivant le nom du filtre que vous avez créé, puis en saisissant le nom du champ auquel vous souhaitez appliquer l'entrée utilisateur.

Un filtre de tableau de bord peut être appliqué à n'importe quel champ (du même type de données) dans n'importe quel élément. Par exemple, un élément peut appliquer une entrée d'utilisateur à la date de création (date: order.created_date) d'un utilisateur, tandis qu'un autre applique la date d'expédition de la campagne (date: order.ship_date):

- name: element_one
  # lots of other element parameters here
  listen:
    date: order.created_date

- name: element_two
  # lots of other element parameters here
  listen:
    date: order.ship_date

Inclure le fichier du tableau de bord dans un modèle

Pour que vous puissiez prévisualiser votre tableau de bord en mode développeur ou en production, vous devez l'inclure dans le fichier de modèle sur lequel il se base à l'aide d'une instruction include.

Une pratique courante consiste à inclure tous les tableaux de bord LookML dans un modèle à l'aide d'un caractère générique:

include: "*.dashboard.lookml"

Si vos tableaux de bord LookML apparaissent dans un dossier de l'IDE, utilisez le chemin d'accès

 include: "/path/*.dashboard.lookml"

Vous pouvez également inclure un tableau de bord spécifique en spécifiant son nom de fichier:

include: "my_dashboard.dashboard.lookml"

Enregistrer, prévisualiser et publier le tableau de bord LookML

Pour prévisualiser le tableau de bord:

Enregistrez le fichier .dashboard.lookml en cliquant sur le bouton Save Changes (Enregistrer les modifications) en haut à droite du fichier.
Incluez le tableau de bord dans le fichier de modèle concerné et enregistrez les modifications apportées à ce fichier.
Dans le fichier .dashboard.lookml que vous souhaitez prévisualiser, cliquez sur la flèche vers le bas Afficher les actions associées aux fichiers, puis sélectionnez Afficher le tableau de bord.

Vous pouvez apporter des modifications supplémentaires à votre fichier .dashboard.lookml, les enregistrer et prévisualiser à nouveau le tableau de bord.

Une fois que vous êtes satisfait de votre tableau de bord, vous pouvez le publier en production, afin que d'autres utilisateurs disposant des autorisations appropriées puissent le voir. La méthode de publication du tableau de bord est identique à celle des autres modifications apportées à LookML sur votre instance, et dépend des paramètres de contrôle des versions de votre instance Looker.

Dossier des tableaux de bord LookML

Une fois publiés, les tableaux de bord LookML sont enregistrés par défaut dans le dossier Tableaux de bord LookML. Le dossier Tableaux de bord LookML se trouve dans le dossier Dossiers du panneau de navigation de gauche. Le dossier Tableaux de bord LookML est unique par rapport aux autres dossiers, à plusieurs égards:

Vous devez inclure un tableau de bord LookML dans au moins un fichier de modèle pour qu'il apparaisse dans le dossier Tableaux de bord LookML.
Pour afficher le dossier Tableaux de bord LookML, les utilisateurs doivent disposer de l'autorisation see_lookml_dashboards.
Pour afficher les tableaux de bord dans le dossier Tableaux de bord LookML, les utilisateurs doivent avoir accès au modèle LookML qui inclut le tableau de bord.
Pour afficher une tuile donnée dans un tableau de bord LookML, les utilisateurs du tableau de bord doivent avoir accès au modèle LookML sur lequel elle est basée.
Pour modifier un tableau de bord dans le dossier Tableaux de bord LookML, vous devez disposer de l'autorisation develop sur le modèle qui inclut le tableau de bord LookML.
Pour explorer depuis cette page sur une tuile donnée dans un tableau de bord, les lecteurs de tableau de bord doivent disposer de l'autorisation explore pour le modèle sur lequel se trouve la tuile.
Vous ne pouvez pas créer de dossier dans le dossier Tableaux de bord LookML.

Déplacer des tableaux de bord LookML en dehors du dossier des tableaux de bord LookML

Si vous disposez des autorisations Looker see_lookml_dashboards et develop, ainsi que de l'accès au modèle LookML dans lequel un tableau de bord LookML est inclus, vous pouvez déplacer un tableau de bord LookML dans n'importe quel dossier pour lequel vous disposez du niveau d'accès Gérer l'accès, modifier.

Il existe deux façons de déplacer le tableau de bord:

Dans le dossier Tableaux de bord LookML, sélectionnez le tableau de bord à déplacer, cliquez sur le bouton Déplacer en haut de la section "Tableaux de bord", puis sélectionnez le dossier dans lequel vous souhaitez déplacer le tableau de bord. Pour en savoir plus, consultez la page Organiser et gérer le contenu.
Dans le dossier Tableaux de bord LookML, cliquez sur le menu à trois points du tableau de bord, sélectionnez Déplacer dans le menu, puis sélectionnez le dossier dans lequel vous souhaitez déplacer le tableau de bord.

Si vous êtes en mode développement, vous ne pouvez pas déplacer les tableaux de bord LookML en dehors du dossier Tableaux de bord LookML. À la place, vous pouvez utiliser l'option Import (Importer) pour copier le tableau de bord LookML en tant que tableau de bord défini par l'utilisateur dans un autre dossier.

Un dossier contenant des tableaux de bord définis par l'utilisateur et LookML affiche les tableaux de bord LookML dans une section LookML Dashboard. Dans la section LookML Dashboard, vous pouvez déplacer un tableau de bord LookML vers un autre dossier ou épingler un tableau de bord LookML sur un tableau. Toutefois, contrairement aux tableaux de bord définis par l'utilisateur, les tableaux de bord LookML ne peuvent pas être renommés ni placés dans la corbeille depuis un dossier.

Si la valeur d'un paramètre dashboard du tableau de bord LookML est modifiée, le tableau de bord LookML revient automatiquement dans le dossier Tableaux de bord LookML.

Afficher le LookML d'un tableau de bord LookML existant

Si vous disposez de l'autorisation see_lookml, vous pouvez accéder au LookML d'un tableau de bord LookML existant en sélectionnant Accéder à LookML dans le menu Actions du tableau de bord à trois points:

Si le tableau de bord LookML est dans l'ancien style, cliquez sur Accéder au LookML du tableau de bord dans le menu représenté par une roue dentée.

Lorsque vous sélectionnez Go to LookML (Accéder à LookML), Looker accède au fichier de tableau de bord dans lequel le tableau de bord LookML est défini.

Étendre un tableau de bord LookML

Une fois que vous avez créé un tableau de bord LookML, vous pouvez l'étendre. Cela vous permet de créer un deuxième tableau de bord basé sur celui d'origine, en ajoutant ou en remplaçant certains paramètres. Ensuite, si vous modifiez le premier tableau de bord, le second hérite automatiquement de ces modifications (sauf s'il a été remplacé dans le second). Pour en savoir plus, consultez la page Réutiliser du code avec des extensions.

Amélioration des performances d'un tableau de bord à l'aide de la reconnaissance d'agrégats

Les développeurs LookML peuvent peut-être améliorer les performances du tableau de bord LookML en utilisant la notoriété globale. Grâce à la notoriété globale, les développeurs peuvent créer des tables agrégées sous les paramètres LookML explore, ce qui permet d'optimiser les requêtes pour une ou plusieurs tuiles dans un tableau de bord.

Une fois que vous avez créé un tableau de bord LookML et que vous l'affichez, vous pouvez utiliser l'option Obtenir le modèle d'ensemble de données LookML dans le menu Actions du tableau de bord à trois points, qui est visible si vous disposez de l'autorisation see_lookml:

Pour en savoir plus, consultez la page de documentation sur les paramètres aggregate_table.