Distribution de tableaux de bord hérités

Cette page concerne la diffusion de contenu provenant d'anciens tableaux de bord. Les tableaux de bord s'affichent dans l'ancien format uniquement si l'ancienne fonctionnalité Utiliser les anciens tableaux de bord est activée sur votre instance Looker. Pour en savoir plus sur la planification des tableaux de bord de la nouvelle interface de tableau de bord, consultez la page Planifier et envoyer des tableaux de bord.

Cette page présente l'envoi d'anciens tableaux de bord aux destinations de livraison natives de Looker et à tous les services intégrés disponibles pour votre instance Looker. Pour plus d'informations sur les styles et les explorations, consultez la page de documentation Présentation des styles et des explorations.

Looker Scheduler est le nom de la fenêtre pop-up dans laquelle vous configurez les paramètres de diffusion de contenu.

Si vous êtes un développeur Looker, vous devez désactiver le mode de développement pour activer ces options de planification.

Les options de livraison dont vous disposez dépendent des autorisations de distribution qui vous sont accordées par votre administrateur Looker.

Ouvrir le programmeur à partir d'un dossier

Pour ouvrir le planificateur depuis un dossier ou un sous-dossier, recherchez le dossier ou le sous-dossier contenant le tableau de bord que vous souhaitez diffuser. Lorsque vous accédez à un dossier, tous les styles et tableaux de bord qu'il contient sont répertoriés en mode Liste ou en Grille.

Si votre administrateur a activé la fonctionnalité expérimentale Navigation améliorée, vous pouvez accéder aux dossiers en développant la liste des dossiers dans la section Dossiers du nouveau panneau de navigation améliorée de gauche.

