Planification et envoi de tableaux de bord

Cette page explique comment planifier et envoyer un tableau de bord. Pour en savoir plus sur la planification de Looks ou d'explorations, consultez la page de documentation Utiliser le planificateur Looker pour envoyer du contenu.

Looker vous permet de planifier l'envoi immédiat ou récurrent de tableaux de bord à l'aide de l'option de menu Planifier l'envoi du tableau de bord.

Selon la façon dont votre administrateur Looker a configuré vos autorisations pour la diffusion de données, vous pouvez envoyer votre contenu vers une ou plusieurs destinations d'envoi natives de Looker:

Vous pouvez également planifier l'envoi de données à un service tiers intégré à Looker, tel que Slack.

Si des résultats valides existent dans le cache, Looker fournit les résultats mis en cache. Si aucun résultat n'est disponible ou que les résultats mis en cache ont expiré, Looker exécutera à nouveau la requête et ces résultats seront mis en cache.

Lancement d'un envoi à partir d'un tableau de bord

Vérifiez que le tableau de bord n'est pas en mode Édition. Sélectionnez le menu à trois points Actions du tableau de bord en haut à droite du tableau de bord et choisissez Planifier l'envoi. Si l'option Planifier l'envoi ne s'affiche pas, contactez votre administrateur Looker pour connaître les autorisations qui vous ont été attribuées.

Lorsque vous sélectionnez Planifier l'envoi, une fenêtre de planifications existante s'affiche ou une fenêtre de planification et d'envoi s'affiche, selon que vous avez déjà créé des planifications existantes dans le tableau de bord ou non.

Fenêtre des planifications existantes

Si vous avez déjà créé des planifications pour ce tableau de bord, une fenêtre de planifications existante s'affiche. Cette fenêtre affiche les planifications que vous avez définies, ainsi que des informations sur chacune d'elles, telles que la destination et le format. Les envois qui utilisent la récurrence Envoyer maintenant et les calendriers créés par d'autres utilisateurs n'apparaissent pas dans cette fenêtre.

Fenêtre de planification existante affichant un envoi planifié de tableau de bord appelé "Analyse des commandes".

Vous pouvez effectuer les opérations suivantes dans la fenêtre de planifications existante:

  • Sélectionnez Envoyer maintenant pour envoyer immédiatement le contenu planifié existant sans perturber la cadence planifiée.

  • Sélectionnez le menu à trois points pour modifier, dupliquer ou supprimer une planification.

  • Sélectionnez OK pour quitter la fenêtre.

  • Sélectionnez Nouveau pour ouvrir la fenêtre de planification et d'envoi, puis créer une planification ou envoyer immédiatement un envoi.

Fenêtre de planification et d'envoi

Si vous sélectionnez Nouveau dans la fenêtre de planifications existantes, ou si vous ne disposez d'aucune planification préexistante pour le tableau de bord, une fenêtre de planification et d'envoi s'ouvre. Cette fenêtre vous permet de personnaliser la périodicité, la destination, le format, les filtres ainsi que d'autres aspects :

Fenêtre de planification et d'envoi affichant les options permettant de personnaliser le nom, la récurrence, la destination et le format d'un envoi de tableau de bord.

L'onglet Paramètres de la fenêtre de planification et d'envoi vous permet de personnaliser la périodicité, la destination, le format et d'autres paramètres d'envoi.

Lancement d'un envoi à partir d'un dossier

Vous pouvez également démarrer l'envoi d'un tableau de bord à partir du dossier où il se trouve.

Sélectionnez Planifier l'envoi dans le menu à trois points à droite de la ligne du tableau de bord (en mode Liste) ou dans le menu à trois points en haut à droite de la vignette (en mode Grille).

Appellation d'un envoi

Le nom attribué automatiquement à l'envoi s'affiche en haut de la fenêtre de planification et d'envoi. Le nom par défaut est celui du tableau de bord. Pour modifier le nom de la diffusion, sélectionnez le nom (indiqué par le trait de soulignement en pointillés), puis apportez vos modifications.

En fonction de la destination de votre envoi, la vignette peut également s'afficher à d'autres endroits :

  • Pour les envois par e-mail, le titre est utilisé en objet de l'e-mail et, si vous sélectionnez un format utilisant une pièce jointe, fait partie du nom de fichier.
  • Pour les webhooks, le titre est inclus dans la charge utile du webhook sous le champ Title.
  • Pour les envois à un paquet Amazon S3, l'intitulé est utilisé dans le nom du fichier d'envoi des données et, le cas échéant, dans les e-mails d'erreur qui vous sont adressés. Le nom de fichier de l'envoi respecte le format TITLE_TIMESTAMP_HASH, où HASH est un identifiant aléatoire à six caractères et TIMESTAMP suit le format YYYY-MM-DDTHHMM (par exemple, le code temporel se présente comme suit:2019-05-31T0933 pour le 31 mai 2019 à 9h33). Le fuseau horaire de l'horodatage correspond au fuseau horaire de livraison.
  • Pour les envois SFTP, l'intitulé figure dans le nom du fichier d'envoi. Le nom de fichier de l'envoi respecte le format TITLE_TIMESTAMP_HASH, où HASH est un identifiant aléatoire à six caractères et TIMESTAMP suit le format YYYY-MM-DDTHHMM (par exemple, le code temporel se présente comme suit:2019-05-31T0933 pour le 31 mai 2019 à 9h33). Le fuseau horaire de l'horodatage correspond à celui du fuseau horaire de livraison.
  • Pour les envois à des services intégrés qui génèrent une pièce jointe de fichier, l'intitulé figure dans le nom du fichier d'envoi.

