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 (présentations et tableaux de bord). 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.

En effet, un développeur doit pouvoir corriger le contenu qui pourrait être défectueux lorsqu'il modifie le code LookML sous-jacent.

Pour ouvrir le vérificateur de contenu, sélectionnez Content Validator (Valideur de contenu) dans le menu Develop (Développer) du panneau de navigation principal. 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 fournit également les boutons Remplacer ou Supprimer pour corriger 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:

  • Looks supprimés et placés dans la Corbeille. Si vous souhaitez valider un look supprimé, votre administrateur Looker doit d'abord le restaurer.

  • Contenus basés sur des modèles LookML pour lesquels vous ne disposez pas de l'autorisation develop. Vous ne pouvez utiliser l'outil de validation du contenu que sur les contenus basés sur des modèles pour lesquels 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.

Exécuter l'outil de validation de contenu

Pour améliorer les performances du vérificateur de contenu, un administrateur Looker peut activer la fonctionnalité Labs Étendue du vérificateur de contenu sur votre instance. Lorsque cette fonctionnalité Labs est activée, vous pouvez limiter la validation à des projets LookML et à un dossier de contenu spécifiques. Pour savoir comment définir le champ d'application de la validation, consultez la section Définir le champ d'application du validateur de contenu.

Si la fonctionnalité de test de la fonctionnalité de validation du contenu n'est pas activée sur votre instance, procédez comme suit pour exécuter la validation du contenu:

  1. Cliquez sur l'icône du menu principal de Looker, puis sélectionnez Développer si le menu Développer n'est pas déjà affiché.
  2. Dans le menu Développer, sélectionnez Valideur de contenu.
  3. Sur la page du validateur de contenu, cliquez sur Valider.

Le validateur de contenu exécute la validation sur l'ensemble du contenu basé sur des projets LookML pour lesquels vous disposez de l'autorisation develop, puis affiche les résultats. Pour en savoir plus sur l'examen des résultats, consultez la section Afficher les résultats de la validation du contenu.

Définir le champ d'application de la validation de contenu

Lorsque la fonctionnalité Labs Établir le champ d'application du validateur de contenu est activée, vous pouvez limiter la validation à des projets LookML spécifiques et à un dossier de contenu spécifique (y compris ses sous-dossiers, le cas échéant). Cela peut améliorer les performances du vérificateur de contenu.

Notez les points suivants concernant le champ d'application du vérificateur de contenu:

  • Si vous ne spécifiez pas de dossier ni de projet LookML, la validation n'aura pas de portée. Le validateur de contenu valide tout le contenu basé sur des modèles pour lesquels vous disposez de l'autorisation develop.
  • Si vous spécifiez un dossier de contenu, le validateur de contenu effectue une validation sur le dossier de contenu et tous ses sous-dossiers, le cas échéant.
  • Si vous spécifiez un dossier de contenu et un ou plusieurs projets LookML, les deux conditions s'appliquent: l'outil de validation du contenu ne valide que le contenu du dossier (et des sous-dossiers) basé sur les projets LookML que vous avez sélectionnés.
  • Les alertes, les planifications et les calendriers de tableaux de bord et de présentations ne sont pas stockés dans les dossiers de contenu. Par conséquent, si vous limitez la validation du contenu à un dossier, l'outil de validation du contenu ne validera aucun calendrier ni aucune alerte.

  • Si vous spécifiez un projet LookML, l'outil de validation du contenu détermine les modèles associés au projet en examinant le code LookML source des projets spécifiés et les modèles configurés pour chaque projet, que vous pouvez consulter sur la page Projets LookML. Si un fichier de modèle a été supprimé d'un projet LookML et qu'il n'est pas affiché en tant que modèle dans le projet sur la page Projets LookML, l'outil de validation du contenu n'affichera pas les erreurs liées au contenu basé sur ce modèle supprimé.