Une icône en forme de calendrier indique que vous avez planifié au moins un envoi récurrent pour ce contenu (en vue de grille, vous devez passer votre curseur sur la miniature de contenu pour afficher l'icône de calendrier, le cas échéant) :

Dans la vue sous forme de liste ou la vue sous forme de grille, vous pouvez ouvrir le planificateur en procédant comme suit:

  • Cliquer sur l'icône de calendrier d'un élément (le cas échéant), puis sur Nouveau
  • Cliquer sur le menu à trois points d'un article et sélectionner Programmer la livraison

Looker affiche le planificateur, une fenêtre contextuelle avec vos choix de planification. Pour savoir comment configurer les paramètres de distribution, consultez la page Planifier et envoyer des tableaux de bord.

Créer une livraison

Pour créer une diffusion depuis le contenu Looker, ouvrez l'ancien programmeur en cliquant sur le menu représenté par une roue dentée en haut à droite du contenu, puis en sélectionnant Planifier (pour les diffusions récurrentes) ou Envoyer (pour les diffusions ponctuelles).

Looker affiche le planificateur hérité, une fenêtre contextuelle avec vos choix de planification, similaire à celle-ci, qui affiche un envoi planifié d'un tableau de bord hérité par e-mail au format PDF :

Le planificateur hérité de cet envoi d'une présentation peut ressembler à ceci :

Pour les envois récurrents, le volet de gauche du planificateur hérité affiche toutes les planifications créées pour le contenu et met en avant l'intitulé de la planification que vous créez ou modifiez. Le panneau de gauche répertorie les planifications dans l'ordre décroissant en commençant par la dernière mise à jour. Vous pouvez dupliquer ou supprimer des planifications existantes en cliquant respectivement sur l'icône Dupliquer ou Supprimer à droite de la planification.

S'il s'agit de la première programmation que vous créez pour ce contenu, le panneau principal affiche les options de planification définies sur leurs valeurs par défaut. Vous pouvez modifier ces valeurs selon vos besoins. Si vous avez précédemment créé une ou plusieurs planifications pour ce contenu, le volet principal affiche les paramètres de planification enregistrés pour la planification au début de la liste. Puis :

  • Pour modifier les options d'un planning existant, sélectionnez ce dernier et modifiez les options selon vos besoins. Lorsque vous avez terminé, cliquez sur Tout enregistrer.
  • Pour créer d'autres horaires pour le même contenu, cliquez sur Nouveau +, puis saisissez les paramètres de cet autre calendrier.

Lorsque vous avez terminé, cliquez sur Tout enregistrer.

Les sections suivantes expliquent chaque paramètre de planification.

Nommer la diffusion

Attribuez un nom unique à la programmation dans le champ Attribuez un nom à votre programmation. Le titre apparaîtra dans le panneau de gauche une fois le planning enregistré, dans la liste des plannings que vous avez créés et sur les pages de gestion des plannings dans le panneau Admin.

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

  • Pour les e-mails distribués, le titre est utilisé dans l'objet du message et dans le nom du 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 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 livraison se présente sous 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 horodataire se présentera sous la forme 2019-05-31T0933 pour le 31 mai 2019 à 9h33).
  • 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.

  • Pour les envois SFTP, l'intitulé figure dans le nom du fichier d'envoi. Le nom de fichier de la livraison se présente sous le format TITLE_TIMESTAMP_TOKEN, où TOKEN est un identifiant aléatoire à six caractères et TIMESTAMP suit le format YYYY-MM-DDTHHMM (par exemple, la partie horodataire se présentera sous la forme 2019-05-31T0933 pour le 31 mai 2019 à 9h33).

    Pour les diffusions SFTP, seuls les caractères alphanumériques, les traits de soulignement (_) et les tirets (-) sont acceptés dans le nom de fichier de la diffusion. Looker supprime tous les caractères autres que A-Z, a-z, 0-9, _ ou - des caractères que vous saisissez dans le champ Attribuez un nom à votre planification.

Choisir la destination de livraison

Selon la configuration de vos autorisations par votre administrateur Looker, toutes les destinations peuvent ne pas être visibles.

Le paramètre Où vont ces données ? peut proposer plusieurs options de destination pour la diffusion des données. Chaque destination propose différentes options de livraison.

Exemples de destinations:

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.

Options de distribution des e-mails

Dans la section Où vont ces données ?, sélectionnez E-mail. Le contenu est alors envoyé à la liste d'adresses indiquée.

Dans la section Destinataires, saisissez les adresses e-mail des destinataires. Saisissez une ou plusieurs adresses e-mail séparées par une virgule, puis cliquez sur Ajouter.

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. Pour envoyer du contenu à des utilisateurs externes, votre administrateur Looker doit vous avoir autorisé à diffuser du contenu auprès des utilisateurs externes ou avoir ajouté les domaines de messagerie de ces destinataires à la liste Liste des domaines autorisés pour le contenu planifié.

Si le destinataire est un autre utilisateur Looker, cette personne verra l'option permettant de revenir au tableau de bord à partir de l'e-mail, sauf si votre administrateur Looker a défini la stratégie de données par e-mail de votre instance Looker sur Send Data Only (Envoyer des données uniquement) ou que l'option Include links (Inclure des liens) est désélectionnée.

Si tous les destinataires se désabonnent d'une distribution planifiée, cette planification est supprimée de Looker, même sur les pages de gestion des plannings des utilisateurs et des administrateurs. Si un destinataire se désabonne au nom d'un groupe d'adresse e-mail, aucun membre du groupe ne recevra d'envois par e-mail planifiés.

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

Cochez la case Inclure un message personnalisé pour ajouter un message personnalisé dans le corps de l'e-mail. Looker limite le nombre de caractères d'un message personnalisé à 1 500.

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

Options de diffusion pour les webhooks

Les webhooks sont une solution de plus en plus répandue permettant de déclencher des échanges entre des services Internet. Avec un service Web tel que Zapier, les webhooks peuvent permettre aux données Looker d'être transmises à un large éventail d'applications. Par exemple, vous pouvez planifier la livraison périodique d'un look ou d'un tableau de bord à un webhook. Lorsque vous configurez une distribution, Looker vous invite à saisir l'adresse du webhook.

Dans la section Où vont ces données ?, sélectionnez Webhook. Dans la section URL du webhook, saisissez l'URL à laquelle Looker doit envoyer une requête HTTPS pour cette distribution. Vous pouvez obtenir cette URL auprès du service Web que vous utilisez pour gérer votre webhook. Pour configurer un webhook, accédez à votre service Web et procédez comme suit:

  1. Procurez-vous l'URL à laquelle Looker doit adresser une demande HTTPS pour son envoi.
  2. 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 diffuser le tableau de bord. Consultez cet article de la communauté Looker sur la page Planifier des looks et des tableaux de bord à l'aide de webhooks (3.46 et versions ultérieures) pour obtenir des instructions sur la configuration d'une autre application afin de recevoir les données webhook de Looker.

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.

Options de distribution pour les buckets 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.

Si vous sélectionnez Amazon S3 comme destination, Looker vous invitera à préciser des paramètres supplémentaires pour la mise en forme et concernant le paquet Amazon S3, comme expliqué sur cette page. Consultez cet article de la communauté Looker sur la planification des résultats (illimités) dans S3 pour en savoir plus sur la diffusion de données à l'aide d'un bucket Amazon S3.

Dans la section Où vont ces données ?, sélectionnez Amazon S3. La section Détails de S3 s'affiche et vous invite à obtenir des informations sur votre bucket Amazon S3:

  • Bucket: nom de votre bucket Amazon S3.
  • Chemin d'accès facultatif : 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 à votre bucket S3 fourni par Amazon.
  • Clé secrète : il s'agit de la clé d'accès secrète de votre bucket S3 fournie par Amazon.
  • Région : région des services Amazon dans laquelle votre bucket S3 est hébergé

Options de distribution pour les serveurs SFTP

Sélectionnez SFTP dans la section Où vont ces données ? pour fournir votre tableau de bord à un serveur 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. Si vous choisissez cette option d'envoi, Looker vous invitera à indiquer l'adresse du serveur SFTP, votre nom d'utilisateur et mot de passe, comme expliqué ci-dessous.

Notez les éléments suivants à propos des livraisons :

  • Pour recevoir les envois 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.
  • Lors de l'envoi à un serveur SFTP, seuls les caractères alphanumériques, les traits de soulignement (_) et les tirets (-) sont acceptés dans le nom de fichier. Looker supprime tous les caractères autres que A-Z, a-z, 0-9, _ ou - des caractères que vous saisissez dans le champ Attribuez un nom à votre planification.

Lorsque vous choisissez SFTP, Looker vous invite à saisir l'URL et les informations de connexion du serveur:

  • Adresse: URL ou adresse IP du serveur SFTP vers lequel vous souhaitez envoyer vos données. 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 indique que le fichier sera enregistré dans un dossier nommé In. Si vous omettez la fin de /, le fichier sera enregistré dans le dossier Marketing et "In" sera ajouté au début du nom de fichier. Vous devez disposer d'un accès en écriture au dossier dans lequel vous voulez créer le fichier.

  • Nom d'utilisateur et Mot de passe : identifiants de connexion au serveur SFTP

  • 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. Les options acceptées sont les suivantes :

    • diffie-hellman-group-exchange-sha1
    • diffie-hellman-group1-sha1
    • diffie-hellman-group14-sha1
    • diffie-hellman-group-exchange-sha256

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

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

Les algorithmes de clés d'hôte compatibles avec les diffusions SFTP de Looker sont les suivants:

  • ssh-rsa
  • ssh-dss
  • ssh-rsa-cert-v01@openssh.com
  • ssh-rsa-cert-v00@openssh.com

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.

Si vous recevez l'erreur Java::JavaLang::NullPointerExceptions lors de l'envoi de données à un serveur SFTP, cela peut être dû à un bug dans JRuby qui empêche l'utilisation d'algorithmes à courbe elliptique et/ou de clés d'hôte pour les connexions SSH de Looker aux destinations SFTP. Pour éviter les problèmes d'envoi de données vers des destinations SFTP, n'utilisez pas d'algorithmes EC dans les fichiers ~/.ssh/config ou /etc/ssh_config, et ne stockez pas de clés d'hôte EC dans ~/.ssh sur votre hôte Looker.

Looker télécharge le fichier vers l'annuaire spécifié sur votre serveur SFTP à l'aide de la convention suivante pour le nom de fichier :

<name>_<timestamp>_<token>.<file extension>
  • Nom que vous avez fourni dans le champ Attribuer un nom à votre planning, après que Looker a supprimé tous les caractères autres que A-Z, a-z, 0-9, _ ou -
  • Horodatage d'envoi de la planification, au format %Y-%m-%dT%H%M.
  • Un jeton, caractérisé par une chaîne de six caractères aléatoires.
  • L'extension de fichier

Par exemple : Test_Schedule_2019-04-11T1130_HWkvys.csv

Options de diffusion pour les intégrations tierces

Le planificateur affiche toutes les actions qui ont été activées par votre administrateur Looker. Selon le service, il est possible que vous deviez renseigner des champs supplémentaires, spécifiques à la destination. Ces champs fournissent au service intégré les informations nécessaires pour réaliser l'action sélectionnée avec les données. Pour en savoir plus sur la diffusion de données à partir des intégrations, consultez la section Fournir des données de tableau de bord ou de requête de la page de documentation Partager des données via un hub d'action.

Pour obtenir une description des informations requises par chaque service, recherchez votre destination dans l'une des listes ci-dessous et accédez à l'URL indiquée dans la colonne Comment utiliser cette destination.

La liste suivante répertorie tous les services intégrés auxquels vous pouvez envoyer un tableau de bord :

Choisir le format des données

Pour les distributions par e-mail, l'option permettant de sélectionner un format de données n'est pas disponible si votre administrateur Looker a défini les règles de données par e-mail de votre instance Looker sur Send Link Only (Envoyer le lien uniquement).

Pour choisir le format de diffusion, sélectionnez l'icône appropriée dans la section Mettre en forme les données sous dans le planificateur. Consultez le tableau ci-dessous pour savoir comment chaque format est diffusé à chaque destination.

Format Messagerie Webhook Amazon S3 SFTP
PDF Le tableau de bord au format PDF. Pour les envois par e-mail, le fichier PDF est envoyé en pièce jointe. 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. Le tableau de bord au format PDF. 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. Le tableau de bord au format PDF. 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. Le tableau de bord au format PDF. 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.
Visualisation Visualisation dans le corps de l'e-mail sous forme d'image PNG. 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. Visualisation du tableau de bord dans un seul fichier image PNG. 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. Visualisation du tableau de bord dans un seul fichier image PNG. 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. Visualisation du tableau de bord dans un seul fichier image PNG. 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.
Fichier zip CSV Données non mises en forme du tableau de bord, envoyées comme un ensemble de fichiers de valeurs séparées par des virgules (CSV) dans un répertoire zippé. Pour les e-mails, le fichier ZIP est envoyé en pièce jointe. Données non mises en forme du tableau de bord, envoyées comme un ensemble de fichiers de valeurs séparées par des virgules (CSV) dans un répertoire zippé. Données non mises en forme du tableau de bord, envoyées comme un ensemble de fichiers de valeurs séparées par des virgules (CSV) dans un répertoire zippé. Données non mises en forme du tableau de bord, envoyées comme un ensemble de fichiers de valeurs séparées par des virgules (CSV) dans un répertoire zippé.

Les limites applicables aux requêtes de tableau de bord varient en fonction du format d'envoi des données :

  • Les fichiers CSV compressés au format ZIP incluent toutes les lignes de la requête sous-jacente, dans la limite de 5 000.
  • Les formats PDF et visualisation présentent une image statique de chaque vignette au moment de l'exécution. En cas de vignette montrant une visualisation de table, vous voyez le nombre de lignes visibles dans la vignette lors du rendu du fichier, et vous ne pouvez pas faire défiler la vignette.

Déclenchement de la diffusion

Cette option ne s'affiche pas si vous envoyez une livraison ponctuelle.

Lorsque vous planifiez des envois récurrents, deux options de déclenchement d'envois s'offrent à vous :

  • Intervalle de répétition: sélectionnez cette option pour utiliser le calendrier de diffusion défini dans la section Spécifier la récurrence de la diffusion sur cette page.
  • Mise à jour d'un groupe de données : si votre développeur LookML a configuré des groupes de données, vous pouvez programmer l'envoi des données 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 pertinents.

Spécifier le déclencheur du groupe de données

Cette option ne s'affiche pas si vous envoyez une diffusion ponctuelle ou si vous avez spécifié un déclencheur d'intervalles réguliers pour la diffusion récurrente.

Pour utiliser un déclencheur de groupe de données, sélectionnez Mise à jour de groupe de données dans la section Déclencheur du programmeur. Choisissez ensuite le groupe de données source dans la liste déroulante Sélectionner un groupe de données:

Pour planifier le contenu à l'aide d'un déclencheur de groupe de données, le fichier de modèle sur lequel le contenu est basé doit inclure un groupe de données. Looker répertorie tous les groupes de données définis dans les modèles inclus dans la tuile Look ou le tableau de bord donné, 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 PDT.

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

Dans le cas des tableaux de bord, où plusieurs tuiles peuvent être associées à plusieurs groupes de données, vous avez le choix entre n'importe quel groupe de données associé au tableau de bord. L'ensemble du tableau de bord sera envoyé à la fin du groupe de données sélectionné.

Spécifier la récurrence de la diffusion

Cette option ne s'affiche pas si vous envoyez une diffusion ponctuelle ou si vous avez spécifié un déclencheur de mise à jour de groupe de données pour votre envoi récurrent.

Pour les livraisons qui utilisent un intervalle régulier, vous pouvez personnaliser la planification de votre planification dans la section Distribuer le calendrier. Sélectionnez Intervalle de répétition dans la section Déclencheur du planificateur. Les options de planification varient : Tous les jours, Toutes les semaines, Tous les mois, Toutes les heures ou Par minute. Vous pouvez ajuster le fuseau horaire de la programmation dans la section Options avancées.

L'heure de fin des intervalles Hourly et By minute n'est pas incluse. Le dernier envoi sera effectué au dernier intervalle sélectionné avant l'heure de fin spécifiée. Par exemple, si un contenu est programmé Toutes les heures entre minuit et 23 h, il l'est aussi toutes les heures de 00 h 00 à 22 h 00. Si le contenu est planifié de 12 h 00 à 10 h 00 entre 10:00 et 13:00 minute à 13:00 du matin au soir,

Appliquer des filtres à la diffusion

Si vous diffusez un style ou un tableau de bord comportant des filtres, vous pouvez modifier les conditions de filtrage afin de filtrer davantage les résultats générés.

Cliquez sur Filtres pour afficher et modifier les filtres associés à ce style ou tableau de bord pour la diffusion. La modification de ces options de filtrage dans le planificateur ne modifie pas les filtres dans votre style ou votre tableau de bord. Si un filtre de tableau de bord requiert une valeur de filtre et que le filtre de planification est vide, la planification n'affichera aucun résultat lors de la diffusion.

Si vous modifiez les noms de champs qui servent de filtres dans vos styles ou vos tableaux de bord, veillez à consulter la section Filtres de vos tableaux de bord et styles planifiés, et mettez à jour les filtres si nécessaire. Si un envoi de contenu planifié inclut des filtres qui ne fonctionnent plus (en cas de changement du champ référencé, par exemple), il est possible que l'envoi planifié présente des données non filtrées.

Pour personnaliser davantage les livraisons, vous pouvez utiliser l'option de filtre correspond à un attribut utilisateur (si vos administrateurs Looker ont configuré des valeurs spécifiques à l'utilisateur appelées attributs utilisateur). La définition d'un filtre pour l'un de ces attributs personnalise automatiquement les résultats de chaque utilisateur, ce qui signifie que vous pouvez envoyer des résultats personnalisés à de nombreux destinataires, même si vous envoyez un envoi occasionnel. Pour en savoir plus, consultez la page Attributs utilisateur.

