Validation du contenu

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 l'outil de validation de contenu.

Pour ouvrir l'outil de validation de contenu, sélectionnez Validateur 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 rechercher et corriger les erreurs causées par des modifications de votre modèle LookML.
• Cliquez sur Rechercher et remplacer dans tout le contenu pour rechercher et remplacer les noms du modèle, de l'exploration ou des 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 extremely lorsque vous effectuez des modifications à l'aide de la validation de contenu. Le validateur de contenu n'a pas de fonction d'annulation et peut affecter de nombreux Looks et tableaux de bord, ainsi que leurs liens Explorer à partir d'ici. Si vous faites une erreur, vous devez essayer de la corriger dès que possible, avant que des modifications supplémentaires ne rendent l'isolation des Looks affectés plus difficile.

Tenez également compte du moment où vous utilisez l'outil de validation de contenu. Lorsque vous déployez les modifications de développement en production, vous devez corriger les Looks et les vignettes affectés en même temps, afin qu'ils ne soient pas fonctionnels pendant la 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.

Remarque:Si vous utilisez l'outil de validation de contenu pour modifier les noms de champs servant de filtres dans vos tableaux de bord, pensez à consulter la section Filtres de la planification de vos tableaux de bord et à mettre à jour les filtres en fonction de vos modifications. Si un envoi planifié d'un tableau de bord inclut des filtres qui ne fonctionnent plus (par exemple, si le champ référencé a été modifié), l'envoi planifié échouera et le propriétaire de la planification recevra un message d'erreur indiquant qu'un filtre n'est pas valide.

Soyez prudent lorsque vous utilisez le validateur de contenu pour modifier une exploration utilisée dans une vignette de tableau de bord de résultats fusionnés, car le validateur de contenu applique les modifications à chaque exploration incluse dans la vignette de résultats fusionnés. Par exemple, vous ne pouvez pas utiliser le validateur de contenu pour modifier le nom du modèle dans une exploration unique dans une vignette de résultats fusionnés sans modifier le nom du modèle dans toutes les explorations incluses dans les résultats fusionnés.

Corriger des erreurs à l'aide de l'outil de validation de contenu

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, toutes les présentations ou vignettes de tableau de bord qui incluent le champ customer ne fonctionneront plus (sauf si vous utilisez le paramètre alias). L'outil de validation de contenu liste toutes les références au champ customer et vous permet de corriger facilement l'erreur.

Lorsque vous exécutez le validateur de contenu, il valide toutes les références que vos présentations 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 de contenu n'affiche pas les 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'autorisation develop (les modèles que vous pouvez voir dans l'IDE Looker). Consultez la page de documentation Rôles pour en savoir plus sur les autorisations associées aux modèles.
• Look qui ont été supprimés et qui 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

Important :Lisez la section Avant d'utiliser l'outil de validation de contenu avant de continuer. Le validateur de contenu peut avoir un impact sur de nombreuses parties de votre contenu Looker. Il est donc important de le planifier et de le prendre en compte au préalable.

Pour valider votre code LookML avec le programme de validation de contenu:

1. Cliquez sur Valider.
2. 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: listez chaque dossier, regroupant le contenu Looker qui comporte des erreurs. Cette fonctionnalité est utile si vous souhaitez corriger uniquement les erreurs contenues dans un dossier particulier.
   • Contenu: répertoriez tous les contenus qui comportent des erreurs en regroupant les erreurs. Cela est utile si vous souhaitez corriger toutes les erreurs dans un seul Look, une seule vignette, 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 Looks et des vignettes. Si vous les « corrigez » avant d'appliquer vos modifications destructives, il y aura un certain temps pendant lequel la correction sera prématurée, de sorte que les utilisateurs verront des Looks ou des vignettes non fonctionnels. Le message d'avertissement vous aidera à vous en souvenir.
4. La table d'erreurs affiche toute erreur, ainsi qu'une liste des Looks et des vignettes qui la contiennent, 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 de la table d'erreurs.
5. Looker fournit les boutons Remplacer et/ou Supprimer pour chaque ligne, selon le type d'erreur. Ces boutons permettent de corriger les erreurs. Ils sont décrits plus en détail dans l'article Corriger les erreurs à l'aide du validateur de contenu.

Afficher les résultats de la validation de contenu

Les résultats de la validation de contenu montrent le contenu Looker qui utilise des noms de modèle, d'exploration, de vue ou de champ qui n'existent pas ou sont introuvables. Pour en savoir plus sur les éléments LookML que le validateur de contenu peut trouver et valider, consultez la section Utiliser le validateur 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
• : planification pour un tableau de bord ou une présentation
• : 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 les filtres de tableau de bord)

Les résultats de la validation sont basés sur le code LookML disponible dans le mode dans lequel vous vous trouvez lorsque vous exécutez le programme de validation. Si vous êtes en mode Production, les résultats de la validation refléteront tous les LookML qui ont été mis en production. 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.

Les erreurs peuvent être causées par des modifications intentionnelles de votre code LookML, ainsi qu'une faute de frappe ou une jointure manquante.

Pour corriger les erreurs, vous pouvez utiliser les boutons Remplacer et Supprimer de chaque ligne du tableau d'erreurs, comme suit:

