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 ses paramètres d'installation.

L'intégration du rattachement de Slack (jeton d'API) est é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 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 Administration, sous Plate-forme, accédez à la page Actions.
  2. Cliquez sur le bouton Activer pour activer l'intégration de Slack dans Looker Action Hub.

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

  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. Sur la page Actions du panneau Administration, cliquez sur le bouton Paramètres à côté de l'intégration à Slack.

Les administrateurs peuvent effectuer les opérations suivantes pour 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 à un 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 à vous déconnecter et à vous reconnecter, cliquez sur le bouton Reset (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 l'icône de votre profil utilisateur en haut à droite de l'écran, puis sélectionnez Compte.
  2. Toutes les intégrations activées pour votre instance s'affichent 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, la liste des espaces de travail s'affiche avec des options pour vous connecter à chacun d'eux individuellement.
  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. 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. Sinon, les planifications que vous avez créées échoueront.

Maintenant que vous êtes authentifié, vous pouvez envoyer ou planifier des tableaux de bord, des styles 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

  1. Dans Looker, accédez au contenu à diffuser, cliquez sur le menu représenté par une roue dentée, puis sur Envoyer ou Programmer. Pour les tableaux de bord, sélectionnez Planifier l'envoi.
  2. Dans la fenêtre Envoyer ou Programmer pour "Explorer" ou "Regarder", sélectionnez l'action Slack comme destination de la livraison sous Où ces données doivent-elles être stockées ? Pour les tableaux de bord, sélectionnez Planifier l'envoi dans la période d'envoi et d'envoi.
  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 (ou la fenêtre Planifier l'envoi des tableaux de bord) affiche à présent les options de distribution de 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 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, ou dans la fenêtre Planifier l'envoi des 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 du champ d'une dimension ou d'une mesure plutôt que le libellé du champ.
  • JSON : libellé : dans ce format, Looker utilise le champ labels comme valeur affichée dans sa sortie JSON.
  • JSON – Simple, inline: dans ce format, Looker utilise le nom du champ d'une dimension ou d'une mesure 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 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 :

  1. 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.
  2. Dans la fenêtre Envoyer ou Programmer, sélectionnez l'intégration Slack comme destination de la livraison sous Où ces données doivent-elles être stockées ?. Pour les tableaux de bord, sélectionnez l'intégration Slack comme destination de livraison 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.
  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 dans 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 #Sales.
    • Dans le champ Commentaire, saisissez le texte que vous souhaitez inclure dans la diffusion. Vous pouvez également utiliser le formatage avancé de Slack avec une analyse spéciale pour mentionner des groupes, des utilisateurs ou des chaînes spécifiques, ou pour effectuer d'autres mentions spéciales.
    • Dans le champ Nom du fichier, saisissez un nom pour le fichier joint.
  4. Si vous planifiez une diffusion 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 :

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 looks (mais pas des looks intégrés publiquement) ou des explorations dans Slack.

Dans Slack, le lien affiche 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 que le contenu est publié sur la chaîne, n'importe quel utilisateur peut voir l'instantané et le titre du contenu, même s'il n'a 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 de sorte 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 de Lookerbot ou une version ultérieure en effectuant la mise à jour à partir du dépôt GitHub de Lookerbot, comme indiqué dans la section Premiers pas avec Lookebot de la page 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 l'icône représentant des points de suspension (...) à côté de chaque contenu pour accéder à un menu qui vous permet de publier l'album sur cette chaîne ou de 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 à un menu qui vous permet de le publier sur cette chaîne ou de le supprimer des favoris (si le contenu se trouve également dans le 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 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 propres à 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 associations depuis une instance Looker autre que 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.