Validation de contenu

L'outil de validation de contenu recherche dans votre ML les noms de modèles, d'explorations et de champs référencés dans votre contenu Looker. Il s'agit d'un outil très utile pour valider vos références LookML, corriger les erreurs dans LookML après avoir apporté des modifications et mettre à jour les noms de vos éléments LookML dans 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 l'option Outil de validation de contenu dans le menu Développer:

Vous pouvez alors utiliser l'outil de validation de contenu de deux manières:

Avant d'utiliser l'outil de validation de contenu

Vous devez extrêmement faire preuve de prudence lorsque vous apportez des modifications à l'aide de la validation de contenu. L'outil de validation de contenu n'a pas de fonction d'annulation. Il peut potentiellement affecter de nombreux styles et tableaux de bord, comme les liens Explorer d'ici. Si vous faites une erreur, essayez de la corriger dès que possible, avant d'apporter d'autres modifications pour isoler les looks concernés.

Tenez également compte du calendrier lorsque vous utilisez l'outil de validation de contenu. Lorsque vous déployez des modifications de développement en production, vous devez corriger les cartes et les styles concernés à peu près en même temps, afin qu'ils soient interrompus pendant la durée minimale. Si vous corrigez les styles et les tuiles trop tôt, sur la base de votre travail en mode Développement, ils ne seront pas visibles par les utilisateurs jusqu'à ce que vous appliquiez vos modifications. De même, si vous retardez la correction des styles et des cartes jusqu'à ce que vous ayez appliqué les modifications, ces derniers ne s'afficheront plus tant que vous n'aurez pas corrigé les problèmes.

Si vous utilisez l'outil de validation de contenu pour modifier les noms des champs qui servent de filtres dans vos tableaux de bord, consultez la section Filtres dans les plannings de vos tableaux de bord et mettez à jour les filtres si nécessaire. Si une diffusion planifiée dans le tableau de bord inclut des filtres qui ne fonctionnent plus (par exemple, si le champ référencé a changé), la diffusion planifiée échoue et le propriétaire de la planification reçoit un message d'erreur indiquant qu'un filtre n'est pas valide.

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

Résoudre les erreurs à l'aide de l'outil de validation de contenu

L'outil de validation de contenu est utile pour rechercher et corriger les erreurs résultant de modifications de votre LookML. Par exemple, si vous remplacez le nom d'un champ customer par user, les tuiles Look ou Tableau de bord qui comprenaient le champ customer ne fonctionneront plus (sauf si vous avez utilisé le paramètre alias). L'outil de validation de contenu répertorie toutes les références au champ customer et fournit une méthode simple pour corriger l'erreur.

Lorsque vous exécutez l'outil de validation de contenu, il valide toutes les références que vos styles et tableaux de bord ont apportées à vos modèles, explorations, vues et champs LookML, et affiche une erreur pour toute référence effectuée 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. L'outil de validation de contenu est limité à vos autorisations. Ainsi, vous ne pouvez 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 liées aux modèles, consultez la page de la documentation Rôles.
  • look qui a été supprimé et qui se trouve dans la corbeille. Si vous souhaitez valider un style supprimé, votre administrateur Looker doit d'abord le restaurer.

Exécuter l'outil de validation de contenu

Lisez la section Avant d'utiliser l'outil de validation de contenu avant de continuer. L'outil de validation de contenu peut avoir un impact sur de nombreux aspects de votre contenu Looker. Il est donc important de planifier et d'envisager d'abord ce processus.

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

  1. Cliquez sur le bouton Valider.
  2. Cliquez sur les onglets Grouper par pour modifier la façon dont les erreurs sont regroupées :
    • Erreur: répertoriez chaque erreur et regroupez le contenu Looker concerné. Cela est utile si vous souhaitez corriger la même erreur dans plusieurs contenus à la fois.
    • Dossier: répertorie chaque dossier en regroupant le contenu Looker qui contient des erreurs. Cela est utile si vous souhaitez corriger uniquement les erreurs dans un dossier particulier.
    • Contenu: répertorie chaque élément de contenu comportant des erreurs, en regroupant les erreurs correspondantes. C'est utile si vous souhaitez corriger toutes les erreurs dans un seul look, une seule tuile, un seul filtre, etc.
  3. Si vous êtes en mode développement, il est important de comprendre ce qui se passe lorsque vous modifiez les styles et les cartes. Si vous les "corrigez" avant de publier vos modifications destructives, il s'agira d'un certain temps avant que la correction ne soit trop rapide. Looker affiche un message d'avertissement pour vous en souvenir.
  4. Le tableau d'erreurs affiche les erreurs, ainsi que la liste des styles et des tuiles qui contiennent l'erreur, ainsi que le modèle sous-jacent et la fonctionnalité Explorer qui génèrent l'erreur. Vous pouvez utiliser les onglets Regrouper par en haut à droite de la page pour modifier la mise en page du tableau d'erreurs.
  5. Looker fournit des boutons Remplacer et/ou Supprimer pour chaque ligne, en fonction du type d'erreur. Ces boutons fournissent des fonctionnalités permettant de corriger les erreurs. Ils sont décrits plus en détail ci-dessous.