Appliquer des options de distribution avancées

La section Options avancées permet de personnaliser davantage votre livraison. Cliquez sur la flèche à côté de Options avancées pour développer ce menu. Les options disponibles dépendent de la destination et du format que vous avez sélectionnés pour la diffusion, et selon que vous diffusez un tableau de bord, un style ou une section "Explorer". Les liens du tableau ci-dessous redirigent vers une description de chaque option disponible pour les livraisons de tableaux de bord vers les destinations natives de Looker. Les livraisons vers des intégrations tierces peuvent proposer des options avancées uniques.

Format Messagerie Webhook Amazon S3 SFTP
PDF Options de courriel Exécuter la planification en tant que destinataire Non disponible pour cette destination Non disponible pour cette destination Non disponible pour cette destination
Inclure des liens
Options de format Utiliser la disposition sur une seule colonne Options de format Utiliser la disposition sur une seule colonne Options de format Utiliser la disposition sur une seule colonne Options de format Utiliser la disposition sur une seule colonne
Développer les tableaux Développer les tableaux Développer les tableaux Développer les tableaux
Fuseau horaire Fuseau horaire Fuseau horaire Fuseau horaire
Format de papier Format de papier Format de papier Format de papier
Visualisation Options de courriel Exécuter la planification en tant que destinataire Non disponible pour cette destination Non disponible pour cette destination Non disponible pour cette destination
Inclure des liens
Options de format Utiliser la disposition sur une seule colonne Options de format Utiliser la disposition sur une seule colonne Options de format Utiliser la disposition sur une seule colonne Options de format Utiliser la disposition sur une seule colonne
Résolution de la table Non disponible pour cette destination Non disponible pour cette destination Non disponible pour cette destination
Fuseau horaire Fuseau horaire Fuseau horaire Fuseau horaire
ZIP CSV Options de courriel Exécuter la planification en tant que destinataire Non disponible pour cette destination Non disponible pour cette destination Non disponible pour cette destination
Inclure des liens
Options de format Appliquer des options de visualisation Options de format Appliquer des options de visualisation Options de format Appliquer des options de visualisation Options de format Appliquer des options de visualisation
Valeurs de données formatées Valeurs de données formatées Valeurs de données formatées Valeurs de données formatées
Fuseau horaire Fuseau horaire Fuseau horaire Fuseau horaire

