Usar o Azure Boards com o Slack

Serviços do Azure DevOps

Se você usa o Slack, poderá usar o aplicativo Azure Boards para Slack para criar itens de trabalho e monitorar a atividade do item de trabalho em seu projeto do Azure Boards a partir do canal do Slack.

O aplicativo Azure Boards para Slack permite que os usuários configurem e gerenciem assinaturas no canal do Slack. É possível gerenciar assinaturas para criar e atualizar outros eventos de item de trabalho. Os usuários também podem receber notificações para esses eventos no canal do Slack. As conversas no canal do Slack podem ser usadas para criar itens de trabalho. As pré-visualizações para URLs de item de trabalho ajudam os usuários a iniciar discussões sobre o trabalho.

Pré-requisitos

Adicionar o aplicativo Azure Boards ao workspace do Slack

1. Para instalar o aplicativo Azure Boards no workspace do Slack, abra um navegador da Web, entre no Slack e abra o aplicativo Azure Boards.

2. Depois de adicionado, uma mensagem de boas-vindas é exibida no app conforme mostrado na imagem a seguir.

   

3. Use o identificador do /azboards Slack para interagir com o aplicativo. Uma lista de comandos é fornecida posteriormente neste artigo: Referência de comandos.

Vincular seu projeto do Azure Boards ao aplicativo Azure Boards

Para usar o aplicativo, primeiro você deve vincular seu projeto do Azure Boards ao canal do Slack.

1. Depois que o aplicativo for instalado no workspace do Slack, conecte-se e autentique-se no Azure Boards.

   

2. Depois de entrar, use o seguinte comando de barra dentro de um canal do Slack para vincular ao projeto de Azure Boards que você especificar com a URL:

   /azboards link [project url]
   

   Por exemplo:

   /azboards link https://dev.azure.com/myorg/myproject
   

Depois que o projeto estiver vinculado, você poderá criar itens de trabalho usando o comando /azboards create ou as ações de mensagem.

Configurar assinaturas para monitorar itens de trabalho

Você pode criar assinaturas para monitorar itens de trabalho a qualquer momento usando o comando /azboards subscriptions. Você tem a opção de configurar assinaturas logo após vincular um projeto.

1. Selecione o caminho de área desejado, o evento no qual você está interessado e use os filtros associados para personalizar o seu canal do Slack. Para configurar assinaturas com facilidade, os caminhos de área acessados recentemente são mostrados na lista suspensa Caminho de área.

   

   Caso o caminho da área da sua equipe não apareça no menu suspenso Caminho de área, siga as instruções mencionadas na próxima seção, Adicionar caminhos de área. Os caminhos de área adicionados usando o comando /azboards addAreapath e caminhos de área para os quais as assinaturas foram criadas no canal do Slack sempre aparecem na lista suspensa Caminho de área com os caminhos de área acessados recentemente.

Adicionar caminhos de área

Você pode adicionar ao canal as áreas em que sua equipe trabalha para que estejam sempre disponíveis para criar itens de trabalho e assinaturas. Essa ação é importante principalmente para as equipes com mais de 100 caminhos de área.

• Use o comando a seguir para adicionar caminhos de área do projeto ao canal do Slack.

  /azboards addAreapath [area path]
  

  Por exemplo:

  /azboards addAreapath myproject\fabrikam
  

  

• Se você escolher o nome do projeto como seu caminho de área, receberá notificações para todos os caminhos de área no projeto. É logicamente equivalente a escolher o caminho de área "Qualquer".

Criar um item de trabalho com um comando

1. Com o aplicativo Azure Boards, você pode criar itens de trabalho do canal. O aplicativo também dá suporte a itens de trabalho personalizados.

• Para criar um item de trabalho, use /azboards create.

  

2. Você pode criar itens de trabalho diretamente com um comando ao passar o tipo de item de trabalho e o título como parâmetros. Os itens de trabalho serão criados somente se não tiverem nenhum campo a ser preenchido obrigatoriamente.

   /azboards create [work item type] [work item title]
   

   Por exemplo:

   /azboards create 'user story' Push cloud monitoring alerts to mobile devices
   

