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 vues ou d'explorations, consultez la page de documentation Utiliser le planificateur Looker pour fournir 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 manière dont votre administrateur Looker a configuré vos autorisations pour l'envoi de données, vous pouvez peut-être envoyer votre contenu à une ou plusieurs des destinations d'envoi natives de Looker :

• E-mail
• Webhook
• Bucket Amazon S3
• Serveur SFTP

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

Si des résultats valides sont disponibles dans le cache, Looker enverra 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

Remarque : Si vous êtes développeur Looker, vous devez désactiver le mode développement pour planifier ou envoyer des rapports. Les livraisons sont exécutées avec LookML en mode Production.

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, puis choisissez Planifier l'envoi. Si l'option Planifier un envoi ne s'affiche pas, demandez à votre administrateur Looker quelles sont les autorisations qui vous ont été attribuées.

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

Fenêtre des planifications existantes

Si vous avez déjà créé des planifications pour ce tableau de bord, une fenêtre de planifications existantes s'affiche. Cette fenêtre affiche les plannings que vous avez définis, ainsi que des informations sur chacun d'eux, telles que leur destination et leur format. Les envois associés à la récurrence Envoyer et les plannings créés par d'autres personnes ne s'affichent pas dans cette fenêtre.

Vous pouvez effectuer les opérations suivantes dans la fenêtre des calendriers existants :

• 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 fermer la fenêtre.

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

Fenêtre de planification et d'envoi

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

Dans l'onglet Paramètres de la fenêtre de planification et d'envoi, vous pouvez personnaliser la récurrence, la destination, le format et d'autres paramètres d'envoi.

Lancement d'un envoi à partir d'un dossier

Vous pouvez également lancer l'envoi d'un tableau de bord à partir du dossier dans lequel il se trouve.

Sélectionnez Planifier l'envoi dans le menu à trois points situé à droite de la ligne de ce 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 figure en haut de la fenêtre de planification et d'envoi. Le nom attribué par défaut est le nom du tableau de bord. Pour modifier le nom de l'envoi, sélectionnez le nom (indiqué par le trait de soulignement en pointillés), puis apportez les modifications souhaitées.

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

