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 autoriser 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 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 remplit les conditions requises, votre administrateur Looker doit activer l'intégration Slack dans le Looker Action Hub pour chaque instance Looker afin 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 de Slack dans Looker Action Hub.
Sur la page d'action Slack, cliquez sur 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 l'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 Admin.

Les administrateurs peuvent effectuer les opérations suivantes avec chaque connexion à l'espace de travail Slack: connexion, déconnexion et réinitialisation.

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 à l'espace de travail Slack existante, cliquez sur le bouton Déconnecter, puis sur OK dans le message d'avertissement qui s'affiche. 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 :

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 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 Integrations (Intégrations). Si votre administrateur Looker a activé au moins un espace de travail Slack, un bouton Se connecter avec Slack s'affichera. Si votre administrateur Looker a connecté plusieurs espaces de travail Slack à votre instance Looker, la liste des espaces de travail s'affiche avec des options pour vous 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: 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 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 à envoyer, 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ù 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 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 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 à chacune d'elles depuis votre page Compte utilisateur. Vous pouvez ensuite sélectionner un espace de travail de destination parmi ceux répertoriés dans la liste déroulante Espaces de travail de la fenêtre pop-up Envoyer ou Planifier, ou dans la fenêtre Planifier l'envoi pour les tableaux de bord.

Les options de mise en forme pour la diffusion 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 du champ d'une dimension ou d'une mesure comme valeur affichée plutôt que l'étiquette du champ.
JSON – Détaillé, intégré: dans ce format, Looker utilise le nom de champ d'une dimension ou d'une mesure comme valeur affichée 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 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 l'envoi 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 du canal Slack sur lequel 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, #Ventes).
- 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 analyse spéciale pour mentionner des groupes, des utilisateurs ou des chaînes spécifiques, ou pour faire d'autres mentions spéciales.
- Dans le champ Nom de fichier, saisissez un nom pour la 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 le 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 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 :

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 Looker Favorites (Favoris) en cliquant sur Add to Favorites (Ajouter aux favoris). Une fois que vous avez ajouté du contenu à votre dossier Favorites (Favoris), l'application Looker dans Slack affiche dans Slack un message contenant un lien permettant d'accéder à votre dossier Favorites (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 Lookerbot version 0.0.16 ou ultérieure 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 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, vous ne verrez que le contenu de cette instance 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) ainsi que le déploiement de liens 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 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.