Récurrence

Personnalisez le délai d'envoi dans la section Récurrence.

Envoyer maintenant

Si vous sélectionnez Envoyer maintenant dans le menu déroulant Récurrence, le tableau de bord vous est envoyé une seule fois une fois que vous avez rempli les champs obligatoires et sélectionné le bouton Envoyer maintenant en bas de la fenêtre.

Planifications en fonction de la date et de l'heure

Sélectionnez l'une des options suivantes dans le menu déroulant Récurrence:

  • Monthly (Tous les mois)
  • Weekly (Toutes les semaines)
  • Tous les jours
  • Toutes les heures
  • Minutes
  • Mois spécifiques
  • Jours spécifiques

Les options de périodicité changent en fonction de l'option que vous choisissez. Par exemple, les paramètres Toutes les heures comprennent une heure de début et une heure de fin. Looker enverra l'envoi toutes les heures entre l'heure de début et l'heure de fin.

Les champs Heure, Début et Fin utilisent une horloge au format 24 heures. Si l'heure souhaitée n'est pas disponible dans le menu déroulant, sélectionnez le champ et saisissez manuellement l'heure souhaitée, par exemple 9h15 ou 15h37.

Les calendriers à l'heure et en minutes se répètent quotidiennement sur les intervalles de début et de fin que vous avez définis. L'heure de fin des intervalles Toutes les heures et Minutes n'est pas inclusive. Le dernier envoi est effectué au dernier intervalle sélectionné avant l'heure de fin spécifiée. Par exemple, si un tableau de bord est planifié toutes les heures entre 00h00 et 23h00, il est envoyé toutes les heures, de 0h00 à 22h00. Si une récurrence a lieu toutes les 30 minutes entre 00h00 et 13h00, la dernière livraison est envoyée à 13h00.

Planifications déclenchées par des mises à jour de groupes de données

Si votre développeur LookML a configuré des groupes de données, vous pouvez planifier l'envoi d'un tableau de bord pour qu'il ait lieu après le déclenchement d'un groupe de données, la gestion du cache et la recréation des tables PDT pertinentes.

Sélectionnez Mise à jour du groupe de données dans le menu déroulant Récurrence. Le champ Groupe de données s'affiche avec un menu déroulant. Sélectionnez le groupe de données dont la mise à jour doit entraîner la diffusion.

Pour planifier un tableau de bord à l'aide d'un déclencheur de mise à jour de groupe de données, le tableau de bord doit contenir au moins une vignette basée sur un fichier de modèle incluant un paramètre de groupe de données. Le menu déroulant Groupe de données répertorie tous les groupes de données définis dans les modèles inclus dans le tableau de bord, même s'ils ne sont pas utilisés pour gérer la mise en cache des requêtes ou des tables PDT. Même si le groupe de données n'est utilisé que dans le modèle d'une seule vignette, l'intégralité du tableau de bord est envoyée à la fin de la mise à jour du groupe de données sélectionné.

Les planifications fondées sur des groupes de données sont envoyées uniquement au terme du processus de régénération de toutes les tables PDT liées à ce paramètre du groupe de données, et vous assurent que l'envoi contient les données les plus récentes.

Destination

Le paramètre Destination peut afficher plusieurs destinations possibles pour les envois du tableau de bord. Une fois que vous avez sélectionné une destination de données, un nouveau champ de paramètre s'affiche pour vous permettre d'ajouter des détails spécifiques sur cette destination, tels qu'une adresse e-mail ou une URL de webhook. Consultez les sections suivantes pour en savoir plus sur les paramètres de chaque destination.

E-mail

Lorsque l'option Adresse e-mail est sélectionnée dans le champ Destination, un nouveau champ Adresses e-mail s'affiche. Ce champ est obligatoire.

Saisissez les adresses e-mail des destinataires dans le champ Adresses e-mail. Si vous saisissez plusieurs adresses e-mail, sélectionnez la touche Entrée ou ajoutez une virgule après chaque adresse.

En fonction des paramètres de votre instance Looker et des autorisations qui vous sont attribuées, vous pouvez envoyer des e-mails à des adresses e-mail qui ne sont pas associées à un compte utilisateur sur votre instance Looker. Ces e-mails sont classés comme des e-mails externes. Les indicateurs Tous et Externe situés à droite du champ indiquent à la fois le nombre de destinataires de tous les e-mails et celui des destinataires externes. Sélectionnez chaque indicateur pour basculer entre l'affichage de tous les destinataires des e-mails et celui des destinataires externes uniquement. Pour que vous puissiez envoyer du contenu à des utilisateurs externes, votre administrateur Looker doit vous avoir autorisé à envoyer du contenu à des utilisateurs externes ou avoir ajouté les domaines de messagerie de ces destinataires à la liste d'autorisation des domaines de messagerie pour le contenu planifié.

