Validation du contenu

L'outil de validation du contenu recherche dans votre code LookML les noms de modèle, d'exploration et de champ référencés dans votre contenu Looker. Il s'agit d'un outil utile pour valider vos références LookML, corriger les erreurs de votre code LookML après avoir apporté des modifications et mettre à jour les noms des éléments LookML dans l'ensemble de votre projet.

Vous devez disposer de l'autorisation develop pour utiliser le vérificateur de contenu.

Pour ouvrir le vérificateur de contenu, sélectionnez Vérificateur de contenu dans le menu Développer du panneau de navigation de gauche. Vous pouvez ensuite utiliser l'outil de validation du contenu de deux manières:

Avant d'utiliser l'outil de validation de contenu

Vous devez faire preuve d'une extrême prudence lorsque vous apportez des modifications à l'aide de la validation du contenu. Le vérificateur de contenu ne dispose pas de fonction d'annulation. Il peut avoir un impact sur de nombreux looks et tableaux de bord, ainsi que sur leurs liens Explorer à partir d'ici. Si vous faites une erreur, vous devez essayer de la corriger dès que possible, avant que d'autres modifications ne rendent plus difficile l'identification des Looks concernés.

Tenez également compte du moment où vous utilisez le validateur de contenu. Lorsque vous déployez des modifications de développement en production, vous devez corriger les présentations et les vignettes concernées à peu près en même temps, afin qu'elles ne soient pas inutilisables pendant une durée minimale. Si vous corrigez des looks et des cartes trop tôt, en fonction de votre travail en mode Développement, ils apparaîtront comme défectueux pour les utilisateurs jusqu'à ce que vous poussiez vos modifications. De même, si vous tardez à corriger les présentations et les cartes bien après avoir poussé les modifications, elles apparaîtront comme défectueuses aux yeux des utilisateurs jusqu'à ce que vous les corrigiez.

Utiliser le validateur de contenu pour corriger les erreurs

Le validateur de contenu est un outil utile pour détecter et corriger les erreurs résultant de modifications apportées à votre LookML. Par exemple, si vous remplacez le nom d'un champ customer par user, les présentations ou les cartes du tableau de bord qui incluaient le champ customer ne fonctionneront plus (sauf si vous avez utilisé le paramètre alias). L'outil de validation du contenu répertorie toutes les références au champ customer et vous indique comment corriger facilement l'erreur.

Lorsque vous exécutez le validateur de contenu, il valide toutes les références que vos looks et tableaux de bord font à vos modèles, explorations, vues et champs LookML, et affiche une erreur pour toute référence de votre contenu à un objet LookML inconnu.

L'outil de validation du contenu n'affiche pas d'erreurs pour les éléments suivants:

  • Contenus pour lesquels vous ne disposez pas de l'autorisation develop. Le validateur de contenu est limité à vos autorisations. Vous ne pouvez donc l'utiliser que sur le contenu pour lequel vous disposez de l'autorisation develop (les modèles que vous pouvez voir dans l'IDE Looker). Pour en savoir plus sur les autorisations de modèle, consultez la page de documentation Rôles.
  • Les looks qui ont été supprimés et se trouvent dans la Corbeille. Si vous souhaitez valider un look supprimé, votre administrateur Looker doit d'abord le restaurer.

Exécuter l'outil de validation de contenu

