Diffuser des présentations et des explorations

Cette page présente la diffusion de Looks et d'Explores vers les destinations de diffusion intégrées de Looker et vers tous les services intégrés disponibles pour votre instance Looker. Pour en savoir plus sur la planification des tableaux de bord, consultez la page de documentation Planifier et envoyer des tableaux de bord.

Le planificateur Looker est le nom de la fenêtre pop-up dans laquelle vous configurez les paramètres de diffusion de votre contenu. Pour les Looks, vous pouvez utiliser le planificateur pour envoyer des livraisons ponctuelles ou récurrentes. Les explorations ne peuvent être envoyées qu'en une seule fois. Pour planifier l'envoi récurrent de contenu Explorer, vous devez d'abord l'enregistrer en tant que présentation.

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

Les options de livraison disponibles dépendent des autorisations liées à la livraison qui vous ont été accordées par votre administrateur Looker.

Ouvrir le planificateur à partir d'un dossier

Pour les explorations, vous ne pouvez ouvrir le planificateur que depuis Explorer, et non depuis 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 distribuer. Lorsque vous accédez à un dossier, toutes les présentations et tous les tableaux de bord qu'il contient sont listés en vue Liste ou en vue Grille.

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 pointer sur la miniature du contenu pour afficher l'icône de calendrier, le cas échéant).

Dans la vue Liste, vous pouvez ouvrir le planificateur de différentes manières :

• Cliquez sur l'icône de calendrier d'un article, le cas échéant
• Cliquer sur le menu à trois points d'un élément et sélectionner Modifier la programmation (s'il existe déjà une programmation pour l'élément), Ajouter une programmation (s'il n'y a pas encore de programmation pour l'élément) ou Envoyer (pour créer une diffusion unique)
• Ouvrez le contenu, cliquez sur le menu Outils en haut à droite, puis choisissez Planifier (pour les envois récurrents) ou Envoyer (pour les envois ponctuels).

Dans la vue Grille, vous pouvez ouvrir le planificateur de plusieurs façons :

• Cliquez sur l'icône de calendrier d'un article, le cas échéant
• Ouvrez le contenu, cliquez sur le menu Outils en haut à droite, puis choisissez Planifier (pour les envois récurrents) ou Envoyer (pour les envois ponctuels).

Créer une diffusion

Pour créer une programmation à partir du contenu Looker, ouvrez l'ancien planificateur en cliquant sur le menu en forme de roue dentée en haut à droite du contenu, puis sélectionnez Programmer (pour les envois récurrents) ou Envoyer (pour les envois ponctuels).

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 sur l'icône Dupliquer ou Supprimer à droite de la planification, respectivement.

S'il s'agit de la première planification que vous créez pour ce contenu, le volet principal affiche les options de la 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'une planification existante, sélectionnez-la et modifiez les options selon vos besoins. Lorsque vous avez terminé, cliquez sur Enregistrer tout.
• Pour créer des planifications supplémentaires pour le même contenu, cliquez sur Nouveau et saisissez les paramètres pour cette planification supplémentaire.

Lorsque vous avez terminé, cliquez sur Enregistrer tout.

Les sections suivantes expliquent chaque paramètre de planification.

Appellation d'un envoi

Donnez un titre unique à la planification dans le champ Donnez un nom à votre planification. Cet intitulé apparaît dans le panneau de gauche une fois la planification enregistrée, dans la liste des planifications que vous avez créées et sur les pages de gestion des planifications du panneau Admin.

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

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

  Pour les livraisons SFTP, seuls les caractères alphanumériques, les traits de soulignement (_) et les tirets (-) sont pris en charge dans le nom de fichier de la livraison. Looker supprimera tous les caractères autres que A-Z, a-z, 0-9, _ ou - de ce que vous saisissez dans le champ Donner un nom à votre programmation.

Choisir la destination de livraison

Selon la manière dont votre administrateur Looker a configuré vos autorisations, il est possible que toutes les destinations ne soient pas visibles.

Le paramètre Où ces données doivent-elles être transmises ? peut afficher plusieurs destinations possibles pour les envois de données. Chaque destination propose différentes options de livraison.

Voici quelques exemples de destinations :

• E-mail
• webhook
• Bucket Amazon S3
• SFTP
• Tous les services intégrés que votre administrateur Looker a activés pour votre instance. Vous trouverez la liste des services disponibles pour la diffusion des Looks et des Explorations dans la section Options de diffusion pour les intégrations tierces de cette page.

