Validation du contenu

Le validateur de 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 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 Content Validator dans le menu Develop (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 identifier 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 de modèle, d'exploration ou de champ dans votre contenu Looker, que ce dernier comporte ou non des erreurs.

Avant d'utiliser l'outil de validation de contenu

Vous devez faire extremely attention lorsque vous apportez des modifications à l'aide de la validation de contenu. Le validateur de contenu n'a pas de fonction d'annulation. Il peut affecter de nombreux Looks et tableaux de bord, ainsi que les 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 concernés plus difficile.

Tenez également compte de votre calendrier lorsque vous utilisez le validateur de contenu. Lorsque vous déployez les modifications de développement en production, vous devez corriger les Looks et les vignettes concernés à peu près au même moment, afin qu'ils soient interrompus pendant le moins de temps possible. Si vous corrigez les Looks et les cartes trop tôt, d'après votre travail en mode Développement, les utilisateurs ne pourront pas les voir tant que vous n'aurez pas déployé vos modifications. De même, si vous retardez la correction des Looks et des vignettes jusqu'à ce que vous les corrigiez longtemps après avoir appliqué les modifications, les Looks et les vignettes seront brisés pour les utilisateurs jusqu'à ce que vous les corrigiez.

Remarque:Si vous utilisez le validateur de contenu pour modifier les noms de champs servant de filtres dans vos tableaux de bord, veillez à consulter la section Filtres de vos planifications de tableaux de bord et à mettre à jour les filtres en fonction de vos modifications. Si un envoi planifié de tableau de bord inclut des filtres qui ne fonctionnent plus (par exemple, si le champ référencé a changé), 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 Résultats fusionnés, car le validateur de contenu applique les modifications à chaque exploration incluse dans la vignette des résultats fusionnés. Par exemple, vous ne pouvez pas utiliser le validateur de contenu pour modifier le nom du modèle dans une seule exploration d'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 les erreurs à l'aide du validateur de contenu

Le validateur de contenu est un outil utile pour trouver et corriger les erreurs résultant de modifications de votre code LookML. Par exemple, si vous remplacez le nom customer d'un champ par user, les vignettes ou vignettes de tableau de bord qui incluaient le champ customer ne fonctionneront plus (sauf si vous avez utilisé le paramètre alias). Le validateur de contenu liste toutes les références au champ customer et permet également de corriger facilement l'erreur.

Lorsque vous exécutez le validateur de contenu, celui-ci 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 faite par votre contenu à un objet LookML inconnu.

L'outil de validation de 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'autorisation develop (les modèles que vous pouvez voir dans l'IDE Looker). Pour en savoir plus sur les autorisations des modèles, consultez la page de la documentation Rôles.
• Des Looks qui ont été supprimés et qui 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

Important :Lisez la section Avant d'utiliser l'outil de validation de contenu avant de continuer. Le validateur de contenu peut avoir une incidence 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 l'outil de validation de contenu:

1. Cliquez sur Valider.
2. Sélectionnez les onglets Grouper par pour modifier le mode de regroupement des erreurs :
   • Erreur: listez chaque erreur en regroupant le contenu Looker concerné. Cette fonctionnalité est utile si vous souhaitez corriger la même erreur dans plusieurs éléments de contenu à la fois.
   • Dossier: listez chaque dossier en regroupant le contenu Looker comportant des erreurs. Cela est utile si vous souhaitez corriger uniquement les erreurs d'un dossier particulier.
   • Contenu: répertorie tous les contenus comportant des erreurs et regroupez leurs erreurs. Cette fonctionnalité est utile si vous souhaitez corriger toutes les erreurs d'une présentation, d'une vignette, d'un filtre, etc.
3. Si vous êtes en mode Développement, Looker affiche un message d'avertissement. Il est important de comprendre ce qu'implique le changement de Looks et de vignettes. Si vous les "corrigez" avant d'appliquer vos modifications destructives, il y aura une période pendant laquelle la correction sera prématurée. Les utilisateurs rencontreront donc des Looks ou des vignettes défectueux. Le message d'avertissement vous aide à vous en souvenir.
4. 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 sous-jacent et l'exploration à 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 d'erreurs.
5. Looker propose les boutons Replace (Remplacer) et/ou Remove (Supprimer) pour chaque ligne, selon le type d'erreur. Ces boutons permettent de corriger les erreurs. Ils sont décrits plus en détail ci-dessous.

Afficher les résultats de validation du contenu

Les résultats de la validation de contenu affichent du contenu Looker qui utilise des noms de modèles, d'explorations, de vues ou de champs qui n'existent pas ou sont introuvables. Consultez la section Utiliser le validateur de contenu pour corriger les erreurs pour en savoir plus sur les éléments LookML que le validateur de contenu peut rechercher et valider.

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 la création d'un tableau de bord ou d'un Look
• : 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 pour écouter les filtres du tableau de bord)

Les résultats de la validation sont basés sur le code LookML disponible dans le mode que vous utilisez lorsque vous exécutez le programme de validation. Si vous êtes en mode production, les résultats de la validation reflètent l'intégralité du code LookML ayant été déployé en production. Si vous êtes en mode Développement, les résultats de la validation reflètent votre code LookML enregistré, même s'il n'a pas été envoyé en production.

Les erreurs peuvent être dues à 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 pour chaque ligne du tableau d'erreurs, comme suit:

• Remplacer: Looker fournit un 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 des noms à l'aide du validateur de contenu).
• Supprimer: pour les erreurs liées aux noms de champs dans la section Données d'une présentation ou d'une vignette, 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 avec le validateur de contenu).

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

