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 diffuser 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 la diffusion de données, vous pourrez peut-être diffuser votre contenu vers une ou plusieurs destinations de diffusion natives de Looker:

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

S'il existe des résultats valides 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 dans l'angle supérieur droit du tableau de bord, puis 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 existantes s'affiche ou une fenêtre de planification et d'envoi s'affiche, selon que vous avez déjà créé des plannings 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 existantes s'affiche. Cette fenêtre affiche les plannings que vous avez définis, ainsi que des informations sur chacun d'eux, comme leur destination et leur format. Les envois utilisant la récurrence Envoyer et les plannings créés par d'autres personnes ne s'affichent pas dans cette fenêtre.

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

Vous pouvez effectuer les opérations suivantes dans la fenêtre de planification 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 fermer la fenêtre.

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

Fenêtre de planification et d'envoi

Si vous sélectionnez Nouveau dans la fenêtre de planifications existantes, ou si aucune planification n'est 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 du tableau de bord.

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 où 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 par défaut est le nom du tableau de bord. Pour modifier le nom de l'envoi, sélectionnez-le (indiqué par le trait de soulignement en pointillé), 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, l'intitulé est utilisé dans l'objet de l'e-mail et dans le nom du fichier si vous sélectionnez un format qui utilise une pièce jointe.
  • Pour les webhooks, l'intitulé est inclus dans la charge utile du webhook, sous 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 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, la partie code temporel serait 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 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, la partie code temporel serait 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 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 renseigné 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 programmations Toutes les heures et Minutes se répètent quotidiennement pendant les périodes Début et Fin que vous avez définies. 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 minuit et 23h00, il est envoyé l'heure, toutes les heures, de minuit à 22h00. Si une récurrence a lieu toutes les 30 minutes entre minuit et 13h00, la dernière à 13h00 est alors la dernière

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. Un champ Datagroup (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 livraison.

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 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 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

Le paramètre Destination peut afficher plusieurs options de destination pour les diffusions 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 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 l'option E-mail est sélectionnée dans le champ Destination, un nouveau champ Adresses e-mail apparaît. 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 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 Externe à droite du champ indiquent le nombre total de destinataires d'e-mails et le nombre de destinataires 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 domaines de messagerie de ces destinataires à la liste d'autorisation des domaines de messagerie pour le contenu programmé.

Si le destinataire est un autre utilisateur de Looker, il verra l'option permettant de revenir au tableau de bord depuis l'e-mail, sauf si votre administrateur Looker a défini la règle relative aux données envoyées par e-mail pour votre instance Looker sur Envoyer les données uniquement ou si 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 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 d'envoyer 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 diffère selon le service Web et l'application de destination que vous utilisez pour diffuser 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é dans le champ Destination, un nouveau champ URL de webhook apparaît. Ce champ est obligatoire.

Dans le champ URL du webhook, saisissez l'URL à laquelle Looker doit envoyer une requête HTTPS pour cette diffusion. Vous pouvez obtenir cette URL auprès 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.

Lorsqu'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.
  • Chemin d'accès facultatif: le dossier dans lequel vous souhaitez enregistrer vos données, le cas échéant.
  • Access Key (Clé d'accès) : ID de clé d'accès fourni par Amazon à votre bucket S3. Ce champ est obligatoire.
  • Secret Key: clé d'accès secrète à votre bucket S3, fournie par Amazon. Ce champ est 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.

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 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/

  • 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 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 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 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 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 Utiliser cette intégration fournissent des instructions sur la manière d'envoyer des données de Looker au service intégré. Certains de ces articles contiennent également des instructions d'activation.
  • 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.
  • 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 d'un champ envoie la valeur d'une seule cellule spécifiée dans un tableau de données. Une action au niveau d'une 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 des identifiants Google OAuth pour l'authentification.
  • Utilise un flux de données : indique si le service intégré est compatible avec la diffusion des résultats de requête. Les tableaux de bord ne peuvent pas diffuser de données en flux continu.
Service intégré Description Lien vers le fichier README Comment utiliser cette intégration Balises LookML obligatoires Utilise l'authentification Google OAuth (Oui/Non) Utilise un flux de données (oui/non)
Azure Storage Envoyez et stockez un fichier de données sur Azure Storage. Consulter le fichier README sur GitHub Afficher l'article de la communauté Aucune Non Non
DigitalOcean Spaces Envoyez vers et stockez un fichier de données dans DigitalOcean Storage. Consulter le fichier README sur GitHub Afficher 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 Afficher 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 des résultats à envoyer à une adresse e-mail à l'aide de l'API SendGrid. Consulter le fichier README sur GitHub Afficher 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 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 Aucune Oui Non
Pièce jointe Slack (jeton d'API) Envoyez des données directement sur un canal Slack avec les identifiants de l'utilisateur. Vous pouvez également consulter la documentation Lookerbot pour en savoir plus sur les autres fonctionnalités Slack. Consulter le fichier README sur GitHub Consulter la documentation Aucune Non Non
Teams - 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 compressé: 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: 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 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.

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 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 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 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 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:

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

Dans ce cas, 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é, le calendrier ne sera envoyé à aucun destinataire. Un administrateur ou un utilisateur Looker disposant de l'autorisation see_schedules pourra diagnostiquer cet échec sur la page Scheduler History (Historique du planificateur) du panneau Admin.

Cette option est disponible uniquement pour les e-mails.

Si votre administrateur Looker a défini la règle relative aux 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 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 dans Looker. 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.

Cette option est disponible uniquement pour la destination des e-mails et uniquement pour les tableaux de bord incorporé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 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 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 d'accès ne s'affiche que si l'option URL définie par l'utilisateur est sélectionnée dans le champ Sélectionnez le chemin d'accès au contenu de la page Intégrer dans le menu Admin.

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

Ce champ vous permet de saisir le texte du nouveau lien qui remplacera le texte Afficher le tableau de bord complet dans les e-mails envoyés. Par défaut, ce champ affichera le texte saisi dans le champ Libellé d'URL de la page Intégrer dans le menu Admin. Il peut être modifié dans ce champ.

Résultats

Ce champ n'est disponible que pour les formats de fichiers ZIP CSV pour les envois 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.

Sélectionnez 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. Les fichiers inclus dans votre importation ressemblent alors à des tableaux. Tous les paramètres suivants configurés pour une visualisation dans les menus Trace, Série et Mise en forme sont appliqués à l'envoi des données:

Sélectionnez l'option Telle qu'affichée dans le tableau de données pour fournir les données telles qu'elles apparaissent dans la table 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 de fichiers ZIP CSV pour les envois de tableaux de bord. Il contient deux options: Avec mise en forme 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 Sans mise en forme si vous ne souhaitez pas appliquer de mise en forme spéciale pour les résultats de votre requête (par exemple, arrondir les nombres longs ou ajouter des caractères spéciaux) 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 des envois de tableaux de bord.

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

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:

  • 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:

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 envois de tableaux de bord. 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 envois de tableaux de bord.

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 vous ne voyez pas l'option Format de papier, 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 vignettes 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 :

  • Normale: 800 pixels
  • Grand angle: 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 requiert une valeur de filtre, vous devez en saisir une dans l'onglet Filtres afin de créer ou d'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 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. Par la suite, 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.

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. Ce type de filtre vous permet de fournir 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 planning 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 Planning 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.
  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 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. Lorsque vos modifications sont terminées, sélectionnez Enregistrer 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.
  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 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. "Copy" 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 en double seront définis sur les mêmes valeurs que celles présentes dans l'onglet Filtres de la planification d'origine, bien que vous puissiez modifier ces valeurs. Si des filtres ont été modifiés depuis la création de la planification d'origine, ils sont affectés, comme indiqué dans la section 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 qui s'applique à 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 Planning 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 informer 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 de n'importe quel utilisateur. 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 :