Une fois que vous avez sélectionné une destination de données, un nouveau champ de paramètre apparaît pour vous permettre d'ajouter des détails propres à cette destination, tels qu'une adresse e-mail ou l'URL d'un webhook.

Options de distribution des e-mails

Sélectionnez Adresse e-mail dans la section Où ces données doivent-elles aller ?. Le contenu est alors envoyé à la liste d'adresses indiquée.

Dans la section À qui l'e-mail doit-il être envoyé ?, saisissez les adresses e-mail des destinataires. Saisissez une adresse e-mail unique ou plusieurs adresses séparées par des virgules, 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 distribuer du contenu à des utilisateurs externes, votre administrateur Looker doit vous avoir accordé l'autorisation de distribuer 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 un destinataire est un autre utilisateur Looker, l'e-mail contiendra un lien vers le tableau de bord, sauf si votre administrateur Looker a défini la politique de données envoyées par e-mail de votre instance Looker sur Envoyer uniquement les données ou si l'option Inclure les liens est désélectionnée.

Si tous les destinataires se désabonnent d'une planification d'envoi d'e-mails, cette planification est supprimée de Looker, même des pages de gestion des planifications pour les utilisateurs et les 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.

Consultez la section Appliquer des options d'envoi avancées sur cette page pour en savoir plus sur les envois d'e-mails.

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

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. Grâce à un service Web, tel que Zapier, les webhooks peuvent autoriser l'envoi de données Looker à un large éventail d'applications. Par exemple, vous pouvez planifier l'envoi régulier d'une présentation ou d'un tableau de bord vers un webhook. Lorsque vous configurez une diffusion, Looker vous invite à indiquer l'adresse du webhook.

Dans la section Où ces données doivent-elles aller ?, sélectionnez Webhook. Dans la section URL du webhook, saisissez l'URL à laquelle Looker doit adresser une demande HTTPS pour cet envoi. Vous pouvez obtenir cette URL auprès du service Web utilisé 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 selon le service Web et l'application de destination que vous utilisez pour l'envoi du tableau de bord. Consultez cet article de la communauté Looker sur la planification des Looks et des tableaux de bord à l'aide de Webhooks (3.46+) pour obtenir des instructions sur la configuration d'une autre application afin de recevoir les données de 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 d'envoi 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. Pour en savoir plus sur l'envoi de données à l'aide d'un bucket Amazon S3, consultez le post de la communauté Looker sur la planification de l'envoi (illimité) de résultats vers S3.

Dans la section Où ces données doivent-elles aller ?, choisissez Amazon S3. La section S3 Details (Détails S3) apparaît et vous invite à saisir des informations sur votre bucket Amazon S3 :

• Bucket : nom de votre bucket Amazon S3.
• Chemin d'accès facultatif : dossier dans lequel vous voulez enregistrer vos données, le cas échéant.
• Clé d'accès : ID de la clé d'accès à votre bucket S3, fourni par Amazon.
• Clé secrète : clé d'accès secrète à votre bucket S3, fournie par Amazon.
• Région : région des services Amazon où votre bucket S3 est hébergé.

Options d'envoi pour les serveurs SFTP

Sélectionnez SFTP dans la section Où ces données doivent-elles aller ? pour envoyer votre tableau de bord à un serveur SFTP. Il est recommandé d'envoyer des résultats à un serveur SFTP lorsque vos données ou votre visualisation 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 votre mot de passe, comme expliqué ci-dessous.

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

• Pour recevoir des livraisons SFTP de Looker, assurez-vous que votre administrateur réseau a ajouté les adresses IP de Looker à la liste d'adresses IP autorisées ou aux règles de trafic entrant de votre serveur SFTP.
• Pour les livraisons à un serveur SFTP, seuls les caractères alphanumériques, les traits de soulignement (_) et les tirets (-) sont pris en charge dans le nom de fichier de la livraison. Looker supprimera tous les caractères autres que A-Z, a-z, 0-9, _ ou - de ce que vous saisissez dans le champ Donner un nom à votre programmation.

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

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

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

  Cette URL se termine par le caractère /. ce qui indique que le fichier sera enregistré dans un dossier nommé In. Si vous omettez le / de fin, 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 privilégié : 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 Défaut, l'ordre d'origine des algorithmes dans la bibliothèque de connexion 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.