Pour valider votre code LookML avec l'outil de validation de contenu:

  1. Cliquez sur Valider.
  2. Sélectionnez les onglets Grouper par pour modifier la manière dont les erreurs sont regroupées :
    • Erreur: listez chaque erreur, en regroupant le contenu Looker qui en est à l'origine. Cette option est utile si vous souhaitez corriger la même erreur dans plusieurs contenus en même temps.
    • Dossier: liste chaque dossier, en regroupant le contenu Looker contenant des erreurs. Cette option est utile si vous ne souhaitez corriger que les erreurs d'un dossier spécifique.
    • Contenu: listez chaque contenu comportant des erreurs, en regroupant ses erreurs. Cette option est utile si vous souhaitez corriger toutes les erreurs d'un seul look, d'une seule carte, d'un seul filtre, etc.
  3. Si vous êtes en mode Développement, Looker affiche un message d'avertissement. Il est important de comprendre les conséquences de la modification des apparences et des cartes. Si vous les "corrigez" avant de mettre en ligne vos modifications destructives, il y aura une période pendant laquelle la correction sera prématurée, ce qui entraînera des présentations ou des cartes défectueuses pour les utilisateurs. Le message d'avertissement vous aide à vous en souvenir.
  4. Le tableau des erreurs affiche toute erreur, ainsi qu'une liste des présentations et des cartes qui la contiennent, ainsi que le modèle sous-jacent et l'exploration qui génèrent l'erreur. Vous pouvez utiliser les onglets Grouper par en haut à droite de la page pour modifier la mise en page du tableau des erreurs.
  5. Looker fournit les boutons Remplacer et/ou Supprimer pour chaque ligne, en fonction du type d'erreur. Ces boutons permettent de corriger les erreurs. Pour en savoir plus, consultez Utiliser le programme de validation de contenu pour corriger les erreurs.

Afficher les résultats de validation du contenu

Les résultats de la validation du contenu indiquent du contenu Looker qui utilise des noms de modèle, de vue, d'exploration ou de champ qui n'existent pas ou ne sont pas disponibles. Consultez la section Utiliser le programme de validation de contenu pour corriger les erreurs pour en savoir plus sur les éléments LookML que le programme de validation de contenu peut trouver et valider.

L'icône à côté du nom du contenu indique le type de contenu:

  • Icône Carte sur le tableau de bord. : vignette du tableau de bord
  • Icône d'alerte sur le tableau de bord. : alerte du tableau de bord
  • Icône Planifier dans le tableau de bord ou dans l'icône Look : planifier l'envoi d'un tableau de bord ou d'une apparence
  • Icône Filtre du tableau de bord. : filtre pour un tableau de bord ou un champ d'une carte qui écoute un filtre de tableau de bord (consultez la page de documentation Ajouter et modifier des filtres de tableaux de bord définis par l'utilisateur pour savoir comment configurer des cartes pour qu'elles écoutent des filtres de tableaux de bord)

Les résultats de validation sont basés sur le code LookML disponible dans le mode que vous utilisez lorsque vous exécutez le validateur. Si vous êtes en mode Production, les résultats de validation reflètent tous les éléments LookML qui ont été mis en production. Si vous êtes en mode Développement, les résultats de validation reflètent votre code LookML enregistré, même s'il n'a pas été mis en production.

Les erreurs peuvent être dues à des modifications intentionnelles de votre code LookML, à une faute de frappe ou à une jointure manquante.

Pour corriger les erreurs, vous pouvez utiliser les boutons Remplacer et Supprimer dans chaque ligne du tableau des erreurs comme suit:

  • Remplacer: Looker fournit le bouton Remplacer pour chaque erreur (voir la section Remplacer les noms des champs, des vues, des explorations et des modèles plus loin sur cette page pour savoir comment remplacer les noms avec le validateur de contenu).
  • Supprimer: en cas d'erreurs liées aux noms de champ dans la section Données d'un look ou d'une carte, Looker affiche également le bouton Supprimer (voir la section Supprimer un nom de champ plus loin sur cette page pour savoir comment supprimer des noms avec le validateur de contenu).

Selon le paramètre Regrouper par, les boutons s'appliquent à un seul élément (look ou carte) ou à plusieurs éléments:

  • Si vous regroupez par Erreur, les boutons s'appliquent à toutes les occurrences de cette erreur dans tous les looks et les cartes de votre instance Looker. Vous pouvez ainsi corriger toutes les occurrences en une seule opération.
  • Si vous regroupez les erreurs par Dossier ou par Contenu, les boutons s'appliquent à une seule occurrence de l'erreur dans un seul look ou une seule carte, ce qui vous permet d'examiner chaque occurrence de l'erreur séparément.

Par exemple, un tableau d'erreurs est regroupé par Erreur et affiche trois instances de contenu avec une exploration inconnue nommée customers. L'action proposée pour les trois contenus est Remplacer. Si vous cliquez sur Remplacer, cela affectera les trois instances de contenu contenant l'erreur 3 x Unknown explore 'customers'.