• Remplacer: Looker propose le bouton Remplacer pour chaque erreur (consultez 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 par 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 peuvent s'appliquer à un seul élément (Aperçu ou vignette) ou à plusieurs éléments:

• Si vous regroupez les données 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 par Dossier ou par Contenu, les boutons s'appliquent à une seule occurrence de l'erreur dans un seul Look ou dans une seule tuile, 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 Replace (Remplacer). Si vous cliquez sur Remplacer, les trois instances de contenu comportant l'erreur 3 x Unknown explore 'customers' sont affectées.

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

De plus, si vous effectuez un regroupement par Contenu, vous avez la possibilité supplémentaire de 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 de modèles dans les Looks et les vignettes du 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 tuile de tableau de bord basée sur une requête
  • 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érences dans les configurations de visualisation, comme la zone Personnalisations de l'onglet Série pour les graphiques à 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)

Pour chacune de ces erreurs, vous pouvez utiliser l'outil de validation de contenu pour remplacer un attribut du contenu qui est égal ou plus général à l'attribut concerné par 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 comporte des erreurs, vous pouvez le remplacer.

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

1. Cliquez sur Valider pour exécuter l'outil de validation de contenu.
2. Sélectionnez un paramètre Grouper par pour choisir la façon dont les erreurs sont regroupées. Par exemple, vous pouvez regrouper les données par Erreur afin de pouvoir ajuster plusieurs éléments à la fois.

3. 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.

4. Dans la section Type de la boîte de dialogue Update in Content (Mettre à jour 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, validez le nom de l'élément que vous souhaitez remplacer. L'outil de validation de contenu saisit automatiquement ces informations.

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

7. Si vous avez regroupé les données par Erreur et que plusieurs éléments sont concernés, vous pouvez cliquer sur Afficher le contenu pour afficher la liste des éléments qui seront mis à jour par l'outil de validation de contenu.

   

8. Si vous le souhaitez, vous pouvez décocher les cases à côté des éléments de la liste pour ne pas modifier leur nom.

9. Pour apporter la modification, cliquez sur Remplacer.

Supprimer un nom de champ

Pour les erreurs liées aux noms de champs figurant dans la section Données d'une présentation ou d'une vignette, le tableau d'erreurs proposera un bouton Supprimer à droite de l'erreur. Vous pouvez utiliser l'outil de validation de contenu pour supprimer les champs qui:

• Dans la section Données d'une présentation ou d'une vignette de tableau de bord
• Références dans les configurations de visualisation, comme la zone Personnalisations de l'onglet Série pour les graphiques à 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 l'outil de validation 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.

1. Cliquez sur Valider pour exécuter l'outil de validation de contenu.
2. Sélectionnez un paramètre Grouper par pour choisir la façon dont les erreurs sont regroupées. Par exemple, vous pouvez regrouper les données par Erreur afin d'ajuster plusieurs éléments (présentations, vignettes ou les deux) en même temps.

3. 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.

   

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

5. Si vous avez effectué un regroupement par Erreur et qu'il y a plusieurs éléments (présentations, vignettes ou les deux), vous pouvez cliquer sur Afficher le contenu pour afficher la liste des éléments qui seront mis à jour par l'outil de validation de contenu.

   

6. Si vous le souhaitez, vous pouvez décocher les cases à côté des Looks ou des vignettes pour conserver leurs noms tels quels.

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

Suppression de présentations

Si vous regroupez le tableau d'erreurs par Contenu, vous avez la possibilité de supprimer les Looks dans le tableau.

Pour supprimer des Looks à l'aide du validateur de contenu:

1. Cliquez sur Valider pour exécuter l'outil de validation de contenu.
2. Regroupez le tableau par Contenu.
3. Dans le tableau d'erreurs, cliquez sur la case Sélectionner à côté de la ou des Looks que vous souhaitez supprimer.
4. Cliquez sur Supprimer tous les Looks sélectionnés.
5. Cliquez sur OK dans la boîte de dialogue de confirmation pour supprimer le ou les Looks sélectionnés.

Remarque :Si vous supprimez accidentellement une présentation, votre administrateur Looker pourra peut-être le récupérer pour vous. Looker stocke le contenu supprimé dans la corbeille jusqu'à ce que l'équipe d'administration Looker la vide dans la corbeille dans le cadre du processus de maintenance.

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.

Important :Lisez la section Avant d'utiliser l'outil de validation de contenu avant de continuer. Le validateur de contenu peut avoir un impact sur de nombreuses parties de votre contenu Looker. Il est donc important de le planifier et de le prendre en compte au préalable.

Pour utiliser l'outil de validation de contenu en tant qu'outil de recherche et remplacement, procédez comme suit:

1. Sur l'écran "Outil de validation 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 à remplacer.
4. Saisissez un nom de remplacement pour le champ, la vue, l'exploration ou le modèle.
5. Cliquez sur Remplacer pour appliquer la modification.

Éléments à prendre en compte

Prévoyez d'exécuter une nouvelle validation du contenu pour afficher les résultats des corrections que vous avez apportées.

Notez les points suivants à propos de l'outil de validation de contenu:

• Vous pouvez modifier le nom des vues, des explorations ou des modèles, mais vous ne pouvez pas en 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 d'une requête de présentation ou de vignette, mais qu'un calcul de table l'utilise tout de même, vous recevrez une nouvelle erreur de validation du contenu.
• Les Looks qui ont été supprimés et qui se trouvent dans la page Corbeille ne seront pas validés. Si vous souhaitez valider une présentation supprimée, votre administrateur Looker doit d'abord restaurer la présentation.
• 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.