Pour exécuter le vérificateur de contenu sur une instance Looker avec l'élagage du vérificateur de contenu activé, procédez comme suit:

  1. Cliquez sur l'icône du menu principal de Looker, puis sélectionnez Développer si le menu Développer n'est pas déjà affiché.
  2. Dans le menu Développer, sélectionnez Valideur de contenu.

  3. Sur la page du validateur de contenu, cliquez sur Valider.

    L'outil de validation du contenu affiche la boîte de dialogue Sélectionner les projets à valider.

  4. Dans la boîte de dialogue Choisir des projets à valider, effectuez l'une des opérations suivantes:

    • Pour exécuter le validateur sur tous les projets LookML, laissez le champ Sélectionner des projets tel quel, sans sélectionner de projets, puis cliquez sur Suivant.
    • Pour exécuter le validateur sur un ou plusieurs projets LookML spécifiques, cliquez sur le menu déroulant Sélectionner des projets, sélectionnez les projets que vous souhaitez valider, puis cliquez sur Suivant.

    L'outil de validation du contenu affiche la boîte de dialogue Sélectionner le dossier à valider.

  5. Dans la boîte de dialogue Choisir un dossier à valider, effectuez l'une des opérations suivantes:

    • Pour exécuter le validateur sur tous les dossiers de contenu, laissez le sélecteur Dossiers tel quel, sans sélectionner de dossiers, puis cliquez sur Suivant.
    • Pour exécuter le validateur sur un dossier de contenu spécifique (et ses sous-dossiers, le cas échéant), utilisez le sélecteur Dossiers pour sélectionner le dossier que vous souhaitez valider, puis cliquez sur Suivant.

    La boîte de dialogue Vérifier les sélections affiche les projets et les dossiers que vous avez sélectionnés pour validation.

  6. Dans la boîte de dialogue Vérifier les sélections, cliquez sur Valider.

Le validateur de contenu effectue une validation du contenu que vous avez spécifié, puis affiche les résultats. Pour en savoir plus sur l'examen des résultats, consultez la section Afficher les résultats de la validation du contenu.

Afficher les résultats de validation du contenu

Une fois la validation terminée, le valideur de contenu affiche un tableau d'erreurs. Si un administrateur Looker a activé la fonctionnalité Labs Établir le champ d'application du validateur de contenu sur votre instance, les résultats de validation sont limités aux projets et aux dossiers que vous avez sélectionnés lorsque vous avez exécuté le validateur de contenu.

Les résultats de validation du contenu indiquent les contenus Looker qui utilisent 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.

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é déployé en production.

Le tableau des erreurs affiche chaque 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.

Fenêtre de l'outil de validation de contenu affichant plusieurs erreurs dans les résultats de validation

Vous pouvez utiliser les onglets Grouper par en haut à droite de la page pour modifier la mise en page du tableau des erreurs:

  • Erreur: listez chaque erreur, en regroupant le contenu Looker concerné. Cette option est utile si vous souhaitez corriger la même erreur dans plusieurs contenus en une seule fois.
  • 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.

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

  • 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 tableau de bord)

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

Pour chaque ligne, Looker fournit un bouton Remplacer ou Supprimer, ou les deux, 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. 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 l'outil de validation du 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).

En fonction du paramètre Grouper par, les boutons Remplacer et Supprimer 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 provoque une erreur, vous pouvez le remplacer ou le supprimer, ou remplacer le nom de la vue, de l'exploration ou du modèle.
  • Si un nom d'exploration provoque une erreur, vous pouvez remplacer le nom de l'exploration ou celui du modèle.
  • Si un nom de modèle provoque 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 comporte 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.

Supprimer des 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 le bouton Supprimer tous les looks sélectionnés en haut du tableau des erreurs.
  5. Cliquez sur OK dans la fenêtre de confirmation pour supprimer le ou les looks sélectionnés.

Utiliser l'outil de validation du 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 et 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 le 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 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 qui ont été supprimés et qui se trouvent dans le dossier 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.