• Si vous regroupez par Erreur, les boutons s'appliquent à toutes les occurrences de cette erreur dans l'ensemble des Looks et des vignettes de votre instance Looker. Vous pouvez ainsi corriger toutes les occurrences en une seule opération.
• Si vous regroupez par Dossier ou Contenu, les boutons s'appliquent à une occurrence de l'erreur dans une seule présentation ou une seule vignette, ce qui vous permet de considérer 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 affecte les trois instances de contenu associées à l'erreur 3 x Unknown explore 'customers'.

Dans certains cas, plusieurs erreurs peuvent se produire pour des é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. Chaque erreur possède son propre bouton d'action Remplacer et Supprimer dans la colonne Actions.

De plus, si vous regroupez par Contenu, vous avez la possibilité supplémentaire de supprimer des Looks.

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

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

• Noms de modèles dans les vignettes et les vignettes du tableau de bord
• Noms d'explorations dans les Looks et les vignettes du tableau de bord
• Noms de vues 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 une requête
  • référencés dans les calculs de table.
  • Référencé dans les filtres personnalisés
  • Référencé dans des champs personnalisés
  • référencés dans les configurations de visualisation, comme la zone Personnalisations de l'onglet Séries pour les graphiques à colonnes.
  • Référencé par une vignette de tableau de bord pour écouter un filtre de tableau de bord (configuré dans l'onglet Vignettes à mettre à jour de la fenêtre de configuration du filtre, décrit dans 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 le validateur de contenu pour remplacer un attribut du contenu égal ou plus général que l'attribut qui génère l'erreur:

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

Pour remplacer les noms des éléments de votre modèle à l'aide du validateur de contenu, procédez comme suit:

1. Cliquez sur Valider pour exécuter le programme de validation de contenu.
2. Sélectionnez un paramètre Grouper par pour choisir la manière dont les erreurs sont regroupées. Par exemple, vous pouvez effectuer un regroupement par Erreur afin de pouvoir ajuster plusieurs éléments en même temps.

3. Dans le tableau d'erreurs, cliquez sur le bouton Replace à côté de l'erreur que vous souhaitez corriger pour ouvrir la boîte de dialogue Update in Content (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, vérifiez le nom de l'élément que vous souhaitez remplacer. Le validateur de contenu remplit ces informations automatiquement.

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

7. Si vous avez effectué un regroupement par Erreur et que plusieurs éléments sont concernés, vous pouvez cliquer sur Afficher le contenu pour consulter la liste des éléments mis à jour par le validateur 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 effectuer la modification, cliquez sur Remplacer.

Supprimer un nom de champ

En cas d'erreurs liées aux noms de champs dans la section Données d'une présentation ou d'une vignette, le tableau d'erreurs inclut un bouton Supprimer à droite de l'erreur. Vous pouvez utiliser le validateur de contenu pour supprimer les champs qui sont:

• Dans la section Données d'une présentation ou d'une vignette de tableau de bord
• référencés dans les configurations de visualisation, comme la zone Personnalisations de l'onglet Séries pour les graphiques à colonnes.
• Référencé par une vignette de tableau de bord pour écouter un filtre de tableau de bord (configuré dans l'onglet Vignettes à mettre à jour de la fenêtre de configuration du filtre, décrit dans 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 des filtres personnalisés, des champs personnalisés ou des calculs de table, car en général, vous devez 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 personnalisés, les champs personnalisés et les expressions de calcul de tables doivent être corrigés, puis retravaillez l'expression si nécessaire.

1. Cliquez sur Valider pour exécuter le programme de validation de contenu.
2. Sélectionnez un paramètre Grouper par pour choisir la manière dont les erreurs sont regroupées. Par exemple, vous pouvez effectuer un regroupement par erreur afin de pouvoir ajuster plusieurs éléments (Looks, 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. Le validateur de contenu le remplit automatiquement.

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

   

6. Vous pouvez éventuellement décocher les cases à côté des Looks ou des vignettes pour ne pas modifier leur nom.

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

Suppression de présentations

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

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

1. Cliquez sur Valider pour exécuter le programme de validation de contenu.
2. Groupez le tableau par Contenu.
3. Dans le tableau d'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.

Remarque :Si vous supprimez accidentellement un Look, votre administrateur Looker peut le récupérer pour vous. Looker stocke le contenu supprimé dans la corbeille jusqu'à ce que l'équipe d'administration Looker la supprime dans le cadre du processus de maintenance.

Utiliser le validateur de contenu pour rechercher et remplacer

Vous pouvez également utiliser le validateur de contenu pour rechercher et remplacer les noms des modèles, des explorations et des champs. Par exemple, vous pouvez décider que vous préférez un champ plutôt qu’un autre et que vous souhaitez 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/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 une incidence 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 le validateur de contenu comme outil de recherche et remplacement:

1. Sur l'écran de validation de contenu, cliquez sur Find & Replace in All Content (Rechercher et remplacer dans tous les contenus) pour ouvrir la boîte de dialogue Update in Content (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 appliquer la modification.

Éléments à prendre en compte

Prévoyez d'exécuter de nouveau la validation du contenu pour afficher les résultats des corrections que vous avez effectuées.

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

• Vous pouvez modifier leur nom pour les vues, les explorations ou les 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 du validateur de 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 vignette. 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, vous obtiendrez une nouvelle erreur de validation du contenu.
• Les Looks qui ont été 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 la validation reflètent votre code LookML enregistré, même s'il n'a pas été envoyé en production. Toutefois, les modifications que vous effectuez à l'aide de l'outil de validation de contenu affectent les utilisateurs qui consultent le contenu en mode Production. Envisagez de passer en mode production avant d'exécuter Content Validator.