• Pour les envois par e-mail, cet intitulé est utilisé en objet de l'e-mail et, si vous sélectionnez un format utilisant une pièce jointe, fait partie du nom du fichier.
• Pour les webhooks, cet intitulé figure dans la charge utile du webhook, dans le champ Title (Titre).
• 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 la diffusion se présente sous la forme TITLE_TIMESTAMP_HASH, où HASH est un identifiant aléatoire à six caractères et TIMESTAMP suit le format YYYY-MM-DDTHHMM (par exemple, la partie du code temporel se présente sous la forme 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 la diffusion se présente sous la forme TITLE_TIMESTAMP_HASH, où HASH est un identifiant aléatoire à six caractères et TIMESTAMP suit le format YYYY-MM-DDTHHMM (par exemple, la partie du code temporel se présente sous la forme 2019-05-31T0933 pour le 31 mai 2019 à 9h33). Le fuseau horaire de l'horodatage correspond au 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 la cadence d'envoi dans la section Périodicité.

Envoyer maintenant

Si vous sélectionnez Envoyer maintenant dans le menu déroulant Récurrence, le tableau de bord est envoyé une seule fois après 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 incluent une heure de début et une heure de fin. Looker enverra la diffusion 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 planifications par heure et par minute se répètent tous les jours pendant la période de début et de fin que vous avez définie. L'heure de fin des intervalles Toutes les heures et Minutes n'est pas incluse. 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 minuit à 22h00. Si une récurrence a lieu toutes les 30 minutes entre minuit et 23 h 00, la dernière livraison est envoyée à 22 h 30.

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 après qu'un groupe de données a été déclenché, géré le cache et reconstruit les tables PDT pertinentes.

Sélectionnez Mise à jour du groupe de données dans le menu déroulant Récurrence. Un champ Groupe de données accompagné d'un menu déroulant s'affiche. Sélectionnez le groupe de données dont la mise à jour doit déclencher l'envoi.

Pour planifier un tableau de bord à l'aide d'un déclencheur de mise à jour du 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 si les groupes de données 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 est utilisé dans un seul modèle de vignette, l'ensemble du tableau de bord sera envoyé une fois la mise à jour du groupe de données sélectionnée terminée.

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

Remarque : Selon la manière dont votre administrateur Looker a configuré vos autorisations, il est possible que certaines options de destination ne soient pas visibles.

Le paramètre Destination peut afficher plusieurs destinations possibles pour les envois de tableaux 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 informations spécifiques sur cette destination, telles 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 vous sélectionnez E-mail dans le champ Destination, un nouveau champ Adresses e-mail s'affiche. Champ obligatoire.

Saisissez les adresses e-mail des destinataires dans le champ Adresses e-mail. Si vous saisissez plusieurs adresses e-mail, appuyez sur 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 ont été attribuées, vous pourrez peut-être envoyer des e-mails à des adresses e-mail qui ne sont associées à aucun compte utilisateur sur votre instance Looker. Ces e-mails sont classés comme provenant d'utilisateurs externes. Les indicateurs Tous et Externes situés à droite du champ indiquent à la fois le nombre de destinataires de tous les e-mails et le nombre de destinataires des e-mails externes uniquement. Sélectionnez chaque indicateur pour afficher uniquement les destinataires d'e-mails externes ou tous les destinataires d'e-mails. 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 destinataires à la liste d'autorisation des domaines de messagerie pour les contenus programmés.

Si un destinataire est un autre utilisateur Looker, l'e-mail contiendra un lien vers le tableau de bord, sauf si votre administrateur Looker a défini la règle de données envoyées par e-mail de votre instance Looker sur Envoyer uniquement des données ou si l'option Inclure des liens est désélectionnée.

Les envois par e-mail ne doivent pas dépasser 20 Mo (pour les formats envoyé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 tel que Zapier, les webhooks permettent de transmettre les données Looker à un large éventail d'applications. Par exemple, vous pouvez programmer 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 envoyer les données. Consultez le post de la communauté Programmer 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 webhook de Looker.

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

Saisissez l'URL à laquelle Looker doit adresser une demande HTTPS pour cet envoi dans le champ URL du webhook. Vous pouvez obtenir cette URL auprès du service Web que vous utilisez pour gérer votre webhook.

Remarque :Looker tentera d'envoyer le message à un webhook pendant 30 minutes maximum. Assurez-vous que la destination peut répondre à la tentative d'envoi du webhook dans un délai de 30 minutes.

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. Champ obligatoire.
• Chemin facultatif : dossier dans lequel vous souhaitez enregistrer vos données, le cas échéant.
• Clé d'accès : ID de la clé d'accès à votre bucket S3, fourni par Amazon. Champ obligatoire.
• Secret Key: clé d'accès secrète à votre bucket S3, fournie par Amazon. Champ obligatoire.
• Région: région des services Amazon dans lesquels votre bucket S3 est hébergé.

Consultez le post destiné à la communauté concernant la programmation (illimité) des résultats sur S3 pour en savoir plus sur l'envoi de données à l'aide d'un paquet 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.

Remarque : Pour recevoir des envois SFTP de la part de Looker, assurez-vous que votre administrateur réseau a ajouté les adresses IP de Looker à la liste d'autorisation d'adresses IP ou aux règles de trafic entrant de votre serveur SFTP.

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

• Adresse : URL ou adresse IP du serveur SFTP auquel vous souhaitez envoyer vos données. Champ obligatoire. Exemple :

  • sftp://files.looker.com/Marketing/In/
  • sftp://192.168.0.10/Marketing/In/
  Remarque : Cet exemple d'URL se termine par le caractère /. Cela indique que le fichier sera enregistré dans un dossier nommé In. Si vous omettez le / à la fin, le fichier sera enregistré dans le dossier Marketing et "In" sera ajouté au nom du fichier. Vous devez disposer d'un accès en écriture au dossier dans lequel vous souhaitez créer le fichier.

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

• Algorithme d'échange de clés préféré: 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 Par défaut, l'ordre d'origine des algorithmes dans la bibliothèque de connexion 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 des empreintes SFTP pour 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.

Remarque :Si l'erreur Java::JavaLang::NullPointerExceptions s'affiche lors de l'envoi de données à un serveur SFTP, consultez la note dans la section Options d'envoi pour les serveurs SFTP de la page de documentation sur la diffusion de Looks et d'explorations pour résoudre cette erreur Java.

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 autoriser les utilisateurs et intégrer les utilisateurs à 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 apparaître et vous inviter à saisir des informations.

La liste suivante indique 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 affichées dans la colonne Lien vers le fichier README fournissent des instructions sur l'activation et la configuration du service intégré afin qu'il fonctionne avec Looker.
• Les URL affichées dans la colonne How to use this integration (Utiliser cette intégration) fournissent des instructions pour envoyer des données de Looker au service intégré. Certains de ces articles contiennent également des instructions d'activation.
• L'onglet Balises LookML obligatoires liste toutes les balises obligatoires qui doivent être utilisées avec le paramètre tags dans le modèle sous-jacent du contenu.
• 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 une table de données. Une action au niveau d'une requête envoie les résultats d'une requête entière, comme toutes les lignes d'une exploration ou d'une présentation. Une action au niveau d'un tableau de bord envoie l'image d'un tableau de bord.
• Utilise l'authentification Google OAuth indique si le service intégré utilise des identifiants Google OAuth pour l'authentification.
• Utilise le streaming de données indique si le service intégré est compatible avec les résultats de requêtes en streaming. Les tableaux de bord ne peuvent pas diffuser de données en flux continu.

Service intégré	Description	Lien vers le fichier README	Utiliser cette intégration	Balises LookML obligatoires	Utilise l'authentification Google OAuth (oui/non)	Utilise le streaming 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é	Aucun	Non	Non
DigitalOcean Spaces	Envoyer et stocker un fichier de données dans DigitalOcean Storage	Consulter le fichier README sur GitHub	Afficher l'article de la communauté	Aucun	Non	Non
Dropbox	Envoyez et stockez un fichier de données sur Dropbox.	Aucun fichier README disponible	Consulter la documentation	Aucun	Oui	Non
Google Cloud Storage	Écrire des fichiers de données dans un bucket Google Cloud Storage	Consulter le fichier README sur GitHub	Afficher l'article de la communauté	Aucun	Non	Non
Google Drive	Envoyer des données à Google Drive	Aucun fichier README disponible	Consulter la documentation	Aucun	Oui	Non
SendGrid	Envoyez des données et planifiez l'envoi des résultats à une adresse e-mail à l'aide de l'API SendGrid.	Afficher le fichier README sur GitHub	Afficher l'article de la communauté	Aucun	Non	Non
Slack	Envoyez du contenu Looker dans des messages privés, des canaux publics et des canaux privés dans Slack à l'aide du protocole OAuth. Il est disponible pour les déploiements hébergés par Looker à partir de la version 6.24 et la fonctionnalité Liste d'autorisation d'adresses IP est désactivée.	Aucun fichier README disponible	Consulter la documentation	Aucun	Oui	Non
Pièce jointe Slack (jeton d'API)	Envoyez des données directement dans une chaîne Slack avec des identifiants utilisateur. Vous pouvez également consulter la documentation Lookerbot pour découvrir d'autres fonctionnalités Slack.	Afficher le fichier README sur GitHub	Consulter la documentation	Aucun	Non	Non
Teams - Webhook entrant	Envoyez des données à Microsoft Teams à l'aide d'un webhook entrant.	Consulter le fichier README sur GitHub	Voir le fichier README	Aucun	Non	Non

Format

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

• Fichier CSV ZIP: 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 compressé. Pour les envois par e-mail, le fichier ZIP est envoyé comme pièce jointe.
• PDF: une image du tableau de bord sous forme de fichier PDF unique. La disposition par défaut affiche les vignettes telles qu'elles sont disposées dans le tableau de bord, mais d'autres options de disposition et de dimensionnement sont disponibles sous Options avancées. Pour les envois par e-mail, le fichier est envoyé comme pièce jointe.
• Visualisation au format PNG : image du tableau de bord sous forme de fichier PNG unique. La disposition par défaut affiche les vignettes 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.

Remarque : Si vous avez sélectionné l'adresse e-mail comme destination et que votre administrateur Looker a défini la règle de données par e-mail de votre instance Looker sur Envoyer un lien uniquement, l'option permettant de sélectionner un format de données n'est pas disponible.

Options avancées

L'onglet Options avancées permet de personnaliser davantage la diffusion. 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 d'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 de 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 la diffusion de contenu comme si chacun d'eux avait exécuté la requête, en fonction des autorisations de chacun. 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 envoi de données qui liste 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 programmation 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'incluent que les données concernant 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 le champ 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és dans le 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 l'indique le nombre Externe à côté de la liste des adresses e-mail:

   

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ésélectionnée ou que l'adresse e-mail externe n'est pas supprimée de la liste des destinataires.

Dans le cas particulier où un utilisateur est répertorié en tant que destinataire pour 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 à l'utilisateur désactivé dès sa prochaine exécution. Si le compte de cet utilisateur est supprimé, la planification n'est envoyée à aucun destinataire. Un administrateur ou un utilisateur Looker disposant de l'autorisation see_schedules pourra diagnostiquer cette erreur sur la page Historique du planificateur du panneau Administration.

Inclure les liens

Cette option est disponible uniquement pour les e-mails.

Si votre administrateur Looker a défini la règle concernant les données envoyées par e-mail de votre instance Looker sur Envoyer des liens et des données, l'option Inclure les liens s'affiche dans la fenêtre "Planifier et envoyer". Sélectionnez cette option pour insérer un lien Afficher le tableau de bord complet vers le tableau de bord Looker dans vos e-mails d'envoi de données. Les liens du tableau 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 concernant la diffusion de données, décochez la case Inclure des liens.

Inclure un lien personnalisé

Cette option n'est disponible que pour la destination e-mail et uniquement pour les tableaux de bord intégrés. Elle 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 le faire au tableau de bord dans Looker. Vous pouvez également modifier le texte du lien Afficher le tableau de bord complet (facultatif).

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 Intégrer du menu Administration.

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 l'option URL définie par l'utilisateur est sélectionnée dans le champ Sélectionner le chemin d'accès au contenu sur la page Intégrer du menu Administration.

Saisissez ici un chemin d'accès 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 un nouveau texte de lien, qui remplacera le texte Afficher le tableau de bord complet dans les envois d'e-mails. Par défaut, ce champ affiche tout texte saisi dans le champ Libellé de l'URL de la page Intégration du menu Administration. Vous pouvez le modifier dans ce champ.

Résultats

Ce champ n'est disponible que pour les formats de fichiers CSV zippés pour l'envoi de tableaux de bord. 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 application des options de visualisation pour appliquer certains paramètres de visualisation des vignettes du tableau de bord au tableau de bord que vous souhaitez envoyer. Les fichiers envoyés sont présentés sous forme de tableaux. Les paramètres suivants des menus Graphique, Séries et Mise en forme configurés pour une visualisation seront appliqués à l'envoi des données :

• Afficher les numéros de lignes
• Masquer les totaux
• Masquer les totaux des lignes
• Limiter les lignes affichées à 500 lignes maximum affichées ou masquées
• Afficher le nom complet du champ
• Libellés personnalisés pour chaque colonne

Choisissez l'option Tels qu'affichés dans le tableau de données pour envoyer les données telles qu'elles apparaissent dans le tableau de données de la fenêtre Explorer à partir d'ici de chaque carte du tableau de bord.

Values

Ce champ n'est disponible que pour les formats de fichiers CSV zippés pour l'envoi de tableaux de bord. Il contient deux options : Formaté ou Non formaté. 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 (comme l'association) ne soient pas compatibles avec tous les types de fichiers.
• Sélectionnez Non mises en forme si vous ne souhaitez pas appliquer de mise en forme particulière aux résultats de vos requêtes, comme l'arrondi des nombres longs ou l'ajout de caractères spéciaux éventuellement mis en place par les développeurs Looker. 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 des tableaux de bord envoyés.

Cochez la case Développer les tableaux pour afficher toutes les lignes pour afficher toutes les lignes de toutes les visualisations de tableaux du tableau de bord, et non seulement celles qui s'affichent dans les miniatures des cartes du tableau de bord.

Si l'option Développer les tableaux pour afficher toutes les lignes est sélectionnée, les cartes de tableau de bord contenant des visualisations de tableaux peuvent sembler légèrement différentes dans les PDF générés que dans Looker. Les différences suivantes peuvent être notables dans le PDF:

• Les personnalisations apportées aux couleurs d'arrière-plan et aux tailles de police sont supprimées des en-têtes de colonne et des lignes de sous-totaux.
• Les tableaux s'affichent dans le thème blanc.
• L'icône de tri ne s'affiche pas sur les tableaux croisés dynamiques qui n'ont pas été triés manuellement.
• Les tableaux pour lesquels l'option Redimensionner les colonnes pour les ajuster est activé sont étirés sur toute la largeur de la tuile.

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

• Les options de mise en forme conditionnelle autres que Couleur de l'arrière-plan ne s'affichent plus.
• Les visualisations de cellules sur les colonnes numériques n'apparaissent plus.

Si vous ne voyez pas l'option Développer les tables pour afficher toutes les lignes lorsque vous avez sélectionné PDF dans le champ Format, demandez à votre administrateur Looker d'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 dans 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 des tableaux de bord envoyés.

Vous avez la possibilité de spécifier la taille et l'orientation optimales des 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 ne s'affiche pas, demandez à votre administrateur Looker d'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 cartes du tableau de bord dans 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 :

• Normal : 800 pixels
• Large : 1 680 pixels

Pour les envois par e-mail, si vous sélectionnez Large et que la largeur de visualisation dépasse la limite définie par votre client de messagerie, les destinataires devront peut-être faire défiler la page horizontalement pour voir la visualisation dans son intégralité.

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 "Planification et envoi" affiche tous 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. Vous ne pouvez que consulter et modifier les valeurs des filtres existants du tableau de bord.

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

Si un filtre de tableau de bord nécessite une valeur, vous devez saisir une valeur dans l'onglet Filtres pour créer ou enregistrer des modifications apportées à l'envoi.

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 suivant 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 conserve la valeur définie dans l'onglet Filtres, même si elle correspond à est une valeur quelconque.
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. Ultérieurement, un nouveau filtre (non obligatoire ou obligatoire) est ajouté au tableau de bord.	Le filtre est appliqué aux données diffusées, en utilisant 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 étant n'importe quelle valeur, ce qui revient à supprimer le filtre.

Remarque : Les filtres de tableau de bord qui changent de nom ou qui sont supprimés d'un tableau de bord ne s'appliquent plus aux données envoyées. Les créateurs de planifications doivent donc avoir conscience que tout changement de nom ou toute suppression de filtre est susceptible d'entraîner l'envoi de données non filtrées.

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 pour un tableau de bord, vous pouvez créer un filtre de tableau de bord qui utilise 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. Il vous permet ainsi d'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 maintenant, 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 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 maintenant en bas de la fenêtre pour une livraison unique à la destination indiquée.

Si vous définissez le champ Récurrence sur une valeur autre que Envoyer maintenant, 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 de planifications existantes. Vos calendriers enregistrés pour tous les contenus s'affichent sur la page Programmes 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 Actions du tableau de bord à trois points en haut à droite du tableau de bord.
2. Sélectionnez Planifier la diffusion dans le menu déroulant.
3. Dans la fenêtre des planifications existantes, sélectionnez le menu à trois points qui s'applique à 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 lorsque vous avez terminé ou Annuler pour annuler les modifications.

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 Actions du tableau de bord à trois points en haut à droite du tableau de bord.
2. Sélectionnez Planifier la diffusion dans le menu déroulant.
3. Dans la fenêtre des planifications existantes, sélectionnez le menu à trois points qui s'applique à 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. "Copier" est ajouté au nom de la planification.
6. Apportez vos modifications.
7. Lorsque vos modifications sont terminées, sélectionnez Enregistrer ou Annuler pour les annuler et supprimer le calendrier dupliqué.

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

Les filtres d'une planification dupliquée seront définis aux mêmes valeurs que celles sélectionnées dans l'onglet Filtres de la planification d'origine, mais vous pourrez les modifier. Si des filtres ont changé depuis la création de la planification d'origine, ils seront affectés, comme indiqué dans la section En cas de changement des filtres d'un 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 plannings existants, sélectionnez le menu à trois points qui s'applique au planning 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 une programmation sur la page Programmations de votre profil utilisateur.

Problèmes de planification

Remarque : Looker planifie les envois de données en fonction du fuseau horaire indiqué dans le paramètre Fuseau horaire de l'application sur la page Paramètres de l'administrateur ou, le cas échéant, dans le paramètre Fuseau horaire spécifique à l'utilisateur du créateur de la 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 ce problème survient, Looker envoie un e-mail au créateur de la planification pour l'avertir. 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 voir, modifier, réattribuer et supprimer n'importe quel utilisateur programmations. 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 :

• Paramètres d'administration - Calendriers
• Paramètres administrateur : historique de planification
• Gérer les fonctionnalités Utilisateur métier
• Atelier : Afficher des tables longues