Afficher les résultats de la validation de contenu

Les résultats de la validation de contenu affichent du contenu Looker qui utilise des noms de modèles, des noms à explorer, des noms de vues ou des noms de champs introuvables ou introuvables. Pour en savoir plus sur les éléments LookML que l'outil de validation de contenu peut rechercher et valider, consultez la section Utiliser l'outil de validation de contenu pour corriger les erreurs.

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

  • : bloc de tableau de bord
  • : alerte du tableau de bord
  • : planifier la création d'un tableau de bord ou d'un aperçu
  • : filtrez un tableau de bord ou un champ d'une carte qui écoute un filtre de tableau de bord. Pour en savoir plus sur la configuration des tuiles pour écouter les filtres de tableau de bord, consultez la page Ajouter et modifier des filtres de tableau de bord définis par l'utilisateur.

Les résultats de la validation sont basés sur le 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 validation reflètent tous les LookML envoyés en production. Si vous êtes en mode développement, les résultats de validation refléteront votre LookML enregistré, même s'il n'a pas été envoyé en production.

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

Pour ajuster les erreurs, utilisez les boutons sur chaque ligne du tableau d'erreurs:

Looker fournit le bouton Remplacer pour chaque erreur (consultez la section Remplacer les noms des champs, des vues, des explorations et des modèles ci-dessous pour savoir comment remplacer les noms avec l'outil de validation de contenu). Pour les erreurs liées aux noms de champs dans la section Données d'un look ou d'une carte, Looker affiche également le bouton Supprimer. Pour savoir comment supprimer des noms avec l'outil de validation de contenu, consultez la section Supprimer un nom de champ ci-dessous.

En fonction du paramètre Grouper par, les boutons s'appliquent à un seul élément (Regarder ou carrelage) ou à plusieurs éléments:

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

Voici un exemple de tableau regroupé par Error (Erreur). Les boutons ont donc toutes les instances de l'erreur:

Dans cet exemple, le tableau est regroupé par Content. Les boutons ne concernent qu'une seule instance de l'erreur sur un seul élément de contenu:

De plus, si vous effectuez un regroupement par Contenu, vous pouvez également supprimer des styles.

Remplacer le nom des champs, des vues, des explorations et des modèles

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

Pour ces erreurs, vous pouvez utiliser l'outil de validation de contenu afin de remplacer un attribut du contenu qui est égal ou plus général que l'attribut erroné:

  • Si un champ comporte des erreurs, vous pouvez remplacer/supprimer le champ, ou remplacer le nom de la vue, de l'exploration ou du modèle.
  • Si un nom d'exploration contient une erreur, vous pouvez le remplacer ou remplacer le nom du modèle.
  • Si un nom de modèle comporte des erreurs, vous pouvez le remplacer.

Pour utiliser le programme de validation de contenu afin de remplacer les noms des éléments dans votre modèle, procédez comme suit:

  1. Cliquez sur Valider pour exécuter l'outil de validation de contenu.
  2. Cliquez sur un paramètre Grouper par pour choisir comment les erreurs sont regroupées. Dans cet exemple, nous regroupons les données par Erreur afin de pouvoir ajuster plusieurs éléments en même temps.

  3. Dans le tableau des erreurs, cliquez sur le bouton Remplacer à côté de l'erreur que vous souhaitez corriger.

  4. Dans la boîte de dialogue, 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. Vérifiez le nom de l'élément à remplacer. L'outil de validation de contenu le remplit automatiquement.

  6. Saisissez le nouveau nom de l'élément.

  7. Si des messages ont été regroupés par Erreur et que plusieurs articles sont concernés, vous pouvez cliquer sur Afficher les contenus pour consulter la liste des articles mis à jour par l'outil de validation de contenu.

  8. Vous pouvez éventuellement décocher les cases des éléments de la liste pour ne pas modifier leur nom.

  9. Cliquez sur le bouton Remplacer pour effectuer la modification.

Supprimer un nom de champ

Pour les erreurs de 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 l'outil de validation de contenu pour supprimer les champs suivants:

  • Dans la section Données d'une section "Look" ou "Dashboard"
  • Références dans les configurations de visualisation, telles que la zone Personnalisations de l'onglet Série pour les graphiques à colonnes
  • Référencé par une tuile de tableau de bord pour écouter un filtre de tableau de bord (configuré dans l'onglet Tiles to Update de la fenêtre de configuration de 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 des filtres personnalisés, des champs personnalisés ni des calculs de tableau, car vous devez généralement effectuer des modifications supplémentaires pour que l'expression continue de fonctionner. Utilisez plutôt les messages d'erreur de validation de contenu pour identifier 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, le cas échéant.

  1. Cliquez sur Valider pour exécuter l'outil de validation de contenu.
  2. Cliquez sur un paramètre Grouper par pour choisir comment les erreurs sont regroupées. Dans cet exemple, nous regroupons les données par Erreur afin de pouvoir ajuster simultanément plusieurs éléments (looks, tuiles, ou les deux).

  3. Dans le tableau des erreurs, cliquez sur le bouton Supprimer à côté de l'erreur de champ que vous souhaitez corriger.

  4. Vérifiez le nom de l'élément à supprimer. L'outil de validation de contenu le remplit automatiquement.

  5. Si vos données sont regroupées par erreur et que vous avez plusieurs éléments (looks, tuiles, ou les deux), cliquez sur Afficher le contenu pour afficher la liste des éléments mis à jour par le programme de validation de contenu.

  6. Si vous le souhaitez, vous pouvez décocher les cases à côté des looks ou des cartes pour ne pas changer leur nom.

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

Suppression de présentations

Si vous regroupez le tableau d'erreurs par Contenu, vous pouvez supprimer les styles dans le tableau.

Pour supprimer des styles dans l'outil de validation 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 des erreurs, cochez la case Sélectionner à côté du style ou des styles que vous souhaitez supprimer.
  4. Cliquez sur Supprimer tous les styles sélectionnés.
  5. Cliquez sur OK dans la boîte de dialogue de confirmation pour supprimer le ou les styles sélectionnés.

Si vous supprimez accidentellement un Look, votre administrateur Looker peut être en mesure de le récupérer pour vous. Looker stocke le contenu supprimé dans la corbeille jusqu'à ce que votre équipe d'administrateurs Looker vide la corbeille dans le cadre de son 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 des noms de modèles, d'explorations et de champs. Par exemple, vous pouvez décider de remplacer un champ par un autre et d'effectuer le remplacement dans votre projet, même si aucune erreur n'est détectée. Vous trouverez la liste complète des éléments que l'outil de validation de contenu peut rechercher/remplacer dans la section Remplacer les noms des champs, des vues, des explorations et des modèles ci-dessus.

Lisez la section Avant d'utiliser l'outil de validation de contenu avant de continuer. L'outil de validation de contenu peut avoir un impact sur de nombreux aspects de votre contenu Looker. Il est donc important de planifier et d'envisager d'abord ce processus.

Pour utiliser l'outil de validation de contenu comme outil de recherche et de remplacement:

  1. Sur l'écran du programme de validation de contenu, cliquez sur Rechercher et remplacer dans tout 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 le bouton Remplacer pour effectuer la modification.

Éléments à prendre en compte

Planifiez à nouveau la validation du contenu pour afficher les résultats des corrections que vous apportez.

Remarques concernant l'outil de validation de contenu:

  • Pour les vues, les explorations ou les modèles, vous pouvez modifier leur nom, mais pas les supprimer entièrement. Consultez la section Supprimer un nom de champ pour connaître la liste des éléments que vous pouvez supprimer à l'aide de l'outil de validation de contenu.
  • Les calculs de tables ne peuvent référencer que les champs inclus dans la requête d'un look ou d'une carte. Cela signifie que si vous supprimez un champ d'une requête d'une apparence ou d'une carte, mais qu'un calcul de tableau utilise toujours ce champ, vous obtenez une nouvelle erreur de validation de contenu.
  • Les looks supprimés qui se trouvent sur la page Corbeille ne seront pas validés. Si vous souhaitez valider un style supprimé, votre administrateur Looker doit d'abord le restaurer.
  • Si vous êtes en mode développement, les résultats de validation reflètent votre LookML enregistré, même s'il n'a pas été envoyé en production. Cependant, toute modification apportée à l'aide de l'outil de validation de contenu s'applique aux utilisateurs qui consultent du contenu en mode production. Envisagez de passer en mode production avant d'exécuter l'outil de validation de contenu.