Options de courriel

Les options suivantes ne sont disponibles que lorsque vous planifiez l'envoi des données par e-mail:

Exécution de la planification 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 administrateurs de définir une liste d'utilisateurs qui recevront chacun la diffusion de contenu comme s'ils exécutaient la requête, en fonction de leurs autorisations. 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:

Cette option prend en compte les autorisations de l'utilisateur créant le planning, ainsi que les types d'adresses e-mail ajoutés au champ de texte À quelle adresse 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 un e-mail qui n'appartient pas à un utilisateur de Looker (un compte Looker est indiqué par une icône Looker à côté du destinataire) :

  • Si l'adresse e-mail a été ajoutée avant que l'option Exécuter la planification en tant que destinataire ne soit sélectionnée, l'option est désactivée automatiquement. Elle redevient disponible si l'adresse e-mail est supprimée de la liste des destinataires.
  • Si l'adresse e-mail a été ajoutée après que l'option Exécuter la planification en tant que destinataire a été sélectionnée, l'ajout de l'adresse e-mail génère une erreur et l'e-mail est automatiquement supprimé du champ À qui l'adresse e-mail doit-elle être envoyée ?. L'option Exécuter la planification en tant que destinataire reste activée.

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

Si votre administrateur Looker a défini les règles de données par e-mail de votre instance Looker sur Send Links and Data, le planificateur affiche une option Include links (Inclure les liens). Lorsque cette option est cochée, les données envoyées par e-mail incluent un lien vers Looker qui indique "View full report" (Afficher le rapport complet) pour "Looks and Explores" (Explorations explorées) et "View full dashboard" (Afficher le tableau de bord complet).