Voici les algorithmes de clé hôte compatibles avec les livraisons SFTP Looker :

• 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 lorsque vous transmettez des données à un serveur SFTP, cela peut être dû à un bug dans JRuby qui empêche l'utilisation d'algorithmes à courbe elliptique (CE) ou de clés hôtes pour les connexions SSH de Looker vers les 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, ni de clés hôtes 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>

• Le nom que vous avez indiqué dans le champ Donnez un nom à votre programmation, après que Looker a supprimé tous les caractères autres que A-Z, a-z, 0-9, _ ou -
• L'horodatage auquel l'horaire a été envoyé, 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 livraison pour les intégrations tierces

Vous pouvez planifier ou envoyer un Look ou les résultats d'une exploration à un service 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 des autorisations spécifiques aux utilisateurs et aux utilisateurs intégrés pour qu'ils puissent envoyer et planifier des données vers des intégrations tierces.

Lorsqu'un service intégré est sélectionné dans le champ Destination du planificateur, plusieurs nouveaux champs peuvent apparaître et vous inviter à saisir des informations.

La liste suivante répertorie les services Action Hub de Looker auxquels vous pouvez envoyer une présentation ou les résultats d'une exploration.

Voici comment utiliser la liste :

• Les URL affichées dans la colonne Lien vers le fichier README fournissent des instructions pour activer et configurer le service intégré afin qu'il fonctionne avec Looker.
• Les URL affichées dans la colonne Comment utiliser cette intégration fournissent des instructions sur la façon d'envoyer des données de Looker au service intégré. Certains de ces articles contiennent également des instructions d'activation.
• La section Balises LookML requises liste toutes les balises requises 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 que le service intégré envoie : champ, requête ou tableau de bord. Une action au niveau du champ envoie la valeur d'une seule cellule spécifiée dans un tableau de données. Une action au niveau de la requête envoie les résultats d'une requête entière, comme toutes les lignes d'une exploration ou d'une présentation. Une action au niveau du tableau de bord envoie une image d'un tableau de bord.
• Utilise l'authentification Google OAuth indique si le service intégré utilise les identifiants Google OAuth pour l'authentification.
• Utilise le streaming de données indique si le service intégré est compatible avec les résultats de requête en flux continu.

Choisir le format de données

Pour les envois 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 la Règle de données envoyées par e-mail de votre instance Looker sur Envoyer le lien uniquement.

Les présentations et les explorations proposent différentes options de mise en forme selon la destination de l'envoi. Pour choisir le format de votre livraison, sélectionnez l'icône appropriée dans la section Mettre en forme les données en tant que du planificateur.

Le tableau ci-dessous explique comment chaque format est diffusé dans chaque destination.

Déclencher la diffusion

Cette option ne s'affiche pas si vous envoyez une exploration ou une diffusion ponctuelle d'une présentation.

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

• Intervalle récurrent : sélectionnez cette option pour utiliser le calendrier de livraison que vous avez défini dans la section Spécifier la récurrence des livraisons de cette page.
• Mise à jour du groupe de données : si votre développeur LookML a configuré des groupes de données, vous pouvez planifier la diffusion après le déclenchement d'un groupe de données, la gestion du cache et la reconstruction des PDT concernées.

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

Cette option ne s'affiche pas si vous envoyez une exploration ou une diffusion ponctuelle d'un Look, ou si vous avez spécifié un déclencheur d'intervalle récurrent pour votre diffusion récurrente.

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

Pour planifier du 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 présentation ou la vignette de tableau de bord donnée, même si les groupes de données ne sont pas utilisés pour gérer la mise en cache des requêtes ou des tables PDT.

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.

Spécifier la récurrence de la livraison

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

Pour les envois qui utilisent un intervalle récurrent, vous pouvez personnaliser l'heure de votre planification dans la section Envoyer cette planification. Sélectionnez Intervalle de répétition dans la section Déclencheur du planificateur. Les options de périodicité changent selon que vous choisissez Tous les jours, Toutes les semaines, Tous les mois, Toutes les heures ou Toutes les minutes. Vous pouvez ajuster le fuseau horaire de la programmation dans la section Options avancées.

