Como programar entregas para a integração com o Slack

É possível instalar o aplicativo Looker no seu espaço de trabalho do Slack para enviar ou programar entregas de dados diretamente para canais públicos e privados do Slack. Para permitir a instalação do aplicativo Looker, o proprietário do espaço de trabalho do Slack pode precisar ajustar as configurações de instalação do aplicativo do espaço de trabalho do Slack.

A integração com o Anexo do Slack (Token de API) também está disponível para uso.

Como ativar a integração no Looker Action Hub

Se a instância do Looker atender às condições necessárias, o administrador do Looker precisará ativar a integração do Slack no Hub de ação do Looker (em inglês) para cada instância do Looker antes que os usuários possam enviar dados com a integração do Slack.

  1. No painel Administrador, em Plataforma, acesse a página Ações.
  2. Clique no botão Enable para ativar a integração do Slack no Looker Action Hub.

  3. Na página de ação do Slack, clique em Conectar para se conectar ao espaço de trabalho do Slack.

    O Looker solicitará acesso ao espaço de trabalho do Slack indicado no menu suspenso no canto superior direito da página. Para conectar vários espaços de trabalho do Slack a uma única instância do Looker, clique no link + Connect to Slack workspace.

  4. Clique em Permitir e volte para a página de ação do Slack.

  5. Clique na chave Ativar e em Salvar.

Como gerenciar conexões de espaço de trabalho do Slack com o Looker

É possível gerenciar as conexões de espaço de trabalho do Slack na instância a partir da página de ações do Slack. Clique no botão Settings ao lado da integração do Slack na página Actions no painel Admin.

Os administradores podem realizar as seguintes operações em cada conexão de espaço de trabalho do Slack: "Connect", "Disconnect" e "Reset".

  • Para conectar outros espaços de trabalho do Slack à instância do Looker, clique no link + Connect to Slack workspace.

  • Para desconectar uma conexão de espaço de trabalho do Slack, clique no botão Disconnect e em OK na mensagem de aviso pop-up. Você não precisa clicar em Salvar na página de ação do Slack para salvar essas configurações. A ação ainda aparecerá como Ativada, mesmo se nenhum espaço de trabalho do Slack estiver conectado.

  • Para atualizar a conexão do espaço de trabalho do Slack sem precisar desconectar e reconectar, clique no botão Reset.

Como autenticar no espaço de trabalho do Slack

Os usuários precisam fazer a autenticação no mesmo espaço de trabalho do Slack que o administrador do Looker conectou. Os usuários também precisam ser membros atuais do espaço de trabalho para se autenticarem no Looker.

É possível autenticar em um espaço de trabalho do Slack pela primeira vez nos seguintes locais:

Você recebe uma mensagem de confirmação do Slack depois da autenticação no Looker.

Como autenticar em um espaço de trabalho do Slack na página "Conta"

  1. No Looker, clique no ícone do perfil do usuário no canto superior direito da tela e selecione Conta.
  2. Todas as integrações ativadas para sua instância são exibidas em Integrações. Se o administrador do Looker tiver ativado pelo menos um espaço de trabalho no Slack, um botão Fazer login com o Slack será exibido. Se o administrador do Looker tiver conectado mais de um espaço de trabalho do Slack à sua instância do Looker, uma lista de espaços de trabalho será exibida com opções para fazer login em cada um deles.
  3. O Looker solicitará acesso ao espaço de trabalho do Slack. Se o administrador do Looker tiver conectado vários espaços de trabalho do Slack à sua instância do Looker, um menu suspenso será exibido no canto superior direito da página OAuth. Selecione o espaço de trabalho apropriado do Slack no menu suspenso. Clique em Permitir.
  4. Quando você voltar à página Conta, será exibida uma opção na seção Integrações. Com ela, você poderá revogar as credenciais do Slack referentes aos espaços de trabalho a que estiver conectado. Cuidado: não revogue seu token do Slack. Caso contrário, qualquer programação criada falhará.

Agora que está autenticado, você pode enviar ou agendar painéis, aparências e explorações. Consulte a seção Como entregar dados ao Slack nesta página para mais informações.

