Planification et envoi de tableaux de bord

Cette page décrit le nouveau tableau de bord de Looker. Pour en savoir plus sur les anciens tableaux de bord, consultez la page de documentation Fournir d'anciens tableaux de bord. Pour déterminer le type de tableau de bord que vous utilisez, comparez les captures d'écran sur les pages de documentation Affichage des tableaux de bord et Affichage des anciens tableaux de bord.

Cette page explique comment planifier et envoyer un tableau de bord. Pour en savoir plus sur la planification des anciens tableaux de bord, looks ou explorations, consultez la page de documentation Utiliser le programmeur Looker pour diffuser du contenu.

Looker vous permet de programmer des envois immédiats ou récurrents de tableaux de bord à l'aide de l'option de menu Planifier la livraison.

En fonction de la manière dont votre administrateur Looker a configuré vos autorisations pour la livraison des données, vous pouvez envoyer votre contenu vers une ou plusieurs destinations de livraison natives de Looker:

Vous pouvez également planifier une livraison de données vers un service tiers intégré à Looker, tel que Slack.

S'il existe des résultats valides dans le cache, Looker renvoie 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

Si vous êtes un développeur Looker, vous devez désactiver le mode Développement pour planifier ou envoyer. Les diffusions sont exécutées à l'aide de LookML en mode production.

Assurez-vous que le tableau de bord n'est pas en mode Édition. Cliquez sur le menu à trois points en haut à droite du tableau de bord, puis sélectionnez Planifier l'envoi. Si vous ne voyez pas l'option Programmer la livraison, contactez votre administrateur Looker pour lui demander les autorisations qui vous sont attribuées:

Lorsque vous cliquez sur Programmer la livraison, une fenêtre de planification existante s'affiche, ou une fenêtre de planification et d'envoi s'affiche, selon que vous avez ou non déjà créé des planifications existantes 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 apparaît et affiche les planifications que vous avez définies, ainsi que des informations concernant chacune d'elles, telles que la destination et le format. Les diffusions effectuées à l'aide de la récurrence de l'option Envoyer maintenant et les planifications effectuées par d'autres personnes n'apparaissent pas dans cette fenêtre.

Cliquez sur Envoyer maintenant pour envoyer immédiatement le contenu programmé sans interrompre la fréquence prévue.

Cliquez sur le menu à trois points pour modifier, dupliquer ou supprimer une planification.

Cliquez sur OK pour quitter la fenêtre.

Cliquez sur Nouveau pour ouvrir le calendrier et envoyer la fenêtre, puis créez un calendrier ou envoyez immédiatement une nouvelle livraison.

Fenêtre de planification et d'envoi

Si vous cliquez sur Nouveau dans la fenêtre de planification existante ou que vous n'avez pas de planifications existantes 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 :

L'onglet Paramètres de la fenêtre "Planifier et envoyer" vous permet de personnaliser la récurrence, la destination, le format et d'autres options de livraison.

Lancement d'un envoi à partir d'un dossier

Vous pouvez également lancer la diffusion d'un tableau de bord à partir du dossier où il se trouve.

Sélectionnez Programmer la livraison 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 (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. Par défaut, le nom du tableau de bord est utilisé. Pour modifier le nom de la diffusion, cliquez sur le nom (indiqué par le trait de soulignement) et apportez les modifications suivantes:

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

  • Pour les e-mails, le titre est utilisé pour l'objet du message et dans le nom de fichier si vous sélectionnez un format incluant une pièce jointe.
  • Pour les webhooks, le titre 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 du code temporel associée au 31 mai 2019 à 9h33 serait 2019-05-31T0933).
  • 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 du code temporel associée au 31 mai 2019 à 9h33 serait 2019-05-31T0933).
  • 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 calendrier de diffusion dans la section Récurrence.

Envoyer maintenant

Si vous sélectionnez Envoyer dans le menu déroulant Récurrence, le tableau de bord vous est envoyé une seule fois lorsque vous remplissez les champs obligatoires. Cliquez ensuite sur le bouton Envoyer 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
  • Certains jours

Les options de périodicité changent en fonction de l'option que vous choisissez. Voici les paramètres Toutes les heures:

Les champs Heure, Début et Fin utilisent le format 24 heures. Si la période désirée n'est pas disponible dans le menu déroulant, cliquez dans le champ et saisissez manuellement la période souhaitée, comme 9h15 ou 15h37.