L'heure de fin des intervalles Horaire et Par 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 0h00 et 23h00, il sera envoyé toutes les heures, de 0h00 à 22h00. Si un contenu est programmé toutes les minutes toutes les 30 minutes entre 0h00 et 23h00, la dernière diffusion de cette période aura lieu à 22h30.

Appliquer des filtres à un envoi

Si vous distribuez une présentation ou un tableau de bord contenant des filtres, vous pouvez modifier les conditions de filtrage pour affiner les résultats distribués.

Cliquez sur Filtres pour afficher et modifier les filtres associés à cette présentation ou à ce tableau de bord pour votre envoi. Si vous modifiez ces options de filtrage dans le planificateur, ces changements sont sans effet sur les filtres de la présentation ou du tableau de bord. Si un filtre de tableau de bord nécessite une valeur de filtre et que le filtre de planification est vide, la planification n'affichera aucun résultat lors de l'envoi.

Si vous modifiez des noms de champs utilisés comme filtres dans vos Looks ou tableaux de bord, n'oubliez pas de consulter la section Filtres des Looks et tableaux de bord planifiés, et d'actualiser les filtres afin que vos modifications soient prises en compte. 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 aux utilisateurs 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 de documentation Attributs utilisateur.

Appliquer des options de diffusion avancées

La section Options avancées permet de personnaliser davantage vos envois. Cliquez sur la flèche à côté de Options avancées pour développer le menu. Les options disponibles dépendent de la destination et du format de votre envoi, ainsi que du type de contenu que vous envoyez (tableau de bord, Look ou Explorer). Les liens du tableau suivant redirigent vers une description de chaque option disponible pour les livraisons de Looks ou d'explorations vers les destinations intégrées de Looker. Des options avancées uniques peuvent être disponibles pour les livraisons à des intégrations tierces.

Envoyer cette programmation si

Pour les diffusions récurrentes de Looks, vous pouvez personnaliser la programmation afin que le contenu du Look ne soit diffusé que lorsque certaines conditions sont remplies. Les alertes offrent une fonctionnalité similaire pour les blocs de tableau de bord.

Dans le menu déroulant Envoyer cette programmation si, indiquez si vous souhaitez envoyer le contenu du Look uniquement en présence de résultats, uniquement en l'absence de résultats ou dans les deux cas. Par exemple, vous pouvez utiliser des filtres utilisateur pour créer des conditions pour les situations que vous souhaitez surveiller (comme les articles dont la quantité en stock est inférieure à un seuil donné ou les dépenses supérieures à un certain montant), puis diffuser le contenu uniquement si cette condition est remplie.

Vous pouvez également spécifier qu'une livraison ne doit avoir lieu que si les résultats de la requête ont changé depuis le dernier envoi de données. Pour ce faire, cochez la case et si les résultats ont changé depuis la dernière exécution. Cette option n'est pas disponible si vous souhaitez utiliser l'option de limitation Tous les résultats.

Limite

Vous pouvez limiter la taille de votre envoi en sélectionnant l'une des options de limitation des données suivantes :

• Résultats dans le tableau : les données sont envoyées en une seule fois.
• Tous les résultats : les données sont diffusées en streaming (pour en savoir plus, consultez Quelles sont les limites de lignes dans Looker ?). page "Bonnes pratiques"). Cette option est utile pour les jeux de données volumineux, car elle permet de contourner les limitations de taille de fichier, de navigateur et de mémoire.

Si vous choisissez Résultats dans le tableau, Looker respecte les limitations de lignes définies dans la présentation enregistrée ou l'exploration. Si vous choisissez Tous les résultats, Looker renvoie toutes les lignes de la requête, quels que soient les paramètres de la présentation enregistrée, et sans tenir compte de la limite de 5 000 lignes habituelle de Looker. Si cette option est intéressante pour extraire des jeux de données de très grande taille, elle doit en revanche être utilisée avec précaution pour s'assurer que la requête n'est pas trop volumineuse pour la base de données.

Limiter les options pour les e-mails

Lorsque vous envoyez des Looks et des Explorations, vous pouvez limiter la taille de votre e-mail pour respecter les limites de taille des messages de votre serveur de messagerie. Sélectionnez l'une des options de limitation des données suivantes :