Como autenticar em um espaço de trabalho do Slack pela janela Enviar ou Programar

  1. No Looker, navegue até o conteúdo a ser exibido, clique no menu de engrenagem e depois em Enviar ou Programar. Para painéis, selecione Programar entrega.
  2. Na janela Enviar ou Programar de uma exploração ou uma visualização, selecione a ação Slack como o destino de entrega em Para onde esses dados devem ir?. Para painéis, selecione Programar entrega na janela Programar e enviar.
  3. Ao lado de Slack, clique em Log in.
  4. O Looker solicitará acesso ao espaço de trabalho do Slack. Se o administrador do Looker tiver conectado vários espaços de trabalho do Slack à sua instância do Looker, um menu suspenso será exibido no canto superior direito da página OAuth. Selecione o espaço de trabalho apropriado do Slack no menu suspenso. Clique em Permitir.
  5. A janela Enviar ou Programar (ou a janela Programar entrega para painéis) agora mostra as opções de entrega do Slack, incluindo os canais público e privado do seu espaço de trabalho do Slack.

Como fornecer dados ao Slack

É possível enviar conteúdo para um dos vários espaços de trabalho do Slack. Depois que um administrador do Looker configura as conexões de espaço de trabalho, você pode fazer login em cada um deles na página Conta do usuário. Em seguida, é possível selecionar um espaço de trabalho de destino entre os listados na lista suspensa Espaços de trabalho do pop-up Enviar ou Programar ou em Programar janela de entrega para painéis.

O exemplo abaixo mostra opções de formatação para a exibição de um painel, que incluem:

  • PDF
  • Visualização (PNG)
  • Arquivo ZIP CSV

O envio ou a programação de uma visualização ou uma exploração têm diferentes opções de formatação disponíveis, incluindo:

  • CSV
  • XLSX
  • JSON: simples: nesse formato, o Looker usa o nome do campo de uma dimensão ou medida como o valor renderizado em vez do rótulo do campo.
  • JSON — Rótulo: neste formato, o Looker usa o campo labels como valor renderizado na saída JSON.
  • JSON: simples e in-line: neste formato, o Looker usa o nome do campo de uma dimensão ou uma medida como seu valor renderizado em vez do rótulo do campo.
  • JSON: detalhado e in-line: neste formato, o Looker usa o nome de campo de uma dimensão ou medida como o valor renderizado em vez do rótulo do campo.
  • Texto
  • HTML

Para exibir um painel definido pelo usuário, um painel LookML, um Look ou um Explore, navegue até seu conteúdo e execute estas etapas:

  1. Clique no menu de roda dentada e clique em Enviar ou Programar. Você não terá a opção de agendar uma exploração. Para painéis, selecione Programar entrega no menu de três pontos.
  2. Na janela Enviar ou Programar, selecione a integração do Slack como o destino de entrega em Para onde esses dados devem ir? Para painéis, selecione a integração do Slack como o destino de entrega em Destination. Se esta é a primeira vez que você usa a integração com o Slack, é necessário primeiro fazer a autenticação no espaço de trabalho do Slack.
  3. O Looker exibe opções de entrega específicas para os espaços de trabalho do Slack conectados a esta instância do Looker.
    • No campo Share In, digite o nome do canal do Slack em que você quer postar seus dados. Você pode enviar mensagens diretas ou para canais públicos ou privados. Inclua o caractere # inicial, por exemplo, #Vendas.
    • No campo Comentário, digite qualquer texto que você queira incluir com o envio. Você também pode usar a formatação avançada do Slack com análise especial para mencionar grupos, usuários ou canais específicos ou para fazer outras menções especiais.
    • No campo Filename, digite um nome para o arquivo de anexo.
  4. Se você estiver programando uma entrega de dados, clique em Salvar tudo. Sua consulta ou painel será entregue no Slack conforme programado. Se você estiver enviando seus dados, clique em Enviar. Os dados serão enviados para seu canal do Slack.

Como acessar o Looker no Slack

Para acessar os dados do Looker no Slack:

Como compartilhar links para conteúdo do Looker no Slack

Você pode compartilhar links para visualizações do SQL Runner, painéis definidos pelo usuário, painéis do LookML, Looks (mas não Looks incorporados publicamente) ou explorações no Slack.

