Notez que vous consultez la documentation Looker. Pour accéder à la documentation sur Looker Studio, consultez la page https://support.google.com/looker-studio.

Cette page a été traduite par l'API Cloud Translation.

Planification d'envois à l'intégration Slack

Vous pouvez installer l'application Looker dans votre espace de travail Slack afin d'envoyer ou de planifier des envois de données directement dans des chaînes publiques et privées Slack. Pour activer l'installation de l'application Looker, le propriétaire de votre espace de travail Slack devra peut-être ajuster les paramètres d'installation de l'application pour votre espace de travail Slack.

L'intégration de Pièce jointe Slack (jeton d'API) peut également être utilisée.

Activation de l'intégration dans Looker Action Hub

Si votre instance Looker répond aux conditions requises, votre administrateur Looker doit activer l'intégration Slack dans Action Hub, pour chaque instance Looker, avant que les utilisateurs puissent envoyer des données avec l'intégration Slack.

Dans le panneau Administration, sous Plate-forme, accédez à la page Actions.
Cliquez sur le bouton Activer pour activer l'intégration Slack dans Looker Action Hub.
Sur la page d'action Slack, cliquez sur Se connecter pour vous connecter à votre espace de travail Slack.

Looker demandera accès à l'espace de travail Slack qui est indiqué dans le menu déroulant en haut à droite de la page. Pour connecter plusieurs espaces de travail Slack à une seule instance Looker, cliquez sur le lien + Se connecter à l'espace de travail Slack.
Cliquez sur Autoriser, puis revenez à la page d'action Slack.
Cliquez sur le bouton bascule Activer, puis sur Enregistrer.

Gestion des connexions entre l'espace de travail Slack et Looker

Vous pouvez gérer les connexions à l'espace de travail Slack de votre instance depuis la page d'action Slack. Cliquez sur le bouton Paramètres à côté de l'intégration Slack sur la page Actions du panneau Administration.

Les administrateurs peuvent effectuer les opérations suivantes avec chaque connexion à l'espace de travail Slack : Connecter, Déconnecter et Réinitialiser.

Pour connecter d'autres espaces de travail Slack à l'instance Looker, cliquez sur le lien + Se connecter à l'espace de travail Slack.
Pour déconnecter une connexion existante à un espace de travail Slack, cliquez sur le bouton Déconnecter, puis sur OK lorsque le message d'avertissement s'ouvre. Vous n'avez pas besoin de cliquer sur Enregistrer sur la page d'action Slack pour enregistrer ces paramètres. L'action apparaîtra toujours comme Activée, même si aucun espace de travail Slack n'est connecté.
Pour actualiser votre connexion à l'espace de travail Slack sans avoir à vous déconnecter et reconnecter, cliquez sur le bouton Réinitialiser.

Authentification dans votre espace de travail Slack

Les utilisateurs doivent s'authentifier dans l'espace de travail Slack que votre administrateur Looker a connecté à Looker. Ils doivent également être membres de l'espace de travail pour pouvoir s'authentifier depuis Looker.

Vous pouvez vous authentifier pour la première fois sur un espace de travail Slack depuis :

Page "Compte" (Il s'agit de l'unique option si plusieurs espaces de travail Slack sont connectés à votre instance Looker.)
Fenêtre Send (Envoyer) ou Schedule (Programmer).

Vous recevez un message de confirmation de Slack une fois que vous serez authentifié sur Slack depuis Looker.

Authentification à un espace de travail Slack depuis la page Compte

Dans Looker, cliquez sur votre icône de profil utilisateur en haut à droite de l'écran, puis sélectionnez Account (Compte).
Toutes les intégrations activées pour votre instance apparaissent sous Intégrations. Si votre administrateur Looker a autorisé au moins un espace de travail Slack, un bouton Se connecter avec Slack s'affiche. Si votre administrateur Looker a connecté plusieurs espaces de travail Slack à votre instance Looker, une liste d'espaces de travail s'affiche, avec des options permettant de se connecter à chacun d'eux individuellement.
Looker demandera accès à l'espace de travail Slack. Si votre administrateur Looker a connecté plusieurs espaces de travail Slack à votre instance Looker, un menu déroulant apparaît en haut à droite de la page OAuth. Sélectionnez l'espace de travail Slack approprié dans le menu déroulant. Cliquez sur Autoriser.
Lorsque vous revenez à la page Compte, une option s'affiche dans la section Intégrations. Elle vous permet de révoquer vos identifiants Slack pour tous les espaces de travail auxquels vous êtes connecté. Attention : Faites attention à ne pas révoquer votre jeton Slack. Si vous le faites, toutes les planifications que vous avez créées échoueront.

Maintenant que vous êtes authentifié, vous pouvez envoyer ou planifier des tableaux de bord, des présentations et des explorations. Pour en savoir plus, consultez la section Envoyer des données à Slack sur cette page.

Authentification à un espace de travail Slack depuis la fenêtre d'envoi ou de planification