Les planifications Toutes les heures et Minutes se répètent tous les jours dans les intervalles de début et de fin que vous avez définis. L'heure de fin pour les intervalles de type Heure 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 programmé à Toutes les heures entre 0h et 23h, il est envoyé à l'heure, toutes les heures, de minuit à 22h. Si une récurrence a lieu toutes les 30 minutes entre 12h et 11h30, à 10h30, il est envoyé

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é, qu'il a géré le cache et qu'il a recompilé des 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 déclenchera l'envoi.

Pour planifier un tableau de bord à l'aide d'un déclencheur de mise à jour de groupe de données, il doit contenir au moins une tuile basée sur un fichier de modèle incluant un paramètre de groupe de données. Le menu déroulant Datagroup (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 PDT. Même si le groupe de données n'est utilisé que dans un modèle d'emplacement, l'ensemble du tableau de bord est envoyé à 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

Selon la manière dont votre administrateur Looker a configuré vos autorisations, certaines de ces destinations peuvent ne pas être visibles.

Le paramètre Destination peut afficher plusieurs options de destination pour les livraisons 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 à 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 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. Pour saisir plusieurs adresses e-mail, cliquez 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 sont attribuées, il est possible que vous puissiez envoyer des e-mails à des adresses e-mail qui ne sont pas associées à un compte utilisateur dans votre instance Looker. Ces e-mails sont alors considérés comme des e-mails externes. Les indicateurs Tous et Externe à droite du champ indiquent le nombre de tous les destinataires d'e-mails, ainsi que le nombre de destinataires externes uniquement. Cliquez sur chaque indicateur pour basculer entre l'affichage de tous les destinataires et uniquement celui des destinataires externes. Pour distribuer du contenu à des utilisateurs externes, votre administrateur Looker doit vous avoir autorisé à diffuser du contenu auprès des utilisateurs externes, ou avoir ajouté ces domaines de messagerie à la liste d'autorisation des domaines de messagerie pour le contenu planifié.

Si le destinataire est un autre utilisateur de Looker, il verra l'option permettant de revenir au tableau de bord à partir de l'e-mail, sauf si votre administrateur Looker a défini le Règlement sur les données par e-mail de votre instance Looker sur Envoyer des données uniquement 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 distribués dans le corps de l'e-mail) et 15 Mo (pour les formats envoyés en pièce jointe).

Pour en savoir plus sur la distribution des e-mails, consultez la section Options avancées de cette page.

Webhook

Les webhooks permettent de déclencher des échanges entre des services Internet. Avec un service Web tel que Zapier, les webhooks peuvent permettre la transmission des données Looker à un large éventail d'applications. Par exemple, vous pouvez planifier la livraison périodique d'un tableau de bord à 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 en fonction du service Web et de l'application de destination que vous utilisez pour fournir les données. Consultez cette rubrique de la communauté pour découvrir comment configurer une autre application afin de recevoir les données webhook de Looker.

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

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

Looker tente d'envoyer des données à un webhook pendant 30 minutes au maximum. Vous devez donc vous assurer que la destination peut réagir à 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 s'affichent et vous invitent à fournir des informations sur votre bucket Amazon S3:

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

Pour en savoir plus sur la diffusion de données à l'aide d'un bucket Amazon S3, consultez cet article de la communauté Looker.

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.

Pour recevoir des distributions SFTP 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 s'affichent et vous invitent à fournir des informations sur votre bucket Amazon S3:

  • Adresse: URL ou adresse IP du serveur SFTP auquel vous souhaitez envoyer vos données. Ce champ est obligatoire. Par exemple:
    sftp://files.looker.com/Marketing/In/
    ou
    sftp://192.168.0.10/Marketing/In/

    Cet exemple d'URL se termine par le caractère /. Cela signifie que le fichier sera enregistré dans un dossier nommé In. Si vous omettez la fin de /, le fichier sera enregistré dans le dossier Marketing. Le préfixe "In" sera ajouté au nom de fichier. Vous devez disposer d'un accès en écriture au dossier dans lequel vous voulez 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 de 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 digitales 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.

Si le message d'erreur Java::JavaLang::NullPointerExceptions s'affiche lors de l'envoi de données à un serveur SFTP, consultez l'article du centre d'aide expliquant comment traiter 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 accorder spécifiquement des autorisations aux utilisateurs et intégrer les utilisateurs pour envoyer et planifier des données à des intégrations tierces.

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

Pour en savoir plus sur la diffusion de données à partir d'intégrations, consultez la section Fournir des données sur le tableau de bord ou sur les requêtes de la page de documentation Partager des données via un hub d'action.

Pour obtenir la description des informations requises pour chaque service, recherchez votre destination dans la liste ci-dessous, puis cliquez sur le lien View Looker article (Afficher l'article Looker) dans la colonne How to Use This Destination (Comment utiliser cette destination).

Format

Le champ Format contient un menu déroulant répertoriant les formats disponibles:

  • Fichier ZIP CSV : données non formatées du tableau de bord, présentées sous la forme d'un ensemble de fichiers CSV (valeurs séparées par une virgule) 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 la forme d'un fichier PDF unique. La disposition par défaut affiche les tuiles 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 la forme d'un fichier PNG unique. La disposition par défaut affiche les tuiles 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.

Si vous avez sélectionné la messagerie comme destination et que votre administrateur Looker a défini le Règlement sur les 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 votre 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écution de la planification en tant que destinataire

Cette option est disponible uniquement pour les e-mails.

Si un utilisateur n'est pas un administrateur Looker, il ne peut afficher et cocher l'option Exécuter la planification en tant que destinataire que si son propre adresse e-mail est la seule enregistrée dans le champ Adresses e-mail de l'onglet Paramètres pour cette planification.

Si un utilisateur est un administrateur Looker, l'option Exécuter la planification en tant que destinataire lui permet de spécifier la liste des utilisateurs qui recevront chacun du contenu comme si chacun d'eux a 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 contenues dans chaque e-mail.

Par exemple, si un administrateur Looker doit planifier le rapport suivant à une série d'utilisateurs et que ces utilisateurs ont tous des valeurs de filtres d'accès différentes :

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 suivants à l'utilisateur A:

Dans l'onglet Options avancées, cochez la case Exécuter la planification en tant que destinataire, puis ajoutez les adresses e-mail des destinataires dans le champ 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 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 non administrateur ajoute une autre adresse e-mail que la sienne
  2. Lorsqu'un administrateur Looker ajoute l'adresse e-mail d'un utilisateur désactivé

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

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 le planning ne peut pas être enregistré tant que l'option Exécuter la planification en tant que destinataire n'est pas 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 dans une planification ayant le paramètre Exécuter la planification en tant que destinataire, puis dont le compte est désactivé, la planification ne sera pas livrée à l'utilisateur désactivé lors de sa prochaine exécution. Si le compte de cet utilisateur est supprimé, l'ensemble du calendrier ne sera pas envoyé aux destinataires. Un administrateur ou un utilisateur Looker disposant de l'autorisation see_schedules pourra diagnostiquer cette erreur sur la page Historique du programmeur du panneau Admin.

Cette option est disponible uniquement pour les e-mails.

Si votre administrateur Looker a défini le Règlement sur les données par e-mail de votre instance Looker sur Envoyer les liens et les données, la planification et la fenêtre d'envoi affichent l'option Inclure les liens. Sélectionnez cette option pour inclure dans les e-mails de diffusion des données un lien View full dashboard (Afficher le tableau de bord complet) qui permet d'accéder au tableau de bord dans Looker.

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 ne souhaitez plus recevoir d'e-mails sur la distribution de vos données, décochez la case Inclure des liens.

Résultats

Ce champ n'est disponible que pour les formats de diffusion de tableaux de bord au format ZIP CSV. Il contient deux options: Avec 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 à la diffusion de votre tableau de bord. Ainsi, les fichiers de votre importation ressemblent à des graphiques de tableau. L'un des paramètres suivants des menus Graphique, Série et Mise en forme configuré pour une visualisation sera appliqué à la diffusion des données:

Choisissez l'option Comme affiché dans le tableau de données pour importer les données telles qu'elles apparaissent dans le tableau de données de la fenêtre Explorer à partir de cet emplacement du tableau de bord.

Valeurs

Ce champ n'est disponible que pour les formats de diffusion de tableaux de bord au format ZIP CSV. Il contient deux options: Formaté ou Non formaté. Vous pouvez choisir l'une des deux options.

  • Sélectionnez Formaté si vous souhaitez que les données s'affichent de la même manière que dans Explorer dans Looker, même si certaines fonctionnalités (telles que l'association) ne sont pas compatibles avec tous les types de fichiers.
  • Sélectionnez Non formaté si vous ne souhaitez pas appliquer une mise en forme spéciale de vos résultats de requête, par exemple arrondir des nombres longs ou ajouter des caractères spéciaux, que vos développeurs Looker ont pu mettre en place. Cette option est souvent privilégiée lorsque les données sont introduites dans un autre outil à des fins de traitement.

Développer les tables pour afficher toutes les rangées

Cette option n'est disponible que pour les formats de tableaux de bord au format PDF.

Sélectionnez l'option Développer les tableaux pour afficher toutes les lignes pour afficher toutes les lignes des visualisations de tableau dans le tableau de bord, plutôt que uniquement les lignes qui figurent dans les vignettes des vignettes du tableau de bord.

Si l'option Expand tables to show all rows (Développer les tables pour afficher toutes les lignes) ne s'affiche pas lorsque vous avez choisi le PDF dans le champ Format, contactez votre administrateur Looker pour savoir comment installer la version appropriée du moteur de rendu Chromium pour votre instance Looker.

Si votre administrateur Looker a activé la fonctionnalité expérimentale Afficher les tables longues et que l'option Développer les tables pour afficher toutes les lignes est sélectionnée, les tuiles contenant des visualisations de table peuvent présenter une apparence légèrement différente dans les fichiers PDF distribués par rapport à Looker. Pour en savoir plus sur les différences, consultez la page Documentation sur les fonctionnalités expérimentales.

Placer les vignettes du tableau de bord dans une colonne unique

Cette option n'est disponible que pour les formats de visualisation au format PDF et PNG des livraisons 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 Réorganiser les vignettes du tableau de bord sur une seule colonne pour mettre en forme votre PDF ou votre visualisation PNG dans une mise en page à 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 de tableaux de bord au format PDF.

Vous pouvez spécifier la taille et l'orientation optimales des PDF du tableau de bord dans le menu déroulant Format du 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 Taille du papier, 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 Ré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 :

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

Pour les distributions d'e-mails, si vous sélectionnez Étendue et que la largeur de la 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 l'intégralité de la visualisation.

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 vous n'avez pas associé de fuseau horaire à 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 de planification et d'envoi contient 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 pouvez uniquement afficher et modifier les valeurs des filtres du tableau de bord existants.

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

Si un filtre de tableau de bord nécessiteune valeur de filtre, vous devez saisir une valeur dans l'onglet Filtres pour créer ou enregistrer les modifications de la livraison.

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. Il s'agit de la valeur définie dans l'onglet Filtres, même s'il s'agit de n'importe quelle 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 diffusées à l'aide de la valeur de filtre définie dans l'onglet Filtres. Si aucune valeur n'est définie dans l'onglet Filters (Filtres), la valeur est interprétée comme est une valeur, ce qui supprimera le filtre.


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 sur 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. Avec ce type de filtre, vous pouvez fournir des résultats personnalisés à chaque destinataire de la livraison. Pour en savoir plus sur les attributs utilisateur, consultez la page de documentation sur les 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 planification et de la fenêtre d'envoi.

Cliquez sur le bouton Tester pour recevoir la version test à un moment unique. 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, cliquez sur le bouton Envoyer maintenant au bas de la fenêtre pour une livraison ponctuelle vers la destination indiquée.

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

Cliquez sur 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 planification existante. Vos planifications enregistrées 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. Cliquez sur le menu trois points en haut à droite du tableau de bord.
  2. Sélectionnez Programmer la livraison dans le menu déroulant.
  3. Dans la fenêtre de planification existante, cliquez sur le menu à trois points correspondant à la programmation 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. Cliquez sur Enregistrer une fois les modifications terminées, ou sur 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. Cliquez sur le menu trois points en haut à droite du tableau de bord.
  2. Sélectionnez Programmer la livraison dans le menu déroulant.
  3. Dans la fenêtre de planification existante, cliquez sur le menu à trois points correspondant à la programmation 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 du planning.
  6. Apportez vos modifications.
  7. Une fois vos modifications terminées, cliquez sur Enregistrer ou sur 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, mais vous pouvez modifier ces valeurs. Si des filtres ont été modifiés depuis la création du calendrier d'origine, ils seront affectés comme indiqué dans la section 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. Cliquez sur le menu trois points en haut à droite du tableau de bord.
  2. Sélectionnez Programmer la livraison dans le menu déroulant.
  3. Dans la fenêtre de planification existante, cliquez sur le menu à trois points correspondant à la programmation que vous souhaitez modifier.
  4. Sélectionnez Supprimer dans le menu déroulant.
  5. Une nouvelle fenêtre s'ouvre. Cliquez sur Supprimer pour supprimer la planification ou sur Annuler pour la conserver.

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

Problèmes de planification

Looker planifie l'envoi des données en fonction du fuseau horaire indiqué dans le paramètre Application Time Zone (Fuseau horaire de l'application) de la page Admin des paramètres de l'administrateur ou, s'il est activé, dans le fuseau horaire propre à l'utilisateur du créateur de la programmation.

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 avertir le créateur du planning. 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éaffecter et supprimer les planifications 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 :