Dans certains cas, plusieurs erreurs peuvent exister pour des éléments de contenu. Par exemple, une table d'erreur est regroupée par Contenu et affiche un élément de contenu intitulé Détails de la commande. Quatre erreurs Unknown field s'affichent dans la colonne Erreurs. Chacune d'elles est associée à ses propres boutons d'action Remplacer et Supprimer dans la colonne Actions.

De plus, si vous regroupez les looks par Contenu, vous avez la possibilité de les supprimer.

Remplacer les noms de champs, de vues, d'explorations et de modèles

Les résultats de la validation du contenu incluent un bouton Remplacer pour les types d'éléments suivants afin que vous puissiez les renommer:

Pour chacune de ces erreurs, vous pouvez utiliser le validateur de contenu pour remplacer un attribut du contenu qui est égal ou plus général que l'attribut à l'origine de l'erreur:

  • Si un champ génère une erreur, vous pouvez le remplacer/le supprimer, ou remplacer le nom de la vue, de l'exploration ou du modèle.
  • Si un nom d'exploration génère une erreur, vous pouvez remplacer le nom de l'exploration ou celui du modèle.
  • Si un nom de modèle génère une erreur, vous pouvez le remplacer.

Voici comment utiliser le validateur de contenu pour remplacer les noms des éléments de votre modèle:

  1. Cliquez sur Valider pour exécuter l'outil de validation du contenu.
  2. Sélectionnez un paramètre Grouper par pour choisir comment les erreurs sont regroupées. Par exemple, vous pouvez regrouper les éléments par Erreur afin de pouvoir en ajuster plusieurs en même temps.

  3. Dans le tableau des erreurs, cliquez sur le bouton Remplacer à côté de l'erreur que vous souhaitez corriger pour ouvrir la boîte de dialogue Mettre à jour dans le contenu.

  4. Dans la section Type de la boîte de dialogue Modifier dans le contenu, sélectionnez le type d'élément LookML que vous souhaitez modifier: champ, vue, exploration ou modèle. Looker affiche les options appropriées pour chaque erreur.

  5. Dans la section Nom, vérifiez le nom de l'élément que vous souhaitez remplacer. L'outil de validation du contenu les renseigne automatiquement.

  6. Dans la section Nom de remplacement, saisissez le nouveau nom de l'élément.

  7. Si vous avez regroupé les éléments par Erreur et que plusieurs d'entre eux sont concernés, vous pouvez cliquer sur Afficher le contenu pour obtenir la liste des éléments que le vérificateur de contenu modifiera.

  8. Vous pouvez également décocher les cases à côté des éléments listés pour ne pas modifier leur nom.

  9. Pour effectuer la modification, cliquez sur Remplacer.

Supprimer un nom de champ

Pour les erreurs associées à des noms de champs dans la section Données d'un look ou d'une carte, le tableau des erreurs affiche un bouton Supprimer à droite de l'erreur. Vous pouvez utiliser le validateur de contenu pour supprimer les champs suivants:

  • Dans la section Données d'une carte de présentation ou de tableau de bord
  • Référence dans les configurations de visualisation, comme la zone Personnalisations de l'onglet Séries pour les graphiques en colonnes
  • Référencer une carte de tableau de bord pour écouter un filtre de tableau de bord (cette configuration se trouve dans l'onglet Cartes à mettre à jour de la fenêtre de configuration du filtre, décrite sur la page de documentation Ajouter et modifier des filtres de tableaux de bord définis par l'utilisateur)