• Résultats dans le tableau : les données sont envoyées dans la limite de 5 000 lignes. Il s'agit de la seule option disponible pour les e-mails utilisant les options de format Tableau de données ou Visualisation. Les e-mails excédant 5 000 lignes ne sont pas envoyés.
• Tous les résultats : si vous utilisez les options de format Texte, CSV, JSON – Simple, XLSX ou HTML, vous pouvez envoyer toutes les lignes des résultats d'un Look enregistré. Cette option remplace les limites définies pour une présentation enregistrée ou la limite de lignes habituelle de Looker (5 000 lignes). Il existe toutefois une limite de données totale de 15 Mo permettant aux applications de messagerie d'accepter la pièce jointe. Les e-mails avec pièce jointe dont la taille dépasse 15 Mo ne sont donc pas envoyés. Si vous choisissez l'option de mise en forme "Table de données" ou "Visualisation" avant de sélectionner Tous les résultats, Looker change automatiquement de format pour utiliser une pièce jointe au format texte, compatible avec l'envoi de tous les résultats.

Pour vérifier si les e-mails planifiés ne dépassent pas les limites de lignes ou de données, vous pouvez saisir votre propre adresse e-mail comme destinataire et cliquer sur Envoyer un test pour vous envoyer immédiatement les données. Si vous ne recevez pas l'e-mail, il est probable que la limite de lignes ou de données pouvant être envoyées par e-mail soit dépassée.

Options d'e-mail

Les livraisons par e-mail disposent d'options de livraison supplémentaires : Exécuter la programmation en tant que destinataire et Inclure les liens.

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 administrateurs de spécifier une liste d'utilisateurs qui recevront tous le contenu par e-mail comme s'ils avaient exécuté 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 incluses dans chaque e-mail.

Par exemple, un administrateur Looker doit planifier une requête qui compte les utilisateurs regroupés par État pour une série d'utilisateurs, et chacun d'eux a des valeurs de filtre d'accès différentes.

Le filtre d'accès de l'utilisateur A est défini sur users.state = 'California'. Si l'option Exécuter la planification en tant que destinataire est sélectionnée, la requête planifiée appliquera le filtre d'accès users.state = 'California' et enverra les résultats filtrés à l'utilisateur A. Les résultats n'afficheront qu'une ligne pour la Californie.

Cette option prend en compte les autorisations de l'utilisateur qui crée la planification ainsi que les types d'adresses e-mail ajoutées au champ de texte À qui doit-elle être envoyée ?.

Dans certains cas, l'option Exécution de 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 (un compte Looker est indiqué par une icône Looker à côté du destinataire)

• Si l'adresse e-mail a été ajoutée avant la sélection de l'option Exécuter la planification en tant que destinataire, cette 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 la sélection de l'option Exécuter la planification en tant que destinataire, une erreur se produit et l'adresse e-mail est automatiquement supprimée du champ À qui l'e-mail doit-il être envoyé ?. L'option Exécuter la programmation en tant que destinataire restera activée.

Dans le cas particulier où un utilisateur est listé comme destinataire d'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 ensuite désactivé, la planification ne sera plus envoyée à l'utilisateur désactivé à partir de la prochaine exécution. Si le compte de cet utilisateur est supprimé, la planification n'est envoyée à aucun destinataire. Un administrateur Looker ou un utilisateur disposant de l'autorisation see_schedules pourra diagnostiquer cet échec sur la page Historique du planificateur du panneau Admin.

Inclure les liens

Si votre administrateur Looker a défini le Règlement concernant les données envoyées par e-mail de votre instance Looker sur Envoyer des liens et des données, le planificateur affichera l'option Inclure les liens. Lorsque cette option est cochée, les envois de données par e-mail incluent un lien vers Looker indiquant "Afficher le rapport complet" pour les Looks et les explorations envoyés, ou "Afficher le tableau de bord complet" pour les tableaux de bord envoyés.

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 retirer ce lien de vos e-mails d'envoi de données, décochez la case Inclure les liens.

Options de mise en forme

Les diffusions qui n'utilisent pas le format "Visualisation" disposent d'options de diffusion supplémentaires : Appliquer les options de visualisation et Valeurs de données mises en forme.

Appliquer les options de visualisation

Cette option n'est pas disponible pour les envois de présentations ou d'explorations au format "Visualisation".

