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 com o Slack Attachment (API Token) também está disponível para uso.

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ções do Looker 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 Ativar para ativar a integração do Slack no Hub de ações do Looker.

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

    O Looker vai 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 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 de espaço de trabalho do Slack: 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 a conexão do seu espaço de trabalho do Slack sem precisar desconectar e conectar novamente, clique no botão Redefinir.

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

Você pode fazer a autenticação em um espaço de trabalho do Slack pela primeira vez no:

Você vai receber uma mensagem de confirmação do Slack depois de fazer a autenticação no Slack pelo 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 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 no menu suspenso. 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 criada falhará.

Agora que você fez a autenticação, pode enviar ou programar dashboards, Looks e Análises detalhadas. Consulte a seção Como enviar 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, navegue até o conteúdo a ser enviado, clique no menu de engrenagem e em Enviar ou Programar. Para painéis, selecione Programar entrega.
  2. Na janela Enviar ou Programar de uma Análise detalhada ou um Look, selecione a ação Slack como o destino de entrega em Para onde esses dados devem ser enviados?. 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 do OAuth. Selecione o espaço de trabalho do Slack no menu suspenso. Clique em Permitir.
  5. A janela Enviar ou Programar (ou a janela Programar entrega para painéis) agora mostra suas opções de envio do Slack, incluindo os canais públicos e privados do seu espaço de trabalho do Slack.

Como entregar dados para o Slack

Você pode 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, selecione um espaço de trabalho de destino entre os listados no menu suspenso Espaços de trabalho do pop-up Enviar ou Programar ou na Janela de envio da programação dos 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 detalhada tem 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 labels como valor renderizado na saída JSON.
  • JSON: simples, 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.
  • 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.
  • Texto
  • 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.
  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 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 envio específicas para o espaço de trabalho ou os espaços de trabalho conectados a essa 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, insira qualquer texto que você queira incluir na entrega. 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 fazer outras menções especiais.
    • No campo Nome do arquivo, insira 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 você estiver enviando seus dados, clique em Enviar. Seus dados serão enviados para seu canal do Slack.

Como acessar o Looker no Slack

Para acessar os dados do Looker no Slack, faça o seguinte:

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 Análises no Slack.

O link é aberto no Slack para mostrar o título do conteúdo e alguns dos metadados, que só são visíveis para quem tem acesso ao conteúdo. Depois que o link for alterado, você ou outros usuários poderão:

  • Publique um link para o conteúdo no Looker e um instantâneo do conteúdo no canal. Clique em Publicar neste canal. Depois que o conteúdo é postado no canal, qualquer pessoa nele pode acessar o conteúdo e o título, 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 de adicionar conteúdo à pasta Favoritos, o app do Looker no Slack mostra uma mensagem com um link para acessar a pasta Favoritos 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 você pode configurar comandos personalizados no Lookerbot. Atualize a partir do repositório do GitHub do Lookerbot, conforme instruído na seção Como começar com o Lookerbot da página de práticas recomendadas Usar o Lookerbot para Slack.

Use os comandos de barra a seguir para extrair informações do Looker e publicá-las no Slack:

  • /looker e /looker whoami: o aplicativo Looker no Slack cumprimenta você pelo nome. informa a instância do Looker a que você está conectado; e fornece links para a pasta Favorites do Looker, para a pasta pessoal e para a seção Help.
  • /looker help: o app Looker no Slack lista os comandos de barra inválidos.
  • /looker favorites: o app Looker no Slack lista o conteúdo da sua pasta Favoritos. Clique nas reticências (...) ao lado de cada conteúdo para acessar um menu em que você pode Postar neste canal ou Remover dos favoritos.
  • /looker folder: o app 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 em que é possível Postar neste canal ou Remover dos favoritos (se o conteúdo também estiver na pasta Favoritos).
  • /looker select: o app Looker no Slack lista as instâncias conectadas a esse espaço de trabalho. 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 dos seus conteúdos e pastas favoritos do Looker no Slack, clique na guia Início no app.

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 seu 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, exceto /looker help) e a abertura de links seriam aplicados à instância padrão.

  1. No Slack, execute o comando de barra /looker select para conferir uma lista das instâncias do Looker conectadas ao seu 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 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 ser necessário fazer login nela.