Vous ne pouvez pas utiliser le validateur de contenu pour supprimer des champs de filtres personnalisés, de champs personnalisés ou de calculs de table, car vous devez généralement apporter des modifications supplémentaires pour que l'expression continue de fonctionner. Utilisez plutôt les messages d'erreur de validation du contenu pour identifier les endroits où les filtres, les champs et les expressions de calcul de table personnalisés doivent être corrigés, puis retravaillez l'expression si nécessaire.

  1. Cliquez sur Valider pour exécuter l'outil de validation du contenu.
  2. Sélectionnez un paramètre Grouper par pour choisir comment les erreurs sont regroupées. Par exemple, vous pouvez regrouper par Erreur afin d'ajuster plusieurs éléments (visages, cartes ou les deux) en même temps.

  3. Dans le tableau des erreurs, cliquez sur Supprimer à côté de l'erreur de champ que vous souhaitez corriger pour ouvrir la boîte de dialogue Supprimer un champ du contenu.

  4. Dans la section Champ de la boîte de dialogue Supprimer un champ du contenu, vérifiez le nom de l'élément que vous souhaitez supprimer. L'outil de validation du contenu le renseigne automatiquement.

  5. Si vous avez regroupé les éléments par Erreur et qu'il y en a plusieurs (looks, cartes ou les deux), vous pouvez cliquer sur Afficher le contenu pour voir la liste des éléments que le validateur de contenu mettra à jour.

  6. Vous pouvez également décocher les cases à côté des présentations ou des cartes pour ne pas modifier leur nom.

  7. Cliquez sur Supprimer le champ pour effectuer la modification.

Suppression de présentations

Si vous regroupez le tableau des erreurs par Contenu, vous pouvez supprimer des présentations dans le tableau.

Pour utiliser le validateur de contenu pour supprimer des looks:

  1. Cliquez sur Valider pour exécuter l'outil de validation du contenu.
  2. Regroupez le tableau par Contenu.
  3. Dans le tableau des erreurs, cochez la case Sélectionner à côté du ou des looks que vous souhaitez supprimer.
  4. Cliquez sur Supprimer tous les looks sélectionnés.
  5. Cliquez sur OK dans la fenêtre de confirmation pour supprimer le ou les looks sélectionnés.

Utiliser l'outil de validation de contenu pour rechercher et remplacer

Vous pouvez également utiliser l'outil de validation du contenu pour rechercher et remplacer les noms de modèles, d'explorations et de champs. Par exemple, vous pouvez décider de remplacer un champ par un autre dans votre projet, même s'il n'y a pas d'erreur. La liste complète des éléments que le vérificateur de contenu peut rechercher/remplacer est fournie dans la section Remplacement des noms de champs, de vues, d'explorations et de modèles.

Pour utiliser le vérificateur de contenu comme outil de recherche et remplacement:

  1. Sur l'écran du validateur de contenu, cliquez sur Rechercher et remplacer dans tout le contenu pour ouvrir la boîte de dialogue Mettre à jour dans le contenu.
  2. Sélectionnez le type d'élément LookML que vous souhaitez modifier (champ, vue, exploration ou modèle).
  3. Saisissez le nom de l'élément que vous souhaitez remplacer.
  4. Saisissez un nom de remplacement pour le champ, la vue, l'exploration ou le modèle.
  5. Cliquez sur Remplacer pour effectuer la modification.

Éléments à prendre en compte

Planifiez de relancer la validation du contenu pour voir les résultats des corrections que vous apportez.

Notez les points suivants concernant le vérificateur de contenu:

  • Vous pouvez modifier le nom des vues, des explorations ou des modèles, mais vous ne pouvez pas les supprimer complètement. Consultez la section Supprimer un nom de champ pour obtenir la liste des éléments que vous pouvez supprimer avec l'outil de validation du contenu.
  • Les calculs de table ne peuvent faire référence qu'aux champs inclus dans la requête d'un look ou d'une carte. Cela signifie que si vous supprimez un champ de la requête d'une présentation ou d'une vignette, mais qu'un calcul de table utilise toujours ce champ, une nouvelle erreur de validation du contenu s'affiche.
  • Les looks supprimés et qui se trouvent sur la page Corbeille ne seront pas validés. Si vous souhaitez valider un look supprimé, votre administrateur Looker doit d'abord le restaurer.
  • Si vous êtes en mode Développement, les résultats de validation reflètent votre code LookML enregistré, même s'il n'a pas été mis en production. Toutefois, toute modification que vous apportez à l'aide du validateur de contenu affectera les utilisateurs qui regardent le contenu en mode production. Envisagez de passer en mode Production avant d'exécuter le validateur de contenu.