Dans Looker, accédez au contenu à fournir, cliquez sur le menu en forme de roue dentée, puis sur Envoyer ou Planifier. Pour les tableaux de bord, sélectionnez Planifier l'envoi.
Dans la fenêtre Envoyer ou Planifier d'une exploration ou d'une présentation, sélectionnez l'action Slack comme destination d'envoi sous Où envoyer ces données ?. Pour les tableaux de bord, sélectionnez Planifier l'envoi dans la fenêtre de programmation et d'envoi.
À côté de Slack, cliquez sur Se connecter.
Looker demandera accès à l'espace de travail Slack. Si votre administrateur Looker a connecté plusieurs espaces de travail Slack à votre instance Looker, un menu déroulant apparaît en haut à droite de la page OAuth. Sélectionnez l'espace de travail Slack approprié dans le menu déroulant. Cliquez sur Autoriser.
La fenêtre Envoyer ou Planifier (ou la fenêtre Planifier l'envoi pour les tableaux de bord) affiche désormais vos options d'envoi Slack, y compris les chaînes publiques et privées de votre espace de travail Slack.

Envoi de données à Slack

Vous pouvez fournir du contenu sur un ou plusieurs espaces de travail Slack. Une fois qu'un administrateur Looker a configuré les connexions à l'espace de travail, vous pouvez vous connecter à chacune d'elles depuis votre page Compte utilisateur. Vous pouvez ensuite sélectionner un espace de travail de destination parmi ceux listés dans le menu déroulant Espaces de travail du pop-up Envoyer ou Planifier, ou Plage de diffusion planifiée pour les tableaux de bord.

Les options de mise en forme pour la distribution d'un tableau de bord sont les suivantes :

PDF
Visualisation (PNG)
Fichier CSV zippé

L'envoi ou la planification d'une présentation ou d'une exploration propose des options de mise en forme différentes, dont :

CSV
XLSX
JSON — Simple: dans ce format, Looker utilise le nom de champ d'une dimension ou d'une mesure comme valeur affichée plutôt que l'étiquette du champ.
JSON – Étiquette: dans ce format, Looker utilise les étiquettes des champs comme valeur affichée dans sa sortie JSON.
JSON : simple, intégré : dans ce format, Looker utilise le nom d'une dimension ou d'une mesure comme valeur d'affichage, et non son libellé.
JSON : détaillé, intégré : dans ce format, Looker utilise le nom d'une dimension ou d'une mesure comme valeur d'affichage, et non son libellé.
Texte
HTML

Pour fournir un tableau de bord défini par un utilisateur, un tableau de bord LookML, une présentation ou une exploration, accédez à votre contenu puis effectuez les étapes suivantes :

Cliquez sur le menu représenté par une roue dentée, puis sur Envoyer ou Planifier. (Vous n'aurez pas la possibilité de planifier une exploration.) Pour les tableaux de bord, sélectionnez Planifier la diffusion dans le menu à trois points du tableau de bord.
Dans la fenêtre Send (Envoyer) ou Schedule (Planifier), sélectionnez l'intégration Slack comme destination d'envoi sous Where should this data go? (Où ces données doivent-elles aller ?). Pour les tableaux de bord, sélectionnez l'intégration Slack comme destination de diffusion sous Destination. Si vous utilisez l'intégration Slack pour la première fois, vous devez d'abord vous authentifier dans l'espace de travail Slack.
Looker affiche des options d'envoi spécifiques à l'espace de travail ou aux espaces de travail Slack connectés à cette instance Looker.
- Dans le champ Partager dans, saisissez le nom de la chaîne Slack où publier vos données. Vous pouvez envoyer des messages directs ou des messages sur des chaînes publiques ou privées. Incluez le caractère # au début, par exemple, #Vente.
- Dans le champ Commentaire, saisissez le texte que vous souhaitez inclure avec l'envoi. Vous pouvez également utiliser la mise en forme avancée de Slack avec une analyse spéciale pour mentionner des groupes, des utilisateurs ou des canaux spécifiques, ou pour effectuer d'autres mentions spéciales.
- Dans le champ Nom de fichier, saisissez un nom pour la pièce jointe.
Si vous planifiez un envoi de données, cliquez sur Enregistrer tout. Votre requête ou tableau de bord sera envoyé à Slack comme prévu. Si vous envoyez vos données, cliquez sur Envoyer. Vos données seront envoyées vers votre chaîne Slack.

Accès à Looker depuis Slack

Vous pouvez accéder aux données de Looker dans Slack en effectuant l'une des actions suivantes :

Partager des liens vers du contenu Looker
Utiliser des commandes à barre oblique pour récupérer des informations Looker dans Slack
Afficher l'onglet Accueil de votre application Looker dans Slack

Partage de liens vers du contenu Looker dans Slack

Vous pouvez partager des liens vers des visualisations SQL Runner, des tableaux de bord définis par l'utilisateur, des tableaux de bord LookML, des présentations (mais pas des présentations intégrées publiquement) ou des explorations dans Slack.

Le lien se déroule dans Slack pour afficher le titre du contenu et certaines métadonnées, qui sont visibles uniquement pour les utilisateurs qui ont accès au contenu sous-jacent. Une fois que le lien se déroule, vous ou d'autres utilisateurs pouvez :

Pour publier un lien vers le contenu dans Looker et un aperçu du contenu sur la chaîne, cliquez sur Publier sur cette chaîne. Une fois le contenu publié sur la chaîne, tous les utilisateurs de la chaîne peuvent en voir l'instantané et le titre, même s'ils n'ont pas accès au contenu sous-jacent dans Looker.
Ajoutez le contenu à un dossier de Favoris Looker : cliquez sur Ajouter aux favoris. Une fois que vous avez ajouté du contenu à votre dossier Favoris, l'application Looker dans Slack affiche un message avec un lien permettant d'accéder à votre dossier Favoris dans Looker.

Si plusieurs instances Looker sont connectées à l'espace de travail, vous devez définir l'instance par défaut afin qu'elle corresponde à l'instance Looker à partir de laquelle vous partagez le lien.

L'utilisation de commandes barre oblique pour récupérer des informations Looker dans Slack

Si vous avez également activé Lookerbot, vous devrez peut-être renommer certaines commandes avec barre oblique. Les commandes Slack personnalisées ne sont pas disponibles pour l'intégration Slack mais vous pouvez configurer des commandes personnalisées dans Lookerbot. Assurez-vous d'utiliser la version 0.0.16 ou ultérieure de Lookerbot en effectuant la mise à jour à partir du dépôt GitHub de Lookerbot, comme indiqué dans la section Premiers pas avec Lookerbot de la page des bonnes pratiques sur l'utilisation de Lookerbot pour Slack.

Utilisez les commandes barre oblique suivantes pour récupérer des informations de Looker et les publier sur Slack :

/looker et /looker whoami : l'application Looker dans Slack vous accueille par votre nom ; vous indique l'instance Looker à laquelle vous êtes connecté, et fournit des liens vers votre dossier Looker Favorites (Favoris), vers votre dossier personnel, et vers Help (Aide).
/looker help : l'application Looker dans Slack répertorie les commandes barre oblique prises en charge.
/looker favorites : l'application Looker dans Slack répertorie le contenu de votre dossier Favoris Looker. Cliquez sur les points de suspension (...) à côté de chaque contenu pour accéder à un menu à partir duquel vous pouvez Publier sur cette chaîne ou Supprimer des Favoris.
/looker folder : l'application Looker dans Slack répertorie le contenu de votre dossier personnel Looker. Cliquez sur les points de suspension (...) à côté de chaque contenu pour accéder à un menu à partir duquel vous pouvez Publier sur cette chaîne ou Supprimer des Favoris (si le contenu se trouve également dans votre dossier Favoris).
/looker select : l'application Looker dans Slack répertorie la ou les instances connectées à cet espace de travail Slack. Pour définir une instance par défaut pour votre espace de travail Slack, cliquez dessus dans cette liste. Toutes les commandes barre oblique spécifiques à une instance s'appliqueraient à l'instance Looker par défaut.

L'affichage de l'onglet Accueil de votre application Looker dans Slack

Pour afficher la liste de vos contenus et dossiers Looker favoris dans Slack, cliquez sur l'onglet Home (Accueil) de l'application Looker.

Si vous définissez une instance Looker par défaut pour votre espace de travail Slack, seul le contenu de cette instance s'affichera dans l'onglet Accueil de votre application Looker.

Définition d'une instance Looker par défaut pour votre espace de travail Slack

Si votre administrateur Looker a connecté une seule instance Looker à votre espace de travail Slack, cette instance est définie par défaut.

Si votre administrateur Looker a connecté plusieurs instances Looker à votre espace de travail Slack, vous pouvez définir l'une des instances comme l'instance Looker par défaut. Toutes les commandes barre oblique spécifiques à une instance (la plupart des commandes, à l'exception de /looker help) et le déploiement des liens s'appliqueraient à l'instance par défaut.

Dans Slack, exécutez la commande à barre oblique /looker select pour afficher la liste des instances Looker connectées à votre espace de travail Slack.
L'application Looker demande : Quelle instance souhaitez-vous définir comme instance par défaut ? Cliquez sur le bouton correspondant au nom de l'instance Looker pour définir cette instance comme l'instance par défaut.

L'application Looker confirme votre sélection.

Pour changer d'instance Looker par défaut, exécutez à nouveau /looker select et sélectionnez une autre instance Looker. Vous devez changer d'instance par défaut si vous déployez des liens à partir d'une instance Looker qui n'est pas l'instance par défaut. Si vous ne changez pas d'instance et que vous essayez de dérouler un lien à partir d'une instance Looker différente de l'instance par défaut, vous serez invité à vous connecter à cette instance Looker.