• Sélectionnez Appliquer les options de visualisation pour que l'envoi de vos données ressemble à un tableau. Tous les paramètres configurés pour la visualisation dans les menus Tracé, Série et Mise en forme seront appliqués :

  • Afficher les numéros de ligne
  • Masquer les totaux
  • Masquer les totaux de lignes
  • Limiter les lignes affichées à un maximum de 500 lignes affichées ou masquées
  • Afficher le nom complet du champ
  • Libellés personnalisés pour chaque colonne (le format JSON – Détail, Inline utilise toujours les noms de champs bruts, et non le libellé du champ. Pour en savoir plus sur la façon dont Looker affiche les champs au format JSON, consultez le post de la communauté Modifications apportées à la mise en forme JSON).
  • Mise en forme conditionnelle pour les envois de visualisations sous forme de tableaux au format Excel

  La mise en forme conditionnelle n'est disponible dans les envois Excel de Looks et d'Explores avec des visualisations sous forme de tableaux que si la règle Le long d'une échelle est appliquée.

• Désélectionnez Appliquer les options de visualisation pour que Looker envoie les données telles qu'elles apparaissent dans la section Données de la présentation ou dans la fenêtre Explorer à partir d'ici d'une vignette de tableau de bord. L'option JSON – Libellé utilise le champ label, même si l'option Appliquer les options de visualisation n'est pas sélectionnée.

Mise en forme des valeurs de données

Cette option n'est pas disponible pour les envois de présentations ou d'explorations au format "Visualisation".

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

• Sélectionnez Valeurs de données mises en forme si vous souhaitez que les données ressemblent davantage à l'expérience Explorer dans Looker. Toutefois, certaines fonctionnalités (comme l'association) ne sont pas compatibles avec tous les types de fichiers.
• Désélectionnez Valeurs de données mises en forme si vous ne souhaitez appliquer aucune mise en forme particulière aux résultats de vos requêtes, comme l'arrondi des nombres longs ou l'ajout de caractères spéciaux éventuellement mis en place par les développeurs Looker. Cette façon de procéder est souvent préférable lorsque les données sont transmises à un autre outil de traitement.

Résolution de la table

Lorsque vous envoyez du contenu par e-mail au format de visualisation, vous pouvez personnaliser la largeur de votre visualisation à l'aide du menu déroulant Résolution de table. Vous disposez des options de largeur suivantes :

• Normale : 800 pixels
• Large : 1 680 pixels

Si vous choisissez Large et que la largeur de visualisation dépasse la limite fixée par votre client de messagerie, les destinataires des e-mails devront peut-être faire défiler l'écran horizontalement afin de pouvoir consulter toute la visualisation.

Fuseau horaire

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 celui de votre application. Pour indiquer 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.

Tester la diffusion

Cliquez sur le bouton Envoyer un test pour envoyer un test ponctuel à la destination spécifiée.

Enregistrer la livraison

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

Pour les envois occasionnels, lorsque vous avez terminé de configurer des options d'envoi, cliquez sur le bouton Envoyer pour envoyer le contenu immédiatement à votre destination spécifiée.

Pour les envois récurrents, lorsque vous avez terminé de configurer des options d'envoi, cliquez sur le bouton Enregistrer tout pour enregistrer votre planification 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 avez la possibilité de dupliquer ou supprimer la planification en cliquant sur l'icône Dupliquer ou Supprimer, respectivement.

Le programme que vous avez enregistré s'affiche également sur la page Programmes que vous avez créés de votre profil utilisateur, ainsi que sur les pages Programmes et Historique des programmes du panneau Admin. Pour en savoir plus, consultez la section Afficher les livraisons sur cette page.

Afficher les livraisons

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

Afficher les livraisons que vous avez créées

Vous pouvez consulter la liste de toutes les programmations que vous avez créées sur la page Programmations créées. Pour y accéder, cliquez sur l'icône de votre profil utilisateur, puis sélectionnez Programmations. Pour en savoir plus sur l'affichage et la gestion des plannings que vous avez créés, consultez la page Afficher vos planifications de livraison de données.

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

Si votre administrateur Looker vous a accordé l'autorisation d'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 d'e-mail dans la section Admin de Looker, vos administrateurs Looker devront s'assurer que les paramètres sont corrects et que votre fournisseur de messagerie fonctionne correctement.
• En fonction du paramètre Limite, la diffusion des données sera 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 avec contenu 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é à l'heure prévue, mais finit par arriver, il est probable que ce retard soit dû à l'exécution simultanée 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 particulier ne cesse de disparaître de votre liste de distribution, il est probable qu'un utilisateur se soit désabonné. 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 planificateur.