Diffuser des présentations et des explorations

Cette page explique comment envoyer des Looks et des explorations 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 partie de l'interface utilisateur de Looker 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 que sous forme de livraisons uniques. Pour planifier l'envoi récurrent du contenu d'une exploration, vous devez d'abord l'enregistrer en tant que présentation.

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

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

Ouvrir le planificateur depuis un dossier

Remarque : Pour les explorations, vous pouvez ouvrir le planificateur uniquement depuis l'exploration, 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 envoyer. Lorsque vous accédez à un dossier, toutes les présentations et tous les tableaux de bord qu'il contient sont répertoriés sous forme de liste ou en mode Grille.

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

En 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.
• Cliquez sur le menu à trois points d'un élément, puis sélectionnez Modifier la planification (si une planification existe déjà pour l'élément), Ajouter une planification (si aucune planification n'existe encore pour l'élément) ou Envoyer (pour créer un envoi ponctuel).
• Ouvrez le contenu, cliquez sur le menu en forme de roue dentée en haut à droite, et choisissez Planifier (pour des envois récurrents) ou Envoyer (pour des envois occasionnels)

En mode Grille, vous pouvez ouvrir le planificateur de l'une des manières suivantes :

• Cliquez sur l'icône de calendrier d'un article, le cas échéant.
• Ouvrez le contenu, cliquez sur le menu en forme de roue dentée en haut à droite, et choisissez Planifier (pour des envois récurrents) ou Envoyer (pour des envois occasionnels)

Créer une livraison

Remarque : Comme les explorations ne peuvent être envoyées que de manière ponctuelle, l'option Planifier n'est pas disponible dans le menu en forme de roue dentée d'une exploration. Pour planifier une exploration, choisissez l'option Enregistrer et planifier pour d'abord enregistrer l'exploration en tant que Look, puis suivez les instructions ci-dessous pour planifier le Look que vous venez d'enregistrer.

