Le validateur de contenu recherche dans votre code LookML le modèle, l'exploration et les noms de champs 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 dans votre code LookML après avoir apporté des modifications et mettre à jour les noms des éléments LookML 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 alors utiliser l'outil de validation de contenu de deux manières:
- Cliquez sur Valider pour trouver et corriger les erreurs causées par les modifications apportées à votre modèle LookML.
- Cliquez sur Rechercher et Remplacer dans "Tout le contenu" pour rechercher et remplacer les noms de modèle, d'exploration ou de champs dans votre contenu Looker, qu'il comporte ou non des erreurs.
Avant d'utiliser l'outil de validation de contenu
Vous devez faire preuve d'une extrême prudence lorsque vous effectuez des modifications à l'aide de la validation de 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, essayez 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 l'outil de validation 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 les Looks et les vignettes trop tôt, en fonction de votre travail en mode Développement, les utilisateurs n'y auront pas accès tant que vous n'aurez pas déployé vos modifications. De même, si vous retardez la correction des Looks et des vignettes tant que vous n'avez pas appliqué les modifications, les présentations et les vignettes seront corrompues pour les 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 rechercher et corriger les erreurs résultant de modifications dans votre code 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 :
- Contenu pour lequel 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'autorisationdevelop(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 une présentation supprimée, votre administrateur Looker doit d'abord restaurer la présentation.
Exécuter l'outil de validation de contenu
Pour valider votre code LookML avec le programme de validation de contenu:
- Cliquez sur Valider.
- Sélectionnez les onglets Grouper par pour modifier la façon dont les erreurs sont regroupées:
- Erreur: répertoriez chaque erreur en regroupant les contenus Looker concernés par l'erreur. Cette fonctionnalité est utile si vous souhaitez corriger la même erreur dans plusieurs éléments de contenu à la fois.
- Dossier: répertoriez chaque dossier, regroupant le contenu Looker qui comporte des erreurs. Cela est utile si vous souhaitez corriger uniquement les erreurs dans un dossier particulier.
- Contenu: répertoriez tous les contenus qui comportent des erreurs en regroupant les 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.
- 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 Looks et des vignettes. Si vous "corrigez" avant d'appliquer vos modifications destructives, il y aura un certain temps pendant lequel le correctif sera prématuré, de sorte que les utilisateurs verront des Looks ou des vignettes non fonctionnels. Le message d'avertissement vous aidera à vous en souvenir.
- Le tableau d'erreurs affiche les erreurs éventuelles, ainsi que la liste des Looks et des vignettes qui contiennent l'erreur, ainsi que le modèle et l'exploration sous-jacents à l'origine de 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.
- Looker fournit les boutons Remplacer et/ou Supprimer pour chaque ligne, en fonction du type d'erreur. Ces boutons permettent de corriger les erreurs et sont décrits plus en détail dans l'article Corriger les erreurs à l'aide du validateur de contenu.
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. Pour en savoir plus sur les éléments LookML que le programme de validation de contenu peut trouver et valider, consultez la section Utiliser le programme de validation de contenu pour corriger les erreurs.
L'icône située à côté du nom du contenu identifie le type de contenu:
: vignette du tableau de bord
: alerte du tableau de bord
: planifier l'envoi d'un tableau de bord ou d'une apparence
: filtre d'un tableau de bord ou d'un champ d'une vignette qui écoute un filtre de tableau de bord (consultez la page Ajouter et modifier des filtres de tableau de bord définis par l'utilisateur pour en savoir plus sur la configuration des vignettes permettant d'écouter des filtres de tableau 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 fichiers 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).
- Suppression: pour les erreurs liées aux noms de champs dans la section Données d'une présentation ou d'une carte, Looker affiche également le bouton Supprimer (consultez la section Supprimer un nom de champ plus loin sur cette page pour savoir comment supprimer des noms à l'aide de l'outil de validation de contenu).
En fonction du paramètre Grouper par, les boutons s'appliquent à un seul élément (Aperçu ou vignette) ou à plusieurs éléments:
- Si vous regroupez par Erreur, les boutons s'appliquent à toutes les occurrences de cette erreur dans toutes les présentations et vignettes de votre instance Looker, ce qui vous permet de corriger toutes les occurrences en une seule opération.
- Si vous regroupez les données 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, une table d'erreurs est regroupée par Erreur et affiche trois instances de contenu avec une exploration inconnue nommée customers. L'action fournie pour les trois éléments de contenu 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 contenu intitulé Détails de la commande. Quatre erreurs Unknown field s'affichent dans la colonne Erreurs. Chacune d'elles dispose de ses propres boutons d'action Remplacer et Supprimer dans la colonne Actions.
De plus, si vous regroupez les contenus par Contenu, vous pouvez également supprimer des looks.
Remplacement des noms des champs, des vues, des explorations et des 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 :
- Noms des modèles dans les présentations et les cartes de tableau de bord
- Explorer les noms dans les Looks et les vignettes du tableau de bord
- Afficher les noms dans les filtres personnalisés ou les calculs de table
- Afficher les noms dans les Looks et les vignettes du tableau de bord
- Noms des champs:
- Dans la section Données d'une présentation
- Dans une vignette de tableau de bord basée sur des requêtes
- Références dans les calculs de table
- Références dans les filtres personnalisés
- Références dans les champs personnalisés
- 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)
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 comporte des erreurs, vous pouvez le remplacer/supprimer le champ, ou remplacer le nom de la vue, de l'exploration ou du modèle.
- Si un nom d'exploration comporte des erreurs, vous pouvez remplacer le nom de l'exploration ou le nom 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 :
- Cliquez sur Valider pour exécuter l'outil de validation de contenu.
- Sélectionnez un paramètre Grouper par pour choisir la façon dont 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.
Dans le tableau d'erreurs, cliquez sur le bouton Remplacer à côté de l'erreur à corriger pour ouvrir la boîte de dialogue Mettre à jour dans le contenu.
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.
Dans la section Nom, validez le nom de l'élément que vous souhaitez remplacer. L'outil de validation du contenu les renseigne automatiquement.
Dans la section Nom de remplacement, saisissez le nouveau nom de l'élément.
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 voir la liste des éléments que le vérificateur de contenu modifiera.
Si vous le souhaitez, vous pouvez décocher les cases à côté des éléments de la liste pour ne pas modifier leur nom.
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 comporte un bouton Supprimer à droite de l'erreur. Vous pouvez utiliser l'outil de validation du contenu pour supprimer les champs suivants :
- Dans la section Données d'une présentation ou d'une vignette 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érencé par une vignette de tableau de bord pour écouter un filtre de tableau de bord (ceci est configuré dans l'onglet Vignettes à mettre à jour de la fenêtre de configuration du filtre, décrit sur la page de documentation Ajouter et modifier des filtres de tableau 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 trouver les endroits où les filtres personnalisés, les champs personnalisés et les expressions de calcul de table doivent être corrigés, puis retravaillez l'expression si nécessaire.
- Cliquez sur Valider pour exécuter l'outil de validation du contenu.
- Sélectionnez un paramètre Grouper par pour choisir la façon dont 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.
Dans le tableau d'erreurs, cliquez sur Supprimer à côté de l'erreur de champ que vous souhaitez corriger pour ouvrir la boîte de dialogue Supprimer le champ du contenu.
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.
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.
Vous pouvez également décocher les cases à côté des présentations ou des cartes pour ne pas modifier leur nom.
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 supprimer des Looks à l'aide du validateur de contenu:
- Cliquez sur Valider pour exécuter l'outil de validation du contenu.
- Regroupez le tableau par Contenu.
- Dans le tableau d'erreurs, cliquez sur la case Sélectionner à côté de la ou des Looks que vous souhaitez supprimer.
- Cliquez sur Supprimer tous les looks sélectionnés.
- 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 de contenu pour rechercher et remplacer les noms des modèles, des explorations et des champs. Par exemple, vous pouvez décider de remplacer un champ par un autre et d'effectuer ce remplacement dans votre projet, même s'il n'y a pas d'erreur. La liste complète des éléments que le validateur de contenu peut rechercher ou remplacer est disponible dans la section Remplacer les noms des champs, des vues, des explorations et des modèles.
Pour utiliser le vérificateur de contenu comme outil de recherche et de remplacement :
- 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.
- Sélectionnez le type d'élément LookML que vous souhaitez modifier (champ, vue, exploration ou modèle).
- Saisissez le nom de l'élément que vous souhaitez remplacer.
- Saisissez un nom de remplacement pour le champ, la vue, l'exploration ou le modèle.
- Cliquez sur Remplacer pour appliquer la modification.
Éléments à prendre en compte
Planifiez de réexécuter 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 à l'aide de l'outil de validation de contenu.
- Les calculs de table peuvent uniquement référencer des champs qui sont inclus dans la requête d'une présentation ou d'une vignette. Cela signifie que si vous supprimez un champ de la requête d'une présentation ou d'une carte, mais qu'un calcul de table utilise toujours ce champ, une nouvelle erreur de validation du contenu s'affiche.
- Les Looks qui ont été supprimés et qui se trouvent dans 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 la validation refléteront le code LookML enregistré, même s'il n'a pas été mis en production. Toutefois, toutes les modifications que vous apportez à l'aide de l'outil de validation de contenu affecteront les utilisateurs qui consultent le contenu en mode Production. Envisagez de passer en mode Production avant d'exécuter l'outil de validation de contenu.