Ce lien permet aux destinataires de l'e-mail d'explorer les données en détail dans votre instance Looker. Les destinataires doivent se connecter à Looker et disposer des autorisations nécessaires pour accéder au modèle sur lequel le contenu envoyé est basé pour pouvoir consulter ce contenu dans Looker. Si vous souhaitez supprimer cette association de vos e-mails de diffusion de données, décochez la case Inclure des liens.

Options de format

Les options de format disponibles dépendent du format de données sélectionné et de la destination.

Utiliser la mise en page à colonne unique

La mise en page à une seule colonne est disponible pour les diffusions PDF et de visualisation vers toutes les destinations natives.

Pour les envois de tableaux de bord sous forme de fichier PDF ou de visualisation, vous avez la possibilité d'imprimer le fichier PDF en une seule colonne, auquel cas les vignettes du tableau de bord sont présentées dans une unique colonne. Cochez l'option Utiliser une seule disposition de la colonne pour utiliser cette option, ou décochez la case pour afficher les tuiles telles qu'elles sont disposées dans le tableau de bord.

Résolution de la table

Pour les tableaux de bord, vous devez cocher l'option Utiliser une seule colonne pour que cette option s'affiche.

Lorsque vous envoyez du contenu à un e-mail au format Visualisation, 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

Si vous choisissez l'option Étendue et que la largeur de la visualisation dépasse la limite définie par votre client de messagerie, les destinataires de l'e-mail devront peut-être faire défiler la page horizontalement pour afficher la visualisation complète.