Pour créer un envoi à 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 Planifier (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 cette planification 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.

Nommer la livraison

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 bucket 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 respecte le format TITLE_TIMESTAMP_HASH, où HASH est un identifiant aléatoire de six caractères et TIMESTAMP suit le format YYYY-MM-DDTHHMM (par exemple, la partie du code temporel ressemblerait à 2019-05-31T0933 pour le 31 mai 2019 à 9h33). Le fuseau horaire du code temporel correspondra au fuseau horaire d'envoi de la programmation.
• Pour les envois à des services intégrés qui génèrent une pièce jointe, 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 respecte le format TITLE_TIMESTAMP_TOKEN, où TOKEN est un identifiant aléatoire de six caractères et TIMESTAMP suit le format YYYY-MM-DDTHHMM (par exemple, la partie du code temporel ressemblerait à 2019-05-31T0933 pour le 31 mai 2019 à 9h33). Le fuseau horaire du code temporel correspondra au fuseau 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 supprime tous les caractères autres que A-Z, a-z, 0-9, _ ou - de ce que vous saisissez dans le champ Nommez votre planification.

Choisir la destination de livraison

Remarque : Selon la manière dont votre administrateur Looker a configuré vos autorisations, il est possible que certaines 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 une liste des services disponibles pour l'envoi de Looks et d'explorations dans la section Options d'envoi pour les intégrations tierces de cette page.

Une fois que vous avez sélectionné une destination, 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 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 doit-elle être envoyée, saisissez l'adresse e-mail des destinataires. Saisissez une seule adresse e-mail ou plusieurs adresses séparées par une virgule, puis cliquez sur Ajouter. Vous pouvez ajouter autant de destinataires que vous le souhaitez.

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 accordé les autorisations nécessaires pour envoyer du contenu à des utilisateurs externes ou avoir ajouté les domaines de messagerie de ces destinataires à la liste d'autorisation des domaines de messagerie pour le contenu planifié.

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

Si tous les destinataires se désabonnent d'un envoi d'e-mail programmé, cette programmation est supprimée de Looker, y compris des pages de gestion des programmations 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 l'option 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 un envoi, Looker vous demande 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 vous procurer cette URL auprès du service Web utilisé pour gérer le webhook. Pour configurer un webhook, accédez à votre service Web et procédez comme suit :

1. Obtenez une URL à laquelle Looker doit envoyer une requête HTTPS.
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 ce post de la communauté Looker sur la planification de Looks et de tableaux de bord à l'aide de webhooks (3.46+) pour savoir comment configurer 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 de diffusion 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 ce post de la communauté Looker sur la planification de l'envoi de résultats (illimités) vers S3.

Dans la section Où ces données doivent-elles aller ?, choisissez Amazon S3. La section S3 Details 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 de livraison pour les serveurs SFTP

Choisissez SFTP dans la section Où ces données doivent-elles aller ? pour envoyer votre contenu vers 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 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'autorisation d'adresses IP 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 supprime tous les caractères autres que A-Z, a-z, 0-9, _ ou - de ce que vous saisissez dans le champ Nommez votre planification.

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 voulez envoyer les données. Exemple :

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

  Cet exemple d'URL se termine par le caractère /. ce qui indique que le fichier sera enregistré dans un dossier nommé In. Si vous omettez le / final, 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 :

  • ecdh-sha2-nistp521
  • ecdh-sha2-nistp384
  • ecdh-sha2-nistp256
  • diffie-hellman-group-exchange-sha256
  • diffie-hellman-group14-sha256
  • diffie-hellman-group14-sha1

  Si la connexion n'est pas établie dans les cinq minutes, choisissez un algorithme différent. Certains algorithmes prennent longtemps à générer une clé SSH. Cette option vous permet d'utiliser un algorithme susceptible de prendre moins de temps. Le choix d'un des algorithmes en fait l'algorithme préféré pour établir la connexion SSH. Si l'algorithme n'est pas pris en charge par le serveur, tous les autres algorithmes sont utilisés lors de tentatives ultérieures. Lorsque ce champ est défini sur Par défaut, l'ordre d'origine des algorithmes dans la bibliothèque de connexion est utilisé.

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

Les algorithmes de clé hôte compatibles avec les livraisons SFTP Looker sont les suivants :

• [e-mail]
• ssh-ed25519
• [e-mail]
• [e-mail]
• [e-mail]
• ecdsa-sha2-nistp521
• ecdsa-sha2-nistp384
• ecdsa-sha2-nistp256
• [e-mail]
• [e-mail]
• ssh-rsa
• rsa-sha2-256
• rsa-sha2-512

Les algorithmes de chiffrement (chiffres) compatibles avec les livraisons SFTP Looker sont les suivants :

• aes256-ctr
• aes192-ctr
• aes128-ctr
• [e-mail]
• [e-mail]

Les algorithmes de code d'authentification de message compatibles avec les livraisons SFTP Looker sont les suivants :

• [e-mail]
• [e-mail]
• hmac-sha2-512
• hmac-sha2-256
• hmac-sha1

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>

• <name> est le nom que vous avez indiqué dans le champ Donnez un nom à votre planification, après que Looker a supprimé tous les caractères autres que A-Z, a-z, 0-9, _ ou -.
• <timestamp> est l'horodatage auquel l'horaire a été envoyé, au format %Y-%m-%dT%H%M.
• <token> est un jeton, caractérisé par une chaîne de six caractères aléatoires.
• <file extension> est 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 une présentation 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 spécifiquement des autorisations aux utilisateurs et aux utilisateurs intégrés pour 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 de l'Action Hub 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 How to use this integration (Comment utiliser cette intégration) fournissent des instructions pour envoyer des données de Looker au service intégré. Certains de ces articles contiennent également des instructions d'activation.
• 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 envoyé par le service intégré : champ, requête ou tableau de bord. Une action au niveau du champ envoie la valeur d'une seule cellule spécifiée dans un tableau de données. Une action au niveau de la requête envoie les résultats d'une requête entière, par exemple 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 des identifiants Google OAuth pour l'authentification.
• Utilise le streaming de données indique si le service intégré accepte les résultats de requête en streaming.

Service intégré	Description	Lien vers le fichier README	Comment utiliser cette intégration	Balises LookML obligatoires	Type d'action	Utilise l'authentification Google OAuth (Oui/Non)	Utilise le streaming de données (Oui/Non)
Airtable	Ajoutez des enregistrements à une table dans Airtable.	Afficher le fichier README sur GitHub	Consulter l'article de la communauté	Aucun	Requête	Non	Non
Amazon SageMaker Infer	Effectuer une inférence à l'aide d'Amazon SageMaker	Aucun fichier README disponible	Aucun article disponible	Aucun	Requête	Non	Oui
Entraînement Amazon SageMaker : algorithme de l'apprenant linéaire	Lancez un job d'entraînement sur Amazon SageMaker à l'aide de l'algorithme Linear Learner.	Aucun fichier README disponible	Aucun article disponible	Aucun	Requête	Non	Oui
Entraînement Amazon SageMaker : XGBoost	Lancez un job d'entraînement sur Amazon SageMaker à l'aide de l'algorithme XGBoost.	Aucun fichier README disponible	Aucun article disponible	Aucun	Requête	Non	Oui
Arrêt d'instance Amazon Web Services EC2	Arrêtez une instance EC2 à l'aide de l'API Amazon EC2.	Afficher le fichier README sur GitHub	Consulter l'article de la communauté	aws_resource_id	Champ, requête	Non	Non
Auger	Utilise le résultat de la requête pour créer un modèle prédictif.	Afficher le fichier README sur GitHub	Voir le fichier README	Aucun	Requête	Non	Oui
Azure Storage	Envoyez et stockez un fichier de données sur Azure Storage.	Afficher le fichier README sur GitHub	Consulter l'article de la communauté	Aucun	Requête	Non	Oui
Braze	L'action Braze vous permet de marquer les utilisateurs dans Braze à l'aide du point de terminaison de l'API REST à partir d'un Look. Assurez-vous qu'un champ braze_id est tagué dans les résultats. MAX EXPORT: 10000.	Afficher le fichier README sur GitHub	Voir le fichier README	braze_id	Requête	Non	Oui
DigitalOcean — Arrêter un droplet	Arrêtez le processus DigitalOcean à l'aide de l'API DigitalOcean.	Afficher le fichier README sur GitHub	Consulter l'article de la communauté	digitalocean_droplet_id	Champ, requête	Non	Non
DigitalOcean Spaces	Envoyez et stockez un fichier de données dans DigitalOcean Storage.	Afficher le fichier README sur GitHub	Consulter l'article de la communauté	Aucun	Requête	Non	Oui
Dropbox	Envoyez et stockez un fichier de données sur Dropbox.	Aucun fichier README disponible	Consulter la documentation	Aucun	Requête	Oui	Non
Audiences personnalisées Facebook	Importez des données dans Facebook Ads Custom Audiences à partir d'une liste de clients.	Afficher le fichier README sur GitHub	Voir le fichier README	Aucun	Requête	Oui	Oui
Firebase	Utilisez Firebase pour envoyer des notifications push sur mobile.	Aucun fichier README disponible	Aucun article disponible	Aucun	Requête	Non	Non
Customer Match de Google Ads	Importez des données dans le ciblage par liste de clients Google Ads.	Afficher le fichier README sur GitHub	Consulter la documentation	Aucun	Requête	Oui	Oui
Importation des données de Google Analytics	Importez des données dans un ensemble de données Google Analytics.	Afficher le fichier README sur GitHub	Voir le fichier README	Aucun	Requête	Oui	Oui
Google Cloud Storage	Écrire des fichiers de données dans un bucket Google Cloud Storage	Afficher le fichier README sur GitHub	Consulter l'article de la communauté	Aucun	Requête	Non	Oui
Google Drive	Envoyer des données à Google Drive.	Aucun fichier README disponible	Consulter la documentation	Aucun	Requête	Oui	Oui
Google Sheets	Envoyer des données CSV vers une Google Sheet.	Aucun fichier README disponible	Consulter la documentation	Aucun	Requête	Oui	Oui
Entreprises HubSpot	Ajoutez des propriétés à vos entreprises à l'aide de l'API Hubspot V3.	Afficher le fichier README sur GitHub	Voir le fichier README	hubspot_company_id	Requête	Non	Oui
Contacts Hubspot	Ajoutez des propriétés à vos contacts à l'aide de l'API Hubspot V3.	Afficher le fichier README sur GitHub	Voir le fichier README	hubspot_contact_id	Requête	Non	Oui
Kloudio	Ajouter des données à une Google Sheet.	Afficher le fichier README sur GitHub	Voir le fichier README	Aucun	Requête	Non	Non
mParticle	Exportez de manière groupée vos données utilisateur ou d'événement de Looker vers mParticle.	Afficher le fichier README sur GitHub	Voir le fichier README	Voir le fichier README	Requête	Non	Oui
Campagnes Salesforce	Ajoutez des contacts ou des prospects à une campagne Salesforce.	Afficher le fichier README sur GitHub	Voir le fichier README	sfdc_contact_id ou sfdc_lead_id	Requête	Oui	Non
Groupe de segments	Ajoutez des caractéristiques et/ou des utilisateurs à vos groupes de segments.	Afficher le fichier README sur GitHub	Consulter la documentation	segment_group_id et user_id, ou segment_group_id et segment_anonymous_id	Requête	Non	Oui
Segment Identify	Ajoutez des caractéristiques à vos utilisateurs Segment à l'aide de la méthode Identify.	Afficher le fichier README sur GitHub	Consulter la documentation	email ou user_id ou segment_anonymous_id ou segment_group_id	Requête	Non	Oui
Segment Track	Connectez-vous à un certain nombre d'intégrations fournies par Segment pour identifier et cibler les utilisateurs pour les workflows marketing.	Afficher le fichier README sur GitHub	Consulter la documentation	email ou user_id ou segment_anonymous_id ou segment_group_id	Requête	Non	Oui
SendGrid	Envoyez des données et planifiez l'envoi des résultats à une adresse e-mail à l'aide de l'API SendGrid.	Afficher le fichier README sur GitHub	Consulter l'article de la communauté	Aucun	Requête	Non	Non
Slack	Envoyez du contenu Looker dans des messages directs, des canaux publics et des canaux privés dans Slack à l'aide d'OAuth. Elle est disponible pour les déploiements hébergés sur Looker à partir de la version 6.24+ avec la fonctionnalité liste autorisée d'adresses IP désactivée.	Aucun fichier README disponible	Consulter la documentation	Aucun	Requête	Oui	Oui
Pièce jointe Slack (jeton d'API)	Envoyez des données directement dans un canal Slack avec les identifiants utilisateur. Vous pouvez également consulter la documentation de Lookerbot pour découvrir d'autres fonctionnalités Slack.	Afficher le fichier README sur GitHub	Consulter la documentation	Aucun	Requête	Non	Non
Teams – Webhook entrant	Envoyez des données à Microsoft Teams à l'aide d'un webhook entrant.	Afficher le fichier README sur GitHub	Voir le fichier README	Aucun	Requête	Non	Non
Tray	Connectez-vous à un certain nombre d'intégrations fournies par Tray.io pour automatiser les workflows.	Afficher le fichier README sur GitHub	Consulter l'article de la communauté	Aucun	Requête	Non	Oui
Twilio — Envoyer des données	Envoyez des données à partir d'un Look ou planifiez l'envoi de résultats à un numéro de téléphone à l'aide de l'API Twilio.	Afficher le fichier README sur GitHub	Consulter l'article de la communauté	Aucun	Requête	Non	Non
Twilio — Envoyer un message	Envoyez un message à une série de numéros de téléphone (colonnes de données taguées comme numéros de téléphone) dans un Look.	Afficher le fichier README sur GitHub	Voir le fichier README	téléphone	Champ, requête	Non	Non
Zapier	Connectez-vous à un certain nombre d'intégrations fournies par Zapier pour automatiser les workflows.	Afficher le fichier README sur GitHub	Consulter l'article de la communauté	Aucun	Requête	Non	Oui

Choisir le format de données

Remarque : 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 d'envoi des données par e-mail de votre instance Looker sur Envoyer un lien uniquement.

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

Consultez le tableau suivant pour savoir comment chaque format est diffusé vers chaque destination.

Format	E-mail	Webhook	Amazon S3	SFTP
Table de données	Table de données dans le corps de l'e-mail, au format HTML	Non disponible pour cette destination	Non disponible pour cette destination	Non disponible pour cette destination
Visualisation	La visualisation dans le corps de l'e-mail sous forme d'image PNG	Non disponible pour cette destination	Non disponible pour cette destination	Non disponible pour cette destination
CSV	Table de données sous forme de fichier texte séparé par une virgule joint	Table de données sous forme de fichier texte séparé par une virgule joint	Table de données sous forme de fichier texte séparé par une virgule joint	Table de données sous forme de fichier texte délimité par des virgules joint
XLSX	Table de données sous forme de fichier Excel joint	Table de données sous forme de fichier Excel joint	Table de données sous forme de fichier Excel joint	Table de données sous forme de fichier Excel joint
JSON : simple	Table de données sous forme de fichier JSON joint. Pour ce format, Looker utilise le nom d'une dimension ou d'une mesure, et non son libellé de champ, comme valeur d'affichage.	Table de données sous forme de fichier JSON joint. Pour ce format, Looker utilise le nom d'une dimension ou d'une mesure, et non son libellé de champ, comme valeur d'affichage.	Table de données sous forme de fichier JSON joint. Pour ce format, Looker utilise le nom d'une dimension ou d'une mesure, et non son libellé de champ, comme valeur d'affichage.	Table de données sous forme de fichier JSON joint. Pour ce format, Looker utilise le nom d'une dimension ou d'une mesure, et non son libellé de champ, comme valeur d'affichage.
JSON : étiquette	Non disponible pour cette destination	Table de données au format JSON. Dans ce format, Looker utilise les libellés de champ comme valeur d'affichage pour le fichier de sortie JSON.	Non disponible pour cette destination	Non disponible pour cette destination
JSON : simple, intégré	Non disponible pour cette destination	Table de données, envoyée directement au format JSON. Pour ce format, Looker utilise le nom d'une dimension ou d'une mesure, et non son libellé de champ, comme valeur d'affichage.	Non disponible pour cette destination	Non disponible pour cette destination
JSON : détaillé, intégré	Non disponible pour cette destination	table de données, envoyée directement au format JSON, avec des détails supplémentaires tels que des métadonnées de champ, des informations sur le cache ou l'heure et la durée d'exécution de la requête. Pour ce format, Looker utilise le nom d'une dimension ou d'une mesure, et non son libellé de champ, comme valeur d'affichage.	table de données, envoyée directement au format JSON, avec des détails supplémentaires tels que des métadonnées de champ, des informations sur le cache ou l'heure et la durée d'exécution de la requête. Pour ce format, Looker utilise le nom d'une dimension ou d'une mesure, et non son libellé de champ, comme valeur d'affichage.	table de données, envoyée directement au format JSON, avec des détails supplémentaires tels que des métadonnées de champ, des informations sur le cache ou l'heure et la durée d'exécution de la requête. Pour ce format, Looker utilise le nom d'une dimension ou d'une mesure, et non son libellé de champ, comme valeur d'affichage.
Texte	Table de données sous forme de fichier texte délimité par des tabulations joint	Table de données sous forme de fichier texte délimité par des tabulations joint	Table de données sous forme de fichier texte délimité par des tabulations joint	Table de données sous forme de fichier texte délimité par des tabulations joint
HTML	Table de données sous forme de fichier HTML joint	Table de données sous forme de fichier HTML joint	Table de données sous forme de fichier HTML joint	Table de données sous forme de fichier HTML joint

Déclenchement de la diffusion

Remarque : Cette option ne s'affiche pas si vous envoyez une exploration ou un envoi ponctuel d'un Look.

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 la planification d'envoi que vous avez définie dans la section Spécifier la récurrence de l'envoi 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 l'envoi après qu'un groupe de données a été déclenché, a géré le cache et a reconstruit les tables PDT pertinentes.

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

Remarque : Cette option ne s'affiche pas si vous envoyez une exploration ou une livraison ponctuelle d'un Look, ou si vous avez spécifié un déclencheur d'intervalle de répétition pour votre livraison 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 à partir de la liste déroulante Select Datagroup (Sélectionner un groupe de données).

Pour planifier le contenu en utilisant 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 de la présentation ou de 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

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

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 planification dans la section Options avancées.

L'heure de fin des intervalles Horaire et Par minute n'est pas inclusive. Le dernier envoi sera effectué au dernier intervalle sélectionné avant l'heure de fin spécifiée. Par exemple, si le contenu est planifié toutes les heures entre minuit et 23h, il sera envoyé à l'heure pile, toutes les heures, de minuit à 22h. Si le contenu est planifié par minute toutes les 30 minutes entre minuit et 23h, le dernier envoi de cette période sera effectué à 22h30.

Remarque : Les envois planifiés basés sur le temps peuvent récupérer les résultats du cache de requêtes. Si une requête précédente a mis en cache un résultat vide avant que les données ne soient disponibles dans la base de données, la planification fournira un fichier vide et affichera toujours l'état Réussi, car la livraison elle-même a réussi. Pour vous assurer que la planification extrait toujours des données actualisées de la base de données, utilisez un déclencheur de groupe de données plutôt qu'une planification standard basée sur le temps.

Conseil : Pour éviter les goulots d'étranglement de simultanéité sur votre instance Looker, évitez de planifier plusieurs envois à la même minute (en particulier au début de l'heure). Échelonnez les planifications à des intervalles de 15 ou 30 minutes (par exemple, à :15, :30 ou :45) plutôt que de les exécuter toutes à :00. Pour en savoir plus, consultez Optimiser les performances du serveur Looker.

Application de filtres à un envoi

Remarque : Cette option ne s'affiche pas si vous envoyez une exploration.

Si vous envoyez une présentation ou un tableau de bord comportant des filtres, vous pouvez modifier les conditions de filtre pour filtrer davantage les résultats envoyés.

Cliquez sur Filtres afin d'afficher et de modifier les filtres associés à la présentation ou au tableau de bord pour l'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 présentations ou tableaux de bord, n'oubliez pas de consulter la section Filtres des présentations 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 envois, 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 de documentation Attributs utilisateur.

Avertissement : Voici quelques points à prendre en compte concernant les Looks avec des conditions de filtre complexes :

• Si vous modifiez un filtre de Look pour lui appliquer une condition complexe (par exemple, en appliquant plusieurs filtres AND au même champ ou plusieurs filtres OR à des champs différents), le filtre devient un filtre complexe et Looker le supprime de la planification.
• Les filtres complexes, qui incluent des filtres AND sur les mêmes champs ou des filtres OR sur différents champs d'un Look, ne sont pas visibles dans la boîte de dialogue de planification. Cependant, ces filtres de Look sont toujours appliqués aux données fournies par la planification.

Application des options de diffusion avancées

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

Format	E-mail		Webhook		Amazon S3		SFTP
Table de données
	Envoyer cette programmation si		Non disponible pour cette destination		Non disponible pour cette destination		Non disponible pour cette destination
	Limite
	Options d'e-mail	Exécuter la programmation en tant que destinataire
		Inclure les liens
	Options de mise en forme	Appliquer les options de visualisation
		Mise en forme des valeurs de données
	Fuseau horaire
Visualisation
	Limite		Non disponible pour cette destination		Non disponible pour cette destination		Non disponible pour cette destination
	Options d'e-mail	Exécuter la programmation en tant que destinataire
		Inclure les liens
	Résolution de la table
	Fuseau horaire
CSV
	Envoyer cette programmation si		Envoyer cette programmation si		Envoyer cette programmation si		Envoyer cette programmation si
	Limite		Limite		Limite		Limite
	Options d'e-mail	Exécuter la programmation en tant que destinataire	Non disponible pour cette destination		Non disponible pour cette destination		Non disponible pour cette destination
		Inclure les liens
	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation
		Mise en forme des valeurs de données		Mise en forme des valeurs de données		Mise en forme des valeurs de données		Mise en forme des valeurs de données
	Fuseau horaire		Fuseau horaire		Fuseau horaire		Fuseau horaire
XLSX
	Envoyer cette programmation si		Envoyer cette programmation si		Envoyer cette programmation si		Envoyer cette programmation si
	Limite		Limite		Limite		Limite
	Options d'e-mail	Exécuter la programmation en tant que destinataire	Non disponible pour cette destination		Non disponible pour cette destination		Non disponible pour cette destination
		Inclure les liens
	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation
		Mise en forme des valeurs de données		Mise en forme des valeurs de données		Mise en forme des valeurs de données		Mise en forme des valeurs de données
	Fuseau horaire		Fuseau horaire		Fuseau horaire		Fuseau horaire
JSON : simple ; JSON : étiquette ; JSON : simple, intégré
	Envoyer cette programmation si		Envoyer cette programmation si		Envoyer cette programmation si		Envoyer cette programmation si
	Limite		Limite		Limite		Limite
	Options d'e-mail	Exécuter la programmation en tant que destinataire	Non disponible pour cette destination		Non disponible pour cette destination		Non disponible pour cette destination
		Inclure les liens
	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation
		Mise en forme des valeurs de données		Mise en forme des valeurs de données		Mise en forme des valeurs de données		Mise en forme des valeurs de données
	Fuseau horaire		Fuseau horaire		Fuseau horaire		Fuseau horaire
JSON : détaillé, intégré	Non disponible pour cette destination		Limite		Limite		Limite
	Non disponible pour cette destination		Fuseau horaire		Fuseau horaire		Fuseau horaire
Texte
	Envoyer cette programmation si		Envoyer cette programmation si		Envoyer cette programmation si		Envoyer cette programmation si
	Limite		Limite		Limite		Limite
	Options d'e-mail	Exécuter la programmation en tant que destinataire	Non disponible pour cette destination		Non disponible pour cette destination		Non disponible pour cette destination
		Inclure les liens
	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation
		Mise en forme des valeurs de données		Mise en forme des valeurs de données		Mise en forme des valeurs de données		Mise en forme des valeurs de données
	Fuseau horaire		Fuseau horaire		Fuseau horaire		Fuseau horaire
HTML
	Envoyer cette programmation si		Envoyer cette programmation si		Envoyer cette programmation si		Envoyer cette programmation si
	Limite		Limite		Limite		Limite
	Options d'e-mail	Exécuter la programmation en tant que destinataire	Non disponible pour cette destination		Non disponible pour cette destination		Non disponible pour cette destination
		Inclure les liens
	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation	Options de mise en forme	Appliquer les options de visualisation
		Mise en forme des valeurs de données		Mise en forme des valeurs de données		Mise en forme des valeurs de données		Mise en forme des valeurs de données
	Fuseau horaire		Fuseau horaire		Fuseau horaire		Fuseau horaire

Envoyer cette programmation si

Pour les envois récurrents de Looks, vous pouvez personnaliser la planification afin de n'envoyer le contenu du Look que lorsque certaines conditions sont remplies. Les alertes fournissent une fonction similaire pour les vignettes de tableau de bord.

Dans le menu déroulant Envoyer cette planification si, indiquez si vous souhaitez envoyer le contenu du Look uniquement s'il y a des résultats, uniquement s'il n'y a pas de résultats, ou dans les deux cas. Par exemple, vous pouvez utiliser des filtres 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 envoyer le contenu uniquement si cette condition est remplie.

Vous pouvez également spécifier qu'un envoi ne doit avoir lieu que si les résultats de la requête ont changé depuis le dernier envoi de données en cochant la case à côté de 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 un tableau : les données sont envoyées en une seule fois.
• Tous les résultats : les données sont diffusées en continu à mesure qu'elles sont renvoyées, en envoyant toutes les lignes de données des résultats de la requête. L'option Tous les résultats n'est visible que par les utilisateurs dont le rôle inclut l'autorisation schedule_without_limit.

Si vous choisissez Results in Table (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

Lors de l'envoi de présentations et d'explorations, vous pouvez limiter la taille de l'e-mail en fonction des restrictions 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. Cette option est la seule disponible pour les e-mails qui utilisent les options de format Table de données ou Visualisation. Looker n'envoie pas d'e-mails contenant plus de 5 000 lignes de données.
• 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). Toutefois, une limite totale de données est imposée aux applications de messagerie. Looker n'envoie pas d'e-mails dont le corps de l'e-mail contient plus de 20 Mo de données ou dont les pièces jointes contiennent plus de 15 Mo de données. 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. L'option Tous les résultats n'est visible que par les utilisateurs dont le rôle inclut l'autorisation schedule_without_limit.

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 Send Test (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 envois par e-mail disposent d'options de livraison supplémentaires : Exécuter la planification en tant que destinataire et Inclure des 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 chacun la diffusion de contenu 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 chaque utilisateur dispose de valeurs de filtre 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 programmation en tant que destinataire est sélectionnée, la requête programmée applique le filtre d'accès users.state = 'California' et envoie les résultats filtrés à l'utilisateur A. Les résultats 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 À qui doit-elle être envoyée ?.

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 (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écution de la planification en tant que destinataire, 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érera une erreur et l'adresse e-mail sera 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 pas envoyée à l'utilisateur désactivé à partir de sa 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 la politique de 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 des liens. Lorsque cette option est cochée, l'envoi des données par e-mail inclut 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. Pour 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 envois qui n'utilisent pas le format "Visualisation" disposent d'options d'envoi 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 données ressemble à un tableau. Tous les paramètres suivants 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 – consultez le post de la communauté Modification de la mise en forme JSON pour en savoir plus sur la façon dont Looker affiche les champs au format JSON)
  • Mise en forme conditionnelle pour les envois de visualisations de graphiques de tableau au format Excel
  Remarque : La mise en forme conditionnelle n'est disponible dans les envois Excel de présentations et d'explorations avec des visualisations sous forme de tableaux que si la règle Le long d'une échelle est appliquée. De plus, la mise en surbrillance au niveau des lignes dans la mise en forme conditionnelle n'est pas compatible avec les exportations Excel. Si votre tableau de bord nécessite une mise en surbrillance au niveau des lignes, utilisez plutôt les formats d'exportation PDF ou image, car ils sont entièrement compatibles avec cette fonctionnalité.

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

Mise en forme des valeurs de données

Remarque : Cette option n'est pas disponible pour les envois de Looks ou d'explorations au format Visualisation.

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

• Sélectionnez Formatted data values (Valeurs de données mises en forme) si vous souhaitez que les données ressemblent davantage à l'expérience d'exploration dans Looker, même si 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

Lors de l'envoi 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 :

• Normal : 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. L'option Tester maintenant ne tient pas compte de certains paramètres des Options avancées, mais respecte les filtres sélectionnés.

Enregistrement de la livraison…

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

Pour les envois ponctuels, lorsque vous avez terminé de configurer les options d'envoi, cliquez sur le bouton Envoyer pour envoyer le contenu immédiatement à la 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 pouvez dupliquer ou supprimer la planification en cliquant respectivement sur l'icône Dupliquer ou Supprimer.

La programmation enregistrée s'affiche également sur la page Schedules You've Created (Programmations que vous avez créées) de votre profil utilisateur, ainsi que sur les pages Schedules (Programmations) et Schedule History (Historique des programmations) du panneau Admin (Administration). 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 planifications que vous avez créées sur la page Planifications que vous avez créées. Pour y accéder, cliquez sur l'icône de votre profil utilisateur, puis sélectionnez Planifications. Pour en savoir plus sur l'affichage et la gestion des planifications que vous avez créées, consultez la page Afficher vos livraisons de données planifiées.

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

Si votre administrateur Looker vous a accordé les autorisations d'afficher les pages d'administration Schedules (Planifications) et Schedule History (Historique des planifications), vous pouvez voir 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

Remarque : Looker planifie les envois de données en fonction du fuseau horaire indiqué dans le paramètre Fuseau horaire de l'application de la page Paramètres de l'administrateur ou, s'il est activé, du paramètre Fuseau horaire spécifique à l'utilisateur du créateur de la planification.

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.

Notez les limites suivantes concernant la diffusion de contenu :

• Si votre entreprise a configuré ses propres paramètres de messagerie 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. Un serveur SMTP externe peut avoir ses propres limites quotidiennes ou par message concernant le nombre de destinataires.
• Selon le paramètre Limite, la livraison 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.
• Bien que Looker ne code pas en dur de limite pour le nombre de destinataires que vous pouvez spécifier dans un envoi par e-mail, si vous configurez votre envoi sur "Exécuter en tant que destinataire ", l'envoi déclenche une requête distincte pour chaque personne. Cette charge peut avoir un impact important sur les performances de la base de données et n'est pas recommandée pour les listes de destinataires volumineuses. Dans la mesure du possible, nous vous recommandons d'utiliser des groupes ou des alias de messagerie.
• 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é 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. Pour en savoir plus sur les désabonnements, consultez ce post de la communauté Looker sur la surveillance des événements de désabonnement du planificateur.

Si l'envoi vers un serveur SFTP échoue, envisagez les possibilités suivantes :

• Lorsque Looker tente d'effectuer une livraison sur un serveur SFTP, la livraison peut être marquée comme terminée dans le panneau de planification et les journaux, même si elle n'arrive pas en raison de problèmes de configuration réseau, tels qu'une liste d'autorisation d'adresses IP incorrecte sur le serveur de destination ou un port sortant fermé sur l'instance Looker. Comme l'historique de planification peut afficher l'état Success malgré ces erreurs, vérifiez toujours les journaux de votre serveur SFTP de destination si vous pensez qu'un envoi est manquant.

• Looker stocke les empreintes SFTP de votre serveur SFTP. Si vous rencontrez des erreurs lors de votre envoi SFTP, les empreintes SFTP sont peut-être invalides. Dans ce cas, contactez votre administrateur Looker.

• L'erreur Net::SSH::Exception. message: could not settle on host_key algorithm est due à une incompatibilité entre les algorithmes de clé hôte proposés par les anciennes versions de Looker (antérieures à Looker 26.2) et les algorithmes de sécurité modernes strictement appliqués par le serveur SFTP cible (comme Red Hat 9 ou Azure Blob Storage SFTP). Si vous recevez cette erreur, vous pouvez la résoudre en mettant à niveau Looker vers la version 26.2 ou une version ultérieure pour prendre en charge les algorithmes SHA-2 modernes (comme ecdsa-sha2-nistp256, rsa-sha2-256 et rsa-sha2-512). Vous pouvez également configurer le serveur SFTP cible pour autoriser au moins une clé hôte ou un algorithme de chiffrement compatible avec votre version actuelle de Looker.

• L'erreur OpenSSL::Cipher::CipherError. Error: authentication tag already generated by cipher peut se produire lorsque des données sont envoyées avec SFTP après la mise à niveau de Looker vers la version 26.2.14 ou une version ultérieure, ou lorsque votre instance se connecte à des services hôtes tels qu'Azure Blob Storage SFTP ou via un proxy. Cette erreur est due à un problème JRuby connu lors de la négociation du chiffrement. Pour résoudre cette erreur, limitez les algorithmes de chiffrement autorisés sur le serveur SFTP de destination à aes256-ctr. Par exemple, modifiez le fichier sshd_config du serveur SFTP pour ajouter ou restreindre la directive Ciphers : Ciphers aes256-ctr.

• Si vous recevez l'erreur Java::JavaLang::NullPointerExceptions lorsque vous transmettez des données à un serveur SFTP, elle peut être due à un bug dans JRuby qui empêche l'utilisation d'algorithmes de courbe elliptique (EC) ou de clés d'hôte pour les connexions SSH de Looker vers des destinations SFTP. Pour éviter tout problème lors de l'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.

• L'erreur Net::SFTP::StatusException (2, 'no such file') se produit si Looker ne peut pas construire correctement le chemin de destination sur le serveur SFTP. Les causes courantes incluent l'utilisation d'un chemin relatif au lieu d'un chemin absolu dans le champ Adresse, l'absence d'une barre oblique finale (/) dans le champ Adresse, ou le nom du Look, du tableau de bord ou de la planification contenant des espaces ou des caractères spéciaux (comme /) qui entraînent des échecs de construction du chemin d'accès. Pour résoudre cette erreur, procédez comme suit :

  • Utilisez des chemins absolus : connectez-vous au serveur SFTP, exécutez pwd pour récupérer le chemin absolu complet, puis saisissez cette valeur dans le champ Adresse de votre planification, en veillant à ce qu'elle se termine par une barre oblique (/).
  • Supprimez les caractères spéciaux : supprimez les barres obliques (/) des noms des Looks, des tableaux de bord et des planifications.
  • Utilisez des noms lisibles par une machine : renommez la programmation pour utiliser des traits de soulignement au lieu d'espaces (par exemple, Report_Name).

• L'erreur Net::SSH::Exception. Error: could not settle on kex algorithm se produit lorsque Looker et le serveur SFTP distant ne parviennent pas à s'accorder sur un algorithme d'échange de clés (KEX) mutuellement compatible, généralement parce que des algorithmes obsolètes sont utilisés d'un côté. Pour résoudre cette erreur, examinez les algorithmes d'échange de clés compatibles avec votre serveur SFTP et assurez-vous qu'ils correspondent aux algorithmes KEX compatibles avec Looker (tels que ecdh-sha2-nistp256, ecdh-sha2-nistp384 ou ecdh-sha2-nistp521).

• Si votre livraison SFTP planifiée échoue avec l'erreur Net::SSH::Exception: could not settle on encryption_client algorithm, cela signifie que votre serveur SFTP et Looker n'ont pas pu s'accorder sur un chiffrement partagé. Looker ne prend plus en charge les chiffrements plus anciens et moins sécurisés tels que CBC (par exemple, aes256-cbc et 3des-cbc). Pour résoudre cette erreur, transmettez ce message d'erreur à l'administrateur de votre serveur SFTP et demandez-lui de mettre à jour le fichier sshd_config du serveur pour activer la prise en charge d'au moins un des algorithmes de chiffrement et d'échange de clés compatibles avec Looker.