Agendamento de entregas para a integração com o Slack

Você pode instalar o app Looker no espaço de trabalho do Slack para enviar ou programar entregas de dados diretamente para canais públicos e privados do Slack. Para ativar a instalação do app Looker, o proprietário do espaço de trabalho do Slack talvez precise ajustar as configurações de instalação do app para esse espaço.

A integração Slack Attachment (API Token) 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 Looker Action Hub, para cada instância do Looker, antes que os usuários possam enviar dados com essa integração.

  1. No painel Administrador em Plataforma, acesse a página Ações.
  2. Clique no botão Ativar para ativar a integração com o 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 + Conectar ao espaço de trabalho do Slack.

  4. Clique em Allow e retorne à página de ação do Slack.

  5. Clique na chave Ativar e em Salvar.

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

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

Os administradores podem realizar as seguintes operações com cada conexão do Slack Workspace: conectar, desconectar e redefinir.

  • Para conectar outros espaços de trabalho do Slack à instância do Looker, clique no link + Conectar ao espaço de trabalho do Slack.

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

  • Para atualizar sua conexão do Slack Workspace sem desconectar e reconectar, clique no botão Reset.

Como autenticar no seu 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 ao Looker. Os usuários também precisam ser membros do espaço de trabalho para fazer a autenticação usando o Looker.

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

Você recebe uma mensagem de confirmação do Slack depois de se autenticar no Slack usando o Looker.

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

  1. No Looker, clique no ícone do perfil de usuário no canto superior direito da tela e selecione Conta.
  2. Todas as integrações ativadas para sua instância aparecem em Integrações. Se o administrador do Looker tiver ativado pelo menos um espaço de trabalho do Slack, o botão Fazer login com o Slack vai aparecer. Se o administrador do Looker conectar mais de um espaço de trabalho do Slack à sua instância do Looker, uma lista de espaços de trabalho vai aparecer com opções para fazer login em cada um individualmente.
  3. O Looker vai 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 vai aparecer no canto superior direito da página OAuth. Selecione o espaço de trabalho do Slack adequado na lista suspensa. Clique em Permitir.
  4. Quando você voltar à página Conta, vai aparecer uma opção na seção Integrações para revogar suas credenciais do Slack para todos os espaços de trabalho a que você se conectou. Cuidado: tome cuidado para não revogar seu token do Slack. Se fizer isso, qualquer programação que você criou falhará.

Agora que está autenticado, é possível enviar ou programar dashboards, Looks e Explores. Consulte a seção Como entregar dados para o Slack nesta página para mais informações.

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

  1. No Looker, acesse o conteúdo a ser entregue, clique no menu de engrenagem e selecione Enviar ou Programar. Para painéis, selecione Programar entrega.
  2. Na janela Enviar ou Programar de uma Análise ou um Look, selecione a ação Slack como 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 vai 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 vai aparecer no canto superior direito da página OAuth. Selecione o espaço de trabalho do Slack adequado na lista suspensa. Clique em Permitir.
  5. A janela Enviar ou Agendar (ou a janela Programar entrega nos painéis) agora mostra as opções de entrega do Slack, incluindo os canais públicos e privados do espaço de trabalho do Slack.

Como entregar dados para o Slack

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

Estas são as opções de formatação para enviar um dashboard:

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

O envio ou a programação de um Look ou uma Análise têm diferentes opções de formatação disponíveis, incluindo:

  • CSV
  • XLSX
  • JSON: simples: nesse formato, o Looker usa o nome de um campo de dimensão ou medição como o valor renderizado em vez do rótulo do campo.
  • JSON — Rótulo: nesse formato, o Looker usa rótulos de campo como o valor renderizado na saída JSON.
  • JSON: simples, inline: nesse formato, o Looker usa o nome do campo de uma dimensão ou medida como valor renderizado em vez do rótulo do campo.
  • JSON: detalhado, inline: nesse formato, o Looker usa o nome do campo de uma dimensão ou medição como o valor renderizado em vez do rótulo do campo.
  • Textos
  • HTML

Para exibir um dashboard definido pelo usuário, um dashboard do LookML, um Look ou uma Análise, navegue até o conteúdo e siga estas etapas:

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

Como acessar o Looker no Slack

Você pode acessar os dados do Looker no Slack das seguintes formas:

Como compartilhar links para o 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 Análises no Slack.

O link é aberto no Slack para mostrar o título do conteúdo e alguns dos metadados dele, que ficam visíveis apenas para quem tem acesso ao conteúdo. Depois que o link for alterado, 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 é publicado no canal, qualquer pessoa no canal pode conferir o resumo e o título do conteúdo, mesmo que não tenha acesso ao conteúdo no Looker.
  • Adicione o conteúdo a uma pasta Favorites do Looker e clique em Add to Favorites. Depois que você adicionar conteúdo à pasta Favorites, o app Looker no Slack exibirá uma mensagem no Slack 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, defina a instância padrão para que ela corresponda à instância do Looker que você está usando para compartilhar o link.

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

Se você também tiver o Lookerbot 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 com o Slack, mas é possível configurar comandos personalizados no Lookerbot. Verifique se você está usando o Lookerbot versão 0.0.16 ou posterior atualizando no repositório do Lookerbot no GitHub, conforme instruído na seção Introdução ao Lookebot da página Como usar o 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 app Looker no Slack cumprimenta você pelo nome, informa a instância do Looker a que você está conectado e fornece links para sua pasta Favorites do Looker, para sua pasta pessoal e para a seção Help.
  • /looker help: o app Looker no Slack lista os comandos de barra compatíveis.
  • /looker favorites: o app Looker no Slack lista o conteúdo da pasta Favorites do Looker. Clique nas reticências (...) ao lado de cada conteúdo para acessar um menu no qual é possível Postar neste canal ou Remover dos favoritos.
  • /looker folder: o app Looker no Slack lista o conteúdo da sua pasta pessoal do Looker. Clique nas reticências (...) ao lado de cada conteúdo para acessar um menu em que é possível Postar neste canal ou Remover dos favoritos (se o conteúdo também estiver na pasta Favoritos).
  • /looker select: o aplicativo Looker no Slack lista as instâncias conectadas a esse espaço de trabalho do Slack. Para definir uma instância padrão para seu espaço de trabalho do Slack, clique nela nesta lista. Todos os comandos de barra específicos da instância se aplicam à instância padrão do Looker.

Visualizar a guia inicial do app Looker no Slack

Para conferir uma lista das suas pastas e conteúdos favoritos do Looker no Slack, clique na guia Página inicial do app Looker.

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

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

Se o administrador do Looker conectou apenas uma instância do Looker ao espaço de trabalho do Slack, ela é o padrão.

Se o administrador do Looker conectou várias instâncias do Looker ao espaço de trabalho do Slack, é possível definir uma das instâncias como padrão. Qualquer comando de barra específico da instância (a maioria dos comandos além de /looker help) e o desenrolamento de links 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 seu espaço de trabalho do Slack.

  2. O app Looker vai perguntar 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 app Looker vai confirmar a seleção.

Para mudar a instância padrão do Looker, execute /looker select novamente e selecione outra instância. Mude as instâncias padrão se estiver desenrolando links de uma instância do Looker que não seja a padrão. Se você não mudar de instância e tentar liberar um link de uma instância não padrão do Looker, vai precisar fazer login nela.