Si le destinataire est un autre utilisateur Looker, l'option permettant de revenir au tableau de bord par e-mail lui sera proposée, sauf si votre administrateur Looker a défini la règle sur les données envoyées par e-mail de votre instance Looker sur Envoyer les données uniquement ou que l'option Inclure les liens est désélectionnée.

Les envois par e-mail ne doivent pas dépasser 20 Mo (pour les formats distribués dans le corps de l'e-mail) et 15 Mo (pour les formats envoyés en pièce jointe).

Consultez la section Options avancées de cette page pour en savoir plus sur les envois d'e-mails.

Webhook

Les webhooks permettent de déclencher des échanges entre des services Internet. Avec un service Web comme Zapier, les webhooks peuvent permettre aux données Looker d'être transmises à un large éventail d'applications. Par exemple, vous pouvez planifier l'envoi périodique d'un tableau de bord vers un webhook.

Pour configurer un webhook, accédez à votre service web et procédez comme suit :

  • Procurez-vous l'URL à laquelle Looker doit adresser une demande HTTPS.
  • Indiquez une application de destination pour envoyer vos données Looker. Il est possible que vous deviez la configurer pour recevoir des données de Looker.

La procédure exacte varie selon le service Web et l'application de destination que vous utilisez pour fournir les données. Consultez le post de la communauté Planifier des Looks et des tableaux de bord à l'aide de webhooks pour obtenir des instructions sur la configuration d'une autre application afin de recevoir les données du webhook à partir de Looker.

Lorsque l'option Webhook est sélectionnée dans le champ Destination, un nouveau champ URL du webhook s'affiche. Ce champ est obligatoire.

Saisissez l'URL à laquelle Looker doit envoyer une requête HTTPS pour cet envoi dans le champ URL du webhook. Vous pouvez obtenir cette URL à partir du service Web que vous utilisez pour gérer votre webhook.

Amazon S3

Les paquets Amazon S3 sont couramment utilisés pour stocker de grands volumes de données. Vous ou votre entreprise devrez créer un paquet S3 avec Amazon avant que Looker ne puisse l'utiliser.

Lorsque Amazon S3 est sélectionné dans le champ Destination, plusieurs nouveaux champs apparaissent et vous invitent à saisir des informations sur votre bucket Amazon S3:

  • Bucket: nom de votre paquet Amazon S3. Ce champ est obligatoire.
  • Optional Path: dossier dans lequel vous souhaitez enregistrer vos données, le cas échéant
  • Access Key (Clé d'accès) : ID de la clé d'accès à votre bucket S3, fourni par Amazon. Ce champ est obligatoire.
  • Clé secrète: la clé d'accès secrète à votre paquet S3, fournie par Amazon. Ce champ est obligatoire.
  • Region (Région) : région des services Amazon dans laquelle votre bucket S3 est hébergé.

Consultez le post destiné à la communauté concernant la planification (illimité) des résultats vers S3 pour en savoir plus sur l'envoi de données à l'aide d'un bucket Amazon S3.

SFTP

Il est recommandé d'envoyer des résultats à un serveur SFTP lorsque votre visualisation ou vos données sont trop volumineuses pour être envoyées par e-mail.

Lorsque SFTP est sélectionné dans le champ Destination, plusieurs nouveaux champs apparaissent et vous invitent à saisir des informations sur votre paquet Amazon S3:

  • Adresse: URL ou adresse IP du serveur SFTP vers lequel vous souhaitez envoyer vos données. Ce champ est obligatoire. Exemple :

    • sftp://files.looker.com/Marketing/In/
    • sftp://192.168.0.10/Marketing/In/

  • Nom d'utilisateur et Mot de passe: identifiants de connexion au serveur SFTP. Ces champs sont obligatoires.

  • Algorithme d'échange de clés souhaité: ce champ est facultatif. Pour le configurer, choisissez l'algorithme d'échange de clé SSH préféré pour établir la connexion. Si la connexion n'est pas établie dans les cinq minutes, choisissez un algorithme différent. Certains algorithmes prennent longtemps à générer une clé SSH. Cette option vous permet d'utiliser un algorithme susceptible de prendre moins de temps. Le choix d'un des algorithmes en fait l'algorithme préféré pour établir la connexion SSH. Si l'algorithme n'est pas pris en charge par le serveur, tous les autres algorithmes sont utilisés lors de tentatives ultérieures. Lorsque ce champ est défini sur Default, l'ordre d'origine des algorithmes dans la bibliothèque de connexions est utilisé.

La prise en charge des identifiants SFTP est limitée au nom d'utilisateur et au mot de passe. Les clés privées SSH ne sont pas reconnues comme identifiants.

Looker stocke les empreintes SFTP de votre serveur SFTP. Si vous rencontrez des erreurs lors de votre envoi de SFTP, les empreintes SFTP sont peut-être invalides. Dans ce cas, contactez votre administrateur Looker.

Destinations de service intégré

Vous pouvez planifier ou effectuer un envoi de tableau de bord à un service qui est intégré à Looker, tel que Slack, Dropbox, Google Drive ou autre. Les intégrations doivent être activées par votre administrateur Looker. Les administrateurs Looker doivent spécifiquement accorder des autorisations aux utilisateurs et aux utilisateurs intégrés pour envoyer et planifier des données à des intégrations tierces.

Lorsqu'un service intégré est sélectionné dans le champ Destination du planificateur, plusieurs nouveaux champs peuvent s'afficher et vous inviter à fournir des informations supplémentaires.

La liste suivante présente les services Looker Action Hub auxquels vous pouvez envoyer le contenu d'un tableau de bord.

Pour utiliser cette liste, procédez comme suit:

  • Les URL indiquées dans la colonne Lien vers le fichier README fournissent des instructions pour activer et configurer le service intégré afin qu'il fonctionne avec Looker.
  • Les URL affichées dans la colonne Comment utiliser cette intégration fournissent des instructions sur la manière d'envoyer des données depuis Looker au service intégré. Certains de ces articles contiennent également des instructions d'activation.
  • La section Balises LookML requises liste toutes les balises obligatoires à utiliser avec le paramètre tags dans le modèle sous-jacent du contenu.
  • Le type d'action indique le niveau de données envoyé par le service intégré: champ, requête ou tableau de bord. Une action au niveau du champ envoie la valeur d'une seule cellule spécifiée dans un tableau de données. Une action au niveau de la requête envoie les résultats d'une requête complète, comme toutes les lignes d'une exploration ou d'une présentation. Une action au niveau du tableau de bord envoie l'image d'un tableau de bord.
  • Utilise l'authentification Google OAuth indique si le service intégré utilise les identifiants Google OAuth pour l'authentification.
  • Utilise un flux de données : indique si le service intégré accepte les résultats de requête diffusés en continu. Les tableaux de bord ne peuvent pas diffuser de données.
Service intégré Description Lien vers le fichier README Utiliser cette intégration Balises LookML requises Utilise l'authentification Google OAuth (oui/non) Utilise un flux de données (oui/non)
Azure Storage Envoyer et stocker un fichier de données dans Azure Storage Consulter le fichier README sur GitHub Consulter l'article de la communauté Aucune Non Non
DigitalOcean Spaces Envoyez et stockez un fichier de données dans DigitalOcean Storage. Consulter le fichier README sur GitHub Consulter l'article de la communauté Aucune Non Non
Dropbox Envoyez et stockez un fichier de données sur Dropbox. Aucun fichier README disponible Consulter la documentation Aucune Oui Non
Google Cloud Storage Écrire des fichiers de données dans un bucket Google Cloud Storage Consulter le fichier README sur GitHub Consulter l'article de la communauté Aucune Non Non
Google Drive Envoyer des données à Google Drive Aucun fichier README disponible Consulter la documentation Aucune Oui Non
SendGrid Envoyez des données et planifiez l'envoi des résultats à une adresse e-mail à l'aide de l'API de SendGrid. Consulter le fichier README sur GitHub Consulter l'article de la communauté Aucune Non Non
Slack Envoyez du contenu Looker dans des messages privés, des canaux publics et des canaux privés dans Slack à l'aide d'OAuth. Elle est disponible pour les déploiements hébergés dans Looker à partir de la version 6.24, avec la fonctionnalité Liste d'autorisation d'adresses IP désactivée. Aucun fichier README disponible Consulter la documentation Aucune Oui Non
Pièce jointe Slack (jeton d'API) Envoyez des données directement vers une chaîne Slack avec les identifiants de l'utilisateur. Vous pouvez également consulter la documentation Lookerbot pour découvrir d'autres fonctionnalités de Slack. Consulter le fichier README sur GitHub Consulter la documentation Aucune Non Non
Équipes – Webhook entrant Envoyez des données à Microsoft Teams à l'aide d'un webhook entrant. Consulter le fichier README sur GitHub Consulter le fichier README Aucune Non Non

Format

Le champ Format contient un menu déroulant des formats disponibles:

  • Fichier CSV zippé: données non mises en forme du tableau de bord envoyées sous la forme d'un ensemble de fichiers CSV (valeurs séparées par des virgules) dans un répertoire zippé. Pour les envois par e-mail, le fichier ZIP est envoyé comme pièce jointe.
  • PDF: image du tableau de bord sous forme de fichier PDF unique. Par défaut, les vignettes sont affichées telles qu'elles sont disposées dans le tableau de bord, mais d'autres options de mise en page et de dimensionnement sont disponibles sous Options avancées. Pour les envois par e-mail, le fichier est envoyé comme pièce jointe.
  • Visualisation PNG: image du tableau de bord sous forme de fichier PNG unique. Par défaut, les vignettes sont affichées telles qu'elles sont disposées dans le tableau de bord, mais d'autres options de mise en page sont disponibles sous Options avancées. Pour les envois par e-mail, l'image s'affiche en ligne au sein du corps de l'e-mail.

Options avancées

L'onglet Options avancées vous permet de personnaliser davantage votre envoi. Les options disponibles dépendent de la destination sélectionnée et du format de votre envoi.

Message personnalisé

Cette option est disponible uniquement pour les e-mails.

Saisissez un message que vous souhaitez inclure dans le corps de l'e-mail envoyé aux destinataires. Looker limite le nombre de caractères dans un message personnalisé à 1 500.

Exécuter la programmation en tant que destinataire

Cette option est disponible uniquement pour les e-mails.

L'option Exécuter la planification en tant que destinataire permet aux utilisateurs de spécifier une liste de destinataires qui recevront chacun l'envoi du contenu comme si chacun d'eux avait exécuté la requête, en fonction des autorisations de chacun. Cela signifie que les filtres d'accès et les attributs utilisateur de chaque utilisateur seront appliqués aux données incluses dans chaque e-mail.

Si un utilisateur est un administrateur Looker, l'option Exécuter la planification en tant que destinataire permet à l'administrateur de spécifier une liste d'utilisateurs qui recevront chacun l'envoi du contenu comme si chacun d'eux avait exécuté la requête, en fonction des autorisations de chaque personne. Les utilisateurs non administrateurs peuvent également saisir leurs propres adresses e-mail pour recevoir un envoi comme s'ils avaient demandé le contenu, en fonction de leurs autorisations. Cela signifie que les filtres d'accès et les attributs utilisateur de chaque utilisateur seront appliqués aux données incluses dans chaque e-mail.

Dans l'exemple suivant, un administrateur Looker doit planifier un rapport listant le nombre d'utilisateurs par état.

Le filtre d'accès de l'utilisateur A est défini sur users.state = 'California'. Lorsque l'option Exécuter la planification en tant que destinataire est sélectionnée, la requête programmée applique le filtre d'accès users.state = 'California' et envoie les résultats filtrés à l'utilisateur A. Les résultats filtrés n'incluront que les données sur la Californie.

Dans l'onglet Options avancées, cochez la case Exécuter la planification en tant que destinataire, puis ajoutez les adresses e-mail de vos destinataires dans la zone de texte Adresses e-mail de l'onglet Paramètres. Cette option prend en compte les autorisations de l'utilisateur qui crée la planification, ainsi que les types d'adresses e-mail ajoutées au champ Adresses e-mail. Dans certains cas, l'option Exécuter la planification en tant que destinataire n'est pas disponible:

  1. Lorsqu'un utilisateur ajoute l'adresse e-mail d'un utilisateur désactivé

  2. Lorsqu'un utilisateur ajoute une adresse e-mail qui n'appartient pas à un utilisateur Looker, comme indiqué par le nombre d'adresses externes au-dessus de la liste des destinataires:

    Exemple de planification affichant le nombre d'adresses e-mail externes pour les destinataires qui ne sont pas des utilisateurs Looker.

Dans ces situations, que l'option ait été sélectionnée avant ou après la saisie de l'adresse e-mail externe, l'option Exécuter la planification en tant que destinataire reste activée, mais la planification ne peut pas être enregistrée tant que l'option Exécuter la planification en tant que destinataire n'est pas décochée ou que l'adresse e-mail externe n'est pas supprimée de la liste des destinataires.

Dans les cas particuliers où un utilisateur est répertorié en tant que destinataire selon une planification pour laquelle l'option Exécuter la planification en tant que destinataire est activée, et que le compte de cet utilisateur est désactivé, la planification ne sera pas envoyée à cet utilisateur lors de sa prochaine exécution. Si le compte de cet utilisateur est supprimé, la planification ne sera transmise à aucun destinataire. Un administrateur ou un utilisateur Looker disposant de l'autorisation see_schedules pourront diagnostiquer cet échec sur la page Historique du programmeur du panneau Administration.

Cette option est disponible uniquement pour les e-mails.

Si votre administrateur Looker a défini la règle sur les données envoyées par e-mail de votre instance Looker sur Envoyer des associations et des données, la fenêtre de planification et d'envoi affiche l'option Inclure des liens. Sélectionnez cette option pour inclure dans les e-mails d'envoi de données un lien Afficher le tableau de bord complet qui redirige vers le tableau de bord de Looker. Les liens des tableaux de bord n'incluent aucun paramètre hide_filter.

Les destinataires doivent se connecter à Looker et disposer des autorisations nécessaires pour accéder aux modèles sur lesquels le tableau de bord envoyé est basé pour pouvoir consulter ce contenu dans Looker. Si vous souhaitez supprimer ce lien de vos e-mails de diffusion de données, décochez la case Inclure les liens.

Cette option n'est disponible que pour la destination des e-mails et pour les tableaux de bord intégrés. Il s'affiche lorsque l'option Inclure des liens est sélectionnée.

L'option Inclure un lien personnalisé vous permet de configurer une URL personnalisée à laquelle le lien Afficher le tableau de bord complet se connectera, au lieu de créer un lien vers le tableau de bord dans Looker. Vous pouvez également modifier le texte du lien Afficher le tableau de bord complet.

Pour utiliser cette option, un administrateur Looker ou un utilisateur disposant de l'autorisation schedule_look_emails ou create_alerts doit d'abord spécifier les domaines autorisés pour le lien personnalisé, puis sélectionner le format de l'URL du lien personnalisé sur la page Embed (Intégrer) du menu Admin.

Domaine

Sélectionnez le domaine de l'URL dans la liste des domaines configurés dans la liste d'autorisation. Exemple :app.customer.com

Chemin d'accès

L'option Chemin ne s'affiche que si URL définie par l'utilisateur est sélectionnée dans le champ Sélectionnez un chemin d'accès au contenu de la page Intégrer du menu Admin.

Saisissez ici un chemin personnalisé pour l'URL du lien. Par exemple, si vous souhaitez que votre lien personnalisé pointe vers l'URL app.customer.com/my_embed_app, saisissez le chemin /my_embed_app ici.

Libellé pour l'URL

Utilisez ce champ pour saisir le nouveau texte du lien, qui remplacera le texte Afficher le tableau de bord complet dans les envois par e-mail. Par défaut, ce champ affiche le texte saisi dans le champ Libellé de l'URL sur la page Intégrer du menu Admin, et peut être modifié dans ce champ.

Résultats

Ce champ n'est disponible que pour les formats d'envoi de tableaux de bord sous forme de fichiers CSV ZIP. Il contient deux options: Avec les options de visualisation appliquées ou Comme affiché dans le tableau de données. Vous pouvez choisir l'une des deux options.

Choisissez l'option Avec les options de visualisation appliquées pour appliquer certains paramètres de visualisation des vignettes du tableau de bord à l'envoi de votre tableau de bord. Ainsi, les fichiers de votre diffusion ressemblent à des tableaux. Tous les paramètres suivants des menus Plot, Série et Mise en forme configurés pour une visualisation s'appliqueront à l'envoi des données:

Sélectionnez l'option Informations affichées dans le tableau de données pour afficher les données telles qu'elles apparaissent dans le tableau de données de la fenêtre Explorer à partir d'ici de chaque vignette du tableau de bord.

Valeurs

Ce champ n'est disponible que pour les formats d'envoi de tableaux de bord sous forme de fichiers CSV ZIP. Il comporte deux options: Avec mise en forme ou Sans mise en forme. Vous pouvez choisir l'une des deux options.

  • Sélectionnez Mise en forme si vous souhaitez que les données s'affichent de la même manière que dans l'expérience Explorer de Looker, bien que certaines fonctionnalités (telles que l'association) ne soient pas compatibles avec tous les types de fichiers.
  • Sélectionnez Sans mise en forme si vous ne souhaitez pas appliquer de mise en forme particulière aux résultats de votre requête (arrondir les nombres longs ou ajouter des caractères spéciaux, par exemple) que vos développeurs Looker ont peut-être mis en place. Cette façon de procéder est souvent préférable lorsque les données sont transmises à un autre outil de traitement.

Développer les tables pour afficher toutes les lignes

Cette option n'est disponible que pour les formats PDF d'envoi de tableaux de bord.

Sélectionnez la case Développer les tableaux pour afficher toutes les lignes pour afficher toutes les lignes des visualisations de tableau du tableau de bord, et pas seulement celles qui s'affichent sous forme de vignettes de vignettes.

Si l'option Développer les tables pour afficher toutes les lignes est sélectionnée, les vignettes du tableau de bord contenant des visualisations de table peuvent être légèrement différentes dans les PDF envoyés et dans Looker. Les différences suivantes peuvent être notables dans le PDF:

  • La personnalisation des couleurs d'arrière-plan et de la taille de police est supprimée des en-têtes de colonne et des lignes de sous-total.
  • Les tableaux s'affichent dans le thème blanc.
  • L'icône de tri ne s'affiche pas pour les tableaux croisés dynamiques qui n'ont pas été triés manuellement.
  • Les tables pour lesquelles l'option Adapter la taille des colonnes est activée s'étendent sur toute la largeur de la tuile.

En outre, pour les tableaux de plus de 20 000 cellules, les différences suivantes peuvent être perceptibles dans le PDF:

Si l'option Développer les tables pour afficher toutes les lignes n'apparaît pas lorsque vous avez sélectionné PDF dans le champ Format, contactez votre administrateur Looker pour installer la version appropriée du moteur de rendu Chromium pour votre instance Looker.

Disposer les vignettes du tableau de bord en une seule colonne

Cette option n'est disponible que pour les formats de visualisation PDF et PNG des tableaux de bord envoyés. Lorsque Slack est sélectionné comme destination de l’envoi, seul le format PDF est pris en charge.

Cochez la case Organiser les vignettes du tableau de bord en une seule colonne pour mettre en forme votre visualisation PDF ou PNG en une seule colonne. Avec cette option, les vignettes du tableau de bord s'affichent dans une seule colonne verticale. Ne la cochez pas si vous souhaitez afficher les vignettes telles qu'elles sont disposées dans le tableau de bord.

Format de papier

Cette option n'est disponible que pour les formats PDF d'envoi de tableaux de bord.

Vous avez la possibilité de spécifier la taille et l'orientation optimales des fichiers PDF du tableau de bord en les sélectionnant dans le menu déroulant Format de papier. Il est possible que vous deviez redimensionner les visualisations de grande taille ou les vignettes de tableau de bord qui se chevauchent afin qu'elles s'affichent correctement dans une page PDF. Si l'option Format de papier n'est pas affichée, contactez votre administrateur Looker pour installer la dernière version du moteur de rendu Chromium pour votre instance Looker.

Résolution de la table

Cette option n'est disponible que pour le format de visualisation PNG et lorsque la case Organiser les vignettes du tableau de bord en une seule colonne est cochée.

Vous pouvez personnaliser la largeur de votre visualisation à l'aide du menu déroulant Résolution du tableau. Vous disposez des options de largeur suivantes :

  • Normale: 800 pixels
  • Grand angle: 1 680 pixels

Pour les envois par e-mail, si vous choisissez Large et que la largeur de visualisation dépasse la limite définie par votre client de messagerie, les destinataires des e-mails devront peut-être faire défiler l'écran horizontalement pour voir la visualisation complète.

Fuseau horaire d'envoi

Par défaut, Looker utilise le fuseau horaire associé à votre compte pour déterminer à quel moment envoyer les données. Si aucun fuseau horaire n'est associé à votre compte, Looker utilise le paramètre Fuseau horaire de l'application.

Pour indiquer un autre fuseau horaire, sélectionnez-en un dans le menu déroulant. Le fuseau horaire sélectionné n'a aucune incidence sur les données de votre présentation ou de votre tableau de bord ; il détermine uniquement l'heure d'envoi.

Filtres

L'onglet Filtres de la fenêtre "Planifier et envoyer" affiche les filtres appliqués au tableau de bord, ainsi que leurs valeurs. Cet onglet vous permet de modifier les valeurs des filtres existants appliqués au tableau de bord et de saisir de nouvelles valeurs à appliquer à l'envoi. Les modifications n'ont aucune incidence sur le tableau de bord en lui-même.

Vous ne pouvez pas ajouter de filtres à votre planification dans l'onglet Filtres, mais uniquement afficher et modifier les valeurs des filtres de tableau de bord existants.

Par exemple, vous pouvez envoyer aux équipes régionales des résultats filtrés en fonction de leurs centres d'intérêt.

Si un filtre de tableau de bord requiert une valeur de filtre, vous devez saisir une valeur dans l'onglet Filtres pour créer ou enregistrer les modifications apportées à la diffusion.

En cas de changement des filtres d'un tableau de bord

Il arrive que les filtres d'un tableau de bord changent lors de la création d'une planification. Le tableau ci-dessous explique quelle incidence ces changements ont sur les filtres appliqués aux envois planifiés.

Action Incidence sur le filtre de planification
Une planification est créée avec un filtre. La valeur du filtre change ensuite dans le tableau de bord. Aucune incidence sur la valeur du filtre de la planification. Elle reste la valeur définie dans l'onglet Filtres, même si cette valeur est est une valeur.
Une planification est créée avec un filtre. Ultérieurement, le filtre est renommé dans le tableau de bord. Le filtre est supprimé des données envoyées.
Une planification est créée avec un filtre. Ultérieurement, le filtre est supprimé du tableau de bord. Le filtre est supprimé des données envoyées.
Une planification est créée. Par la suite, un nouveau filtre (non obligatoire ou obligatoire) est ajouté au tableau de bord. Le filtre est appliqué aux données envoyées à l'aide de la valeur de filtre définie dans l'onglet Filtres. Si aucune valeur n'est définie dans l'onglet Filtres, la valeur est interprétée comme est n'importe quelle valeur, ce qui entraîne la suppression du filtre.

Utilisation de filtres d'attributs utilisateur

Si votre administrateur Looker a configuré des valeurs spécifiques à l'utilisateur, appelées attributs utilisateur, et que vous disposez de droits de modification sur un tableau de bord, vous pouvez créer un filtre de tableau de bord utilisant l'option de filtre correspond à un attribut utilisateur. Ce type de filtre personnalise automatiquement la valeur de filtre en fonction de chaque personne qui consulte le tableau de bord. Grâce à ce type de filtre, vous pouvez envoyer des résultats personnalisés aux destinataires de chaque envoi. Pour en savoir plus sur les attributs utilisateur, consultez la page de documentation Attributs utilisateur.

Test d'une planification

Si vous définissez le champ Récurrence sur une valeur autre que Envoyer, un bouton Tester maintenant s'affiche en bas à gauche de la fenêtre de planification et d'envoi.

Sélectionnez le bouton Tester maintenant pour envoyer un envoi de test ponctuel du calendrier à vous-même uniquement. Une coche verte apparaît pour confirmer que l'e-mail de test a été envoyé.

Enregistrement d'une planification ou envoi immédiat

Si vous définissez le champ Récurrence sur Envoyer maintenant, sélectionnez le bouton Envoyer au bas de la fenêtre pour un envoi unique vers la destination indiquée.

Si vous définissez le champ Récurrence sur une valeur autre que Envoyer, sélectionnez le bouton Enregistrer pour enregistrer votre planification et fermer la fenêtre.

Sélectionnez le bouton Annuler pour quitter la fenêtre sans enregistrer ni envoyer la planification.

Les planifications enregistrées pour un tableau de bord s'affichent dans la fenêtre des planifications existantes. Vos calendriers enregistrés pour tous les contenus s'affichent sur la page Calendriers de votre profil utilisateur.

Modification d'une planification

Vous pouvez modifier uniquement les planifications que vous avez créées. Pour modifier une planification :

  1. Sélectionnez le menu à trois points Actions du tableau de bord en haut à droite du tableau de bord.
  2. Sélectionnez Planifier l'envoi dans le menu déroulant.
  3. Dans la fenêtre des planifications existantes, sélectionnez le menu à trois points correspondant à la planification que vous souhaitez modifier.
  4. Sélectionnez Modifier dans le menu déroulant.
  5. La fenêtre de planification et d'envoi correspondant à cette planification s'ouvre. Apportez vos modifications dans cette fenêtre.
  6. Sélectionnez Enregistrer une fois les modifications terminées ou Annuler pour les annuler.

Duplication d'une planification

Vous pouvez dupliquer une planification, puis la modifier si vous le souhaitez. Pour dupliquer une planification :

  1. Sélectionnez le menu à trois points Actions du tableau de bord en haut à droite du tableau de bord.
  2. Sélectionnez Planifier l'envoi dans le menu déroulant.
  3. Dans la fenêtre des planifications existantes, sélectionnez le menu à trois points correspondant à la planification que vous souhaitez modifier.
  4. Sélectionnez Dupliquer dans le menu déroulant.
  5. La fenêtre de planification et d'envoi correspondant à la planification dupliquée s'ouvre. La mention "Copy" (Copie) est ajoutée au nom du calendrier.
  6. Apportez vos modifications.
  7. Une fois vos modifications terminées, sélectionnez Enregistrer ou Annuler pour les annuler et supprimer le calendrier en double.

La duplication d'une planification n'a aucune incidence sur la planification d'origine.

Les filtres d'une planification en double seront définis sur les mêmes valeurs que celles de l'onglet Filtres de la planification d'origine, bien que vous puissiez les modifier. Si des filtres ont été modifiés depuis la création de la planification d'origine, ils seront affectés, comme indiqué dans la section En cas de modification des filtres du tableau de bord. Si un filtre obligatoire a été ajouté par la suite au tableau de bord sur lequel la planification d'origine est fondée, vous devez sélectionner une valeur pour ce filtre avant d'enregistrer la planification dupliquée.

Suppression d'une planification

Vous pouvez supprimer uniquement les planifications que vous avez créées. Pour supprimer une planification :

  1. Sélectionnez le menu à trois points en haut à droite du tableau de bord.
  2. Sélectionnez Planifier l'envoi dans le menu déroulant.
  3. Dans la fenêtre des planifications existantes, sélectionnez le menu à trois points correspondant à la planification que vous souhaitez modifier.
  4. Sélectionnez Supprimer dans le menu déroulant.
  5. Une nouvelle fenêtre s'ouvre. Sélectionnez Supprimer pour supprimer la planification ou Annuler pour la conserver.

Vous pouvez également supprimer un planning sur la page Calendriers de votre profil utilisateur.

Problèmes de planification

Il arrive qu'un envoi planifié ne parvienne pas à la totalité des destinataires prévus. C'est notamment le cas si le modèle sous-jacent comporte une erreur, si le destinataire n'a pas accès aux données, s'il existe des problèmes de rendu ou en présence d'erreurs au niveau des pages. La destination de données signale une erreur en cas de connexion impossible au point de terminaison spécifié.

Si de tels problèmes se produisent, Looker envoie un e-mail pour en avertir le créateur de la planification. L'e-mail contient un lien vers le contenu planifié, une liste des destinataires qui ne l'ont pas reçu, ainsi que d'autres informations, si disponibles, relatives au problème rencontré par Looker lors de la tentative de contact des destinataires.

Éléments à prendre en compte lors d'envois par les administrateurs

Les administrateurs Looker peuvent consulter, modifier, réattribuer et supprimer les plannings des utilisateurs. De plus, les administrateurs Looker doivent prendre certains éléments en compte lors de la configuration de l'envoi de données pour leur instance Looker et de l'octroi d'autorisations aux utilisateurs pour l'envoi ou la planification d'envois de données. Pour en savoir plus, rendez-vous sur les pages de documentation suivantes :