O link aparece no Slack para mostrar o título e alguns metadados do conteúdo, que é visível apenas para quem tem acesso ao conteúdo subjacente. Depois que o link for revelado, você ou outros usuários poderão:

  • Poste um link para o conteúdo no Looker e um resumo do conteúdo no canal. Clique em Postar neste canal. Depois que o conteúdo for postado no canal, qualquer pessoa no canal poderá ver o resumo e o título do conteúdo, mesmo que não tenha acesso ao conteúdo subjacente no Looker.
  • Adicione o conteúdo a uma pasta Favoritos do Looker e clique em Adicionar aos favoritos. Depois que você adicionar conteúdo à sua pasta Favorites, o aplicativo Looker no Slack exibirá uma mensagem com um link para acessar a pasta Favorites no Looker.

Se você tiver várias instâncias do Looker conectadas ao espaço de trabalho, será necessário definir a instância padrão para corresponder à instância da qual você está compartilhando o link.

Como usar comandos de barra para recuperar informações do Looker no Slack

Se o Lookerbot também estiver ativado, talvez seja necessário renomear alguns comandos de barra. Os comandos personalizados do Slack não estão disponíveis para a integração do Slack, mas é possível configurar comandos personalizados no Lookerbot. Verifique se você está usando a versão 0.0.16 ou mais recente do Lookerbot ao atualizar o repositório do Looker no GitHub, conforme as instruções na seção Primeiros passos com o Looker da página Práticas recomendadas do Lookerbot para Slack.

Use os seguintes comandos de barra para recuperar informações do Looker e postá-las no Slack:

  • /looker e /looker whoami: o aplicativo Looker no Slack saúda você pelo nome; informa a instância do Looker a que você está conectado e fornece links para sua pasta Favoritos do Looker, para sua pasta pessoal e para a Ajuda.
  • /looker help: o aplicativo Looker no Slack lista comandos de barra compatíveis.
  • /looker favorites: o aplicativo Looker no Slack lista o conteúdo da sua pasta Favoritos do Looker. Clique nas reticências (...) ao lado de cada conteúdo para acessar um menu no qual você pode Postar neste canal ou Remover dos favoritos.
  • /looker folder: o aplicativo Looker no Slack lista o conteúdo da sua pasta pessoal. Clique nas reticências (...) ao lado de cada conteúdo para acessar um menu no qual você pode Postar neste canal ou Remover dos favoritos (se o conteúdo também estiver na sua pasta Favoritos).
  • /looker select: o aplicativo Looker no Slack lista as instâncias conectadas ao espaço de trabalho do Slack. Para definir uma instância padrão do espaço de trabalho do Slack, clique nela nessa lista. Todos os comandos de barra específicos da instância se aplicam à instância padrão do Looker.

Como visualizar a guia "Início" do aplicativo Looker no Slack

Para ver uma lista dos seus conteúdos e pastas favoritos do Looker no Slack, clique na guia Página inicial do aplicativo Looker.

Se você definir uma instância padrão do Looker para seu espaço de trabalho do Slack, só verá o conteúdo dessa instância na guia Página inicial do aplicativo Looker.

Como definir uma instância padrão do Looker para seu espaço de trabalho no Slack

Se o administrador do Looker tiver conectado apenas uma instância do Looker ao seu espaço de trabalho no Slack, essa instância será o padrão.

Se o administrador do Looker tiver conectado várias instâncias do Looker ao seu espaço de trabalho do Slack, você poderá definir uma delas como a instância padrão. Todos os comandos de barra específicos da instância (a maioria dos comandos além de /looker help) e o desenrolamento de link se aplicam à instância padrão.

  1. No Slack, execute o comando de barra /looker select para ver uma lista das instâncias do Looker conectadas ao espaço de trabalho do Slack.

  2. O app Looker pergunta Qual instância você quer definir como padrão? Clique no botão correspondente ao nome da instância do Looker para defini-la como padrão.

    O aplicativo Looker confirmará sua seleção.

Para alternar sua instância padrão do Looker, execute /looker select novamente e selecione uma instância diferente. Será preciso alternar as instâncias padrão se você estiver desvinculando os links de uma instância do Looker que não seja a padrão. Se você não alternar as instâncias e tentar descompactar um link de uma instância não padrão do Looker, será necessário fazer login nessa instância.