Criar um item de trabalho com base em ações de mensagem

Muitas vezes as discussões em um canal exigem a criação de itens de trabalho. Você pode usar ações de mensagem para criar um item de trabalho. A mensagem selecionada é preenchida previamente na seção de descrição do item de trabalho. Um link de retorno à conversa no canal é armazenado na seção Discussão do item de trabalho recém-criado, proporcionando aos usuários o acesso à discussão que levou à criação do item de trabalho.

• Para criar itens de trabalho usando ações de mensagem

  

Gerenciar assinaturas do Azure Boards

1. Para exibir, adicionar e remover assinaturas de um canal, use o /azboards subscriptions comando:

   /azboards subscriptions
   

   Esse comando lista todas as assinaturas atuais do canal e permite adicionar novas assinaturas ou remover as existentes. Como parte da adição de assinaturas, você também pode personalizar sobre o que será notificado usando vários filtros.

Visualizações de URLs de itens de trabalho

Para dar suporte à colaboração em torno de itens de trabalho discutidos em um canal, é exibida uma visualização dos itens de trabalho referenciados no canal. Quando um usuário cola a URL do item de trabalho, é mostrada uma visualização semelhante à imagem a seguir. Esta visualização ajuda a manter as conversas relacionadas ao item de trabalho relevantes e corretas.

Para que esse recurso funcione, os usuários precisam estar conectados. Depois de fazerem login, esse recurso funciona para todos os canais em um workspace.

Desvincular um projeto de um canal

Um canal do Slack só pode ser vinculado a um projeto do Azure Boards por vez. Para vincular a um projeto diferente, primeiro você deve desvincular o projeto atual usando o comando /azboards unlink.

Desvincular um projeto exclui todas as assinaturas e caminhos de área adicionados do canal. Se o canal não tiver assinaturas, qualquer usuário poderá desvincular um projeto. Mas se um canal tiver assinaturas, somente os administradores do projeto poderão desvincular o projeto de um canal.

Referência do comando

A tabela a seguir lista todos os comandos /azboards que você pode usar no canal do Slack.

Gerenciar o trabalho em canais privados

O aplicativo Azure Boards para Slack também pode ajudar a criar itens de trabalho e monitorar a atividade de itens de trabalho em seus canais privados. Para convidar o bot para o seu canal privado, insira /invite @azboards. Depois de postar isso, você pode criar itens de trabalho e gerenciar suas notificações da mesma maneira como faria para um canal público.

Solucionar problemas de erros

Se você estiver enfrentando os seguintes erros ao usar o aplicativo Azure Boards para Slack, siga os procedimentos nesta seção.

Falha na configuração. Verifique se a organização '{nome da organização}' existe e se você tem permissões suficientes.

Para resolver esse problema de autenticação, conclua as seguintes etapas:

1. Saia do Azure DevOps acessando https://aka.ms/VsSignout pelo seu navegador.

2. Abra uma janela do navegador InPrivate (Microsoft Edge) ou Incógnito (Chrome).

3. Acesse https://aex.dev.azure.com/me e entre com suas credenciais.

4. Selecione o diretório correto no menu suspenso abaixo do ícone de perfil. Escolha o diretório que contém a organização com o projeto que você deseja vincular.

   

5. No mesmo navegador, inicie uma nova guia, navegue até https://slack.com e entre no workspace (use o cliente Web). Execute o /azboards signout comando seguido pelo /azboards signin comando.

Se essas etapas não resolverem o problema de autenticação, entre em contato conosco na Comunidade de Desenvolvedores.

Conteúdo relacionado

• Definir caminhos de área e atribuir a uma equipe
• Usar o Azure Pipelines com o Slack
• Usar o Azure Repos com o Slack
• Criar um gancho de serviço para o Azure DevOps com o Slack