Notez que vous consultez actuellement la documentation de 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 permettre l'installation de l'application Looker, le propriétaire de votre espace de travail Slack devra peut-être modifier les paramètres d'installation de l'application pour votre espace de travail Slack.

L'intégration des pièces jointes Slack (jeton d'API) peut également être utilisée.

Activation de l'intégration dans Looker Action Hub

Si votre instance Looker remplit les conditions requises, votre administrateur Looker doit activer l'intégration Slack dans Looker 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 Enable (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 associer plusieurs espaces de travail Slack à une seule instance Looker, cliquez sur le lien + Se connecter à l'espace de travail Slack.
Cliquez sur Autoriser et revenez à la page d'action Slack.
Cliquez sur le bouton bascule Activer, puis cliquez 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 l'instance depuis la page d'action Slack. Cliquez sur le bouton Settings (Paramètres) à côté de l'intégration Slack sur la page Actions du panneau Admin.

Pour chaque connexion à un espace de travail Slack, les administrateurs peuvent effectuer les opérations suivantes : "Connecter", "Déconnecter" et "Réinitialiser".

Pour associer 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 à un espace de travail Slack existante, cliquez sur le bouton Déconnecter, puis sur OK dans le message d'avertissement qui s'affiche dans la fenêtre pop-up. Il n'est pas nécessaire de cliquer sur Enregistrer sur la page d'action Slack pour enregistrer ces paramètres. L'action reste activée, même si aucun espace de travail Slack n'est connecté.
Pour actualiser votre connexion à votre espace de travail Slack sans le déconnecter, puis le 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 Envoyer ou 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 l'icône de votre profil utilisateur en haut à droite de l'écran, puis sélectionnez Compte.
Toutes les intégrations activées pour votre instance apparaissent sous Intégrations. Si votre administrateur Looker a activé 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 et permet de s'y connecter 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 Allow (Autoriser).
Lorsque vous revenez à la page Account (Compte), une option apparaît maintenant dans la section Integrations (Intégrations) et vous permet de révoquer vos identifiants Slack pour tous les espaces de travail auxquels vous êtes connecté. Attention: Veillez à 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 Looks et des explorations. Pour en savoir plus, consultez la section Envoyer des données à Slack de cette page.

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

Dans Looker, accédez au contenu à envoyer, cliquez sur le menu en forme de roue dentée, puis sur Envoyer ou Planifier. Dans les tableaux de bord, sélectionnez Planifier l'envoi.
Dans la fenêtre Envoyer ou Planifier d'une exploration ou d'un Look, sélectionnez l'action Slack comme destination d'envoi sous Où ces données doivent-elles aller ?. Pour les tableaux de bord, sélectionnez Planifier l'envoi dans la fenêtre Planifier et envoyer.
À 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 Allow (Autoriser).
La fenêtre Envoyer ou Planifier (ou la fenêtre Programmer l'envoi pour les tableaux de bord) affiche désormais vos options d'envoi Slack, y compris les canaux public et privé 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 à chacun d'eux depuis votre page Compte utilisateur. Vous pouvez ensuite sélectionner un espace de travail de destination parmi ceux listés dans la liste déroulante Espaces de travail du pop-up Envoyer ou Planifier, ou Planifier l'envoi pour les tableaux de bord.

L'exemple ci-dessous montre des options de mise en page pour la distribution d'un tableau de bord, notamment :

PDF
Visualisation (PNG)
Fichier zip CSV

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 de rendu plutôt que le libellé du champ.
JSON – Étiquette: dans ce format, Looker utilise des libellés de champ comme valeur de rendu dans sa sortie JSON.
JSON – Simple, Inline: dans ce format, Looker utilise le nom du champ d'une dimension ou d'une mesure comme valeur de rendu plutôt que le libellé du champ.
JSON – Détaillé, intégré: dans ce format, Looker utilise le nom du champ d'une dimension ou d'une mesure comme valeur de rendu plutôt que le libellé du champ.
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 en forme de roue dentée, puis sur Envoyer ou Programmer. (Vous n'aurez pas la possibilité de planifier une exploration.) Pour les tableaux de bord, sélectionnez Planifier l'envoi dans le menu à trois points du tableau de bord.
Dans la fenêtre Envoyer ou Planifier, sélectionnez l'intégration Slack comme destination de diffusion sous 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 sur laquelle publier vos données. Vous pouvez envoyer des messages directs ou des messages sur des chaînes publiques ou privées. Ajoutez le caractère # au début, par exemple #Sales.
- Dans le champ Commentaire, saisissez le texte que vous souhaitez inclure dans l'envoi. Vous pouvez également utiliser la mise en forme avancée de Slack avec des analyses spéciales pour mentionner des groupes, des utilisateurs ou des chaînes spécifiques, ou pour mentionner toute autre mention spéciale.
- Dans le champ Nom de fichier, saisissez le nom du fichier en pièce jointe.
Si vous planifiez l'envoi de données, cliquez sur Tout enregistrer. 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 l'application Looker dans Slack

Partage de liens vers du contenu Looker dans Slack

Dans Slack, vous pouvez partager des liens vers des visualisations de l'exécuteur SQL, des tableaux de bord définis par l'utilisateur, des tableaux de bord LookML, des apparences (mais pas des Looks intégrés publiquement) ou des explorations dans Slack.

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

Publiez un lien vers le contenu dans Looker et un instantané du contenu de la chaîne : cliquez sur Publier sur cette chaîne. Une fois le contenu publié sur la chaîne, tous les utilisateurs peuvent en consulter 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 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 dans Slack 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 Lookerbot est également activé, vous devrez peut-être renommer certaines commandes à 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 une mise à jour à partir du dépôt GitHub Lookerbot, comme indiqué dans la section Premiers pas avec Lookebot de la page des bonnes pratiques Utiliser 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 salue par votre nom, vous indique l'instance Looker à laquelle vous êtes connecté et fournit des liens vers votre dossier Favorites (Favoris) Looker, vers votre dossier personnel et vers l'Aide.
/looker help : l'application Looker dans Slack répertorie les commandes à barre oblique compatibles.
/looker favorites : l'application Looker dans Slack répertorie le contenu de votre dossier Favorites (Favoris) Looker. Cliquez sur les points de suspension (...) à côté de chaque contenu pour accéder à un menu à partir duquel vous pouvez Publier un post 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 un message 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 dossiers et contenus Looker préférés dans Slack, cliquez sur l'onglet Accueil de l'application Looker.

Si vous définissez une instance Looker par défaut pour votre espace de travail Slack, le contenu de cette instance n'est affiché que 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 à l'instance (la plupart des commandes à l'exception de /looker help) et le déploiement de lien s'appliquent à 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 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.