Agrandir les tableaux

Pour afficher toutes les lignes d'un tableau de données (plutôt que seulement celles qui figurent dans la vignette de la vignette du tableau de bord) dans un tableau de bord de livraison ou de téléchargement au format PDF, cochez la case Développer les tableaux. Si vous ne voyez pas l'option Développer les tables, contactez votre administrateur Looker pour savoir comment installer la version appropriée du moteur de rendu Chromium pour votre instance Looker.

Appliquer les options de visualisation

Cette option est disponible pour les livraisons au format CSV vers toutes les destinations.

Vous pouvez indiquer si l'envoi des données doit utiliser les mêmes options que votre visualisation :

Valeurs de données formatées

Cette option est disponible pour les livraisons au format CSV vers toutes les destinations.

Vous pouvez configurer la mise en forme des données:

  • Sélectionnez Valeurs de données formatées si vous souhaitez que les données s'affichent plus similaires à l'expérience Explorer dans Looker, bien que certaines fonctionnalités (telles que les associations) ne soient pas compatibles avec tous les types de fichiers.
  • Désélectionnez Valeurs de données formatées si vous ne souhaitez pas appliquer une mise en forme spéciale des résultats de votre requête, comme l'arrondissement des nombres longs ou l'ajout de 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.

Fuseau horaire

Cette option est disponible pour les diffusions dans tous les formats de données vers toutes les destinations natives.

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 fuseau horaire de votre application. Si vous souhaitez spécifier un autre fuseau horaire, sélectionnez Utiliser un fuseau horaire personnalisé. 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.

Format de papier

Cette option est disponible pour les livraisons au format PDF dans toutes les destinations natives.

Vous avez la possibilité de préciser la taille et l'orientation optimales des fichiers PDF du tableau de bord. Pour ce faire, sélectionnez l'option correspondante 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 savoir comment installer la dernière version du moteur de rendu Chromium pour votre instance Looker.

Tester la diffusion

Cliquez sur le bouton Envoyer le test pour envoyer une livraison de test unique à la destination spécifiée.

Enregistrement de la livraison

Un résumé de vos paramètres d'envoi s'affiche au bas du planificateur.

Pour les diffusions ponctuelles, lorsque vous avez terminé de configurer les options de diffusion, cliquez sur le bouton Envoyer pour envoyer le contenu immédiatement à la destination spécifiée.

Pour les diffusions récurrentes, lorsque vous avez fini de configurer les options de diffusion, cliquez sur le bouton Tout enregistrer pour enregistrer votre calendrier et fermer la fenêtre. Le contenu sera envoyé en fonction de vos paramètres d'envoi. Si vous rouvrez le planificateur, votre planificateur enregistré s'affiche dans le volet gauche. Vous pouvez dupliquer ou supprimer le calendrier en cliquant respectivement sur l'icône Dupliquer ou Supprimer.

La planification enregistrée s'affiche également sur la page Planifications que vous avez créées de votre profil utilisateur, ainsi que sur les pages Planifications et Historique des programmations dans le panneau Admin. Pour en savoir plus, consultez la section Afficher les livraisons de cette page.

Afficher les livraisons

Vous pouvez afficher les planifications que vous avez créées et, en fonction des autorisations appropriées, toutes les planifications de l'instance Looker.

Afficher les livraisons que vous avez créées

Sur la page Planifications que vous avez créées, vous pouvez consulter la liste de toutes les planifications que vous avez créées. Pour y accéder, cliquez sur l'icône de votre profil utilisateur, puis sélectionnez Planifications. Pour savoir comment afficher et gérer les planifications que vous avez créées, consultez la page Afficher les livraisons de données planifiées.

Afficher les livraisons créées par d'autres utilisateurs

Si votre administrateur Looker vous a autorisé à afficher les pages d'administration Planifications et Historique des planifications, vous pouvez consulter la liste de toutes les planifications pour l'ensemble de l'instance Looker. Cependant, vous ne pourrez plus modifier ou supprimer ces planifications.

Bon à savoir

Il arrive qu'un envoi planifié par e-mail 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.

D'autres difficultés peuvent apparaître :

  • Si votre entreprise a configuré ses propres paramètres de messagerie dans la section Admin de Looker, vos administrateurs Looker doivent s'assurer que les paramètres sont corrects et que votre fournisseur de messagerie fonctionne correctement.
  • Selon le paramètre Limite, la distribution des données est limitée à 5 000 lignes ou à une taille de fichier maximale de 15 Mo pour les e-mails avec pièces jointes et de 20 Mo pour les e-mails dont le contenu est intégré. Les e-mails contenant davantage de lignes ou de données ne sont donc pas envoyés.
  • Si un e-mail n'est pas envoyé au moment prévu, mais qu'il arrive finalement, il est probable que vous soyez en concurrence avec d'autres tâches Looker. Il peut s'agir d'autres e-mails planifiés, d'un nombre élevé d'utilisateurs explorant des données en même temps ou de la création de tables dérivées persistantes. Si cela se produit, renseignez-vous sur les tâches concurrentes auprès de l'administrateur Looker.
  • Si un e-mail spécifique disparaît de votre liste de distribution, il est probable qu'un utilisateur se désabonne de cet e-mail programmé. Cela peut être problématique si vous utilisez un alias de messagerie de groupe pour envoyer l'e-mail à plusieurs personnes, car chaque destinataire peut désabonner l'ensemble de l'alias. Si vous avez besoin de comprendre les désabonnements, consultez cet article de la communauté Looker sur la surveillance des événements de désabonnement du programmeur.