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 l'espace de travail Slack devra peut-être modifier les paramètres d'installation associés.

L'intégration de Slack n'est pas disponible pour les instances hébergées par le client.
L'intégration à Slack est disponible pour les déploiements hébergés sur Looker qui remplissent les conditions suivantes:

L'intégration du pièce jointe Slack (jeton d'API) reste également disponible.

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, avant que les utilisateurs puissent fournir des données avec l'intégration Slack.

  1. Dans le panneau Admin, sous Plate-forme, accédez à la page Actions.
  2. Cliquez sur le bouton Enable (Activer) pour activer l'intégration Slack dans Looker Action Hub.

  3. 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 même instance Looker, cliquez sur le lien + Se connecter à l'espace de travail Slack.

  4. Cliquez sur Allow (Autoriser), puis revenez à la page d'action Slack.

  5. Cliquez sur le bouton Activer, puis sur Enregistrer.

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

Vous pouvez gérer les connexions de 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 à un espace de travail Slack: Connect (Se 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 d'espace de travail Slack existante, cliquez sur le bouton Déconnecter, puis sur OK dans le message pop-up d'avertissement. 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 la connexion à votre espace de travail Slack sans avoir à la déconnecter et à la 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 :

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

  1. Dans Looker, cliquez sur votre icône de profil utilisateur en haut à droite de l'écran, puis sélectionnez Account (Compte).
  2. 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, le bouton Se connecter avec Slack s'affiche. Si votre administrateur Looker a connecté plusieurs espaces de travail Slack à votre instance Looker, une liste des espaces de travail s'affiche avec des options de connexion à chacun d'eux.
  3. 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).
  4. Sur votre page Compte, une option vous permet désormais de révoquer vos identifiants Slack pour tous les espaces de travail auxquels vous êtes connecté.

Veillez à ne pas révoquer votre jeton Slack. Dans ce cas, 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 Fournir des données à Slack.

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

  1. Dans Looker, accédez au contenu à envoyer, cliquez sur le menu représenté par une roue dentée, puis sur Envoyer ou Programmer.
  2. Dans la fenêtre Envoyer ou Planifier, sélectionnez l'action Slack comme destination de la livraison sous Où ces données doivent-elles être placées ?.
  3. À côté de Slack, cliquez sur Connexion.
  4. 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).
  5. La fenêtre Envoyer ou Programmer affiche maintenant les options de distribution de Slack, y compris les canaux publics et privés de votre espace de travail Slack. 

Envoi de données à Slack

Pour fournir des données à l'intégration à Slack, un administrateur Looker doit d'abord accorder aux utilisateurs l'autorisation send_to_integration et activer l'intégration Slack dans Looker Action Hub. Les utilisateurs doivent également s'authentifier dans le ou les espaces de travail Slack que l'administrateur a connectés à Looker.

Vous pouvez fournir du contenu sur un ou plusieurs espaces de travail Slack. Une fois qu'un administrateur Looker a configuré les connexions de l'espace de travail, vous pouvez vous y connecter depuis votre page Compte. Vous pouvez ensuite sélectionner un espace de travail de destination dans la liste déroulante Espaces de travail du pop-up Envoyer ou Planifier.

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 un nom de champ de dimension ou de mesure comme valeur de rendu au lieu du libellé du champ.
  • JSON : libellé : dans ce format, Looker utilise le champ labels comme valeur de rendu dans sa sortie JSON.
  • JSON – Simple, intégré: dans ce format, Looker utilise un nom de champ de dimension ou de mesure comme valeur affichée au lieu du libellé du champ.
  • JSON – Affichage détaillé et intégré: dans ce format, Looker utilise un nom de champ de dimension ou de mesure comme valeur affichée au lieu du libellé du champ.
  • Texte
  • HTML

Pour envoyer une exploration au format PDF ou PNG, enregistrez la présentation dans un tableau de bord et planifiez le tableau de bord au format désiré. Pour planifier une exploration, vous devez d'abord l'enregistrer en tant que présentation.

Pour envoyer ou planifier une présentation au format PDF ou PNG, enregistrez-la dans un tableau de bord et planifiez ce dernier au format désiré.

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 :

  1. Cliquez sur le menu représenté par une roue dentée, puis sur Envoyer ou Programmer. (Vous n'aurez pas la possibilité de planifier une exploration.)
  2. Dans la fenêtre Envoyer ou Planifier, sélectionnez l'intégration Slack comme destination de la livraison sous Où ces données doivent-elles être stockées ?. Si vous utilisez l'intégration Slack pour la première fois, vous devez d'abord vous authentifier dans l'espace de travail Slack.
  3. 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. Saisissez le caractère # (par exemple, #Ventes).
    • Dans le champ Commentaire, saisissez le texte à inclure dans la diffusion.
      • Pour mentionner un utilisateur, incluez <@user_ID>, que vous pouvez copier en cliquant sur le bouton ... de son profil utilisateur Slack.
      • Pour mentionner un groupe, incluez <@group_ID>, que vous pouvez copier à partir de l'URL du navigateur lorsque vous êtes sur le profil du groupe.
      • Pour mentionner une chaîne spécifique, incluez <#channel_ID>, que vous pouvez copier à partir de l'URL du navigateur lorsque vous y êtes.
      • Pour les autres mentions spéciales, utilisez <!here>, <!channel> ou <!everyone>.
    • Dans le champ Nom de fichier, saisissez un nom pour le fichier en pièce jointe.
  4. Si vous planifiez l'envoi des 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 :

Partage de liens vers du contenu Looker dans Slack

Vous pouvez partager des liens vers les visualisations SQL Runner, les tableaux de bord définis par l'utilisateur (y compris les anciens tableaux de bord), les tableaux de bord LookML, les looks (mais pas les modèles intégrés publiquement) ou les explorations dans Slack.

Le lien s'affiche dans Slack pour afficher le titre du contenu et certaines métadonnées, qui ne sont visibles que par les personnes 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 membres de celle-ci peuvent consulter l'instantané et le titre du contenu, 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 pour 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 à 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 le mettant à jour à partir du dépôt Lookerbot GitHub, comme indiqué dans la section Mettre à jour l'application Lookerbot de l'article 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 indique son nom, vous indique l'instance Looker à laquelle vous êtes connecté, et fournit des liens vers votre dossier Favoris Looker, votre dossier personnel et l'Aide.
  • /looker help : l'application Looker dans Slack liste les commandes à barre oblique compatibles.
  • /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 cet article sur cette chaîne ou le supprimer des favoris.
  • /looker folder : l'application Looker dans Slack liste le contenu de votre dossier personnel Looker. Cliquez sur les points de suspension (...) à côté de chaque contenu pour accéder au menu dans lequel vous pouvez publier cet article sur cette chaîne ou le supprimer des favoris (si le contenu se trouve également dans votre dossier Favoris).
  • /looker select : l'application Looker dans Slack répertorie 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 préférés 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 voyez que le contenu de cette instance dans l'onglet Accueil de l'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 autres que /looker help) et le déploiement de lien s'appliquent à l'instance par défaut.

  1. Dans Slack, exécutez la commande à barre oblique /looker select pour afficher la liste des instances Looker connectées à votre espace de travail Slack.

  2. 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.