Utilizar a aplicação Azure Boards com o Slack para gerir itens de trabalho

Azure DevOps Services

Se utilizar o Slack, pode utilizar a aplicação Azure Boards para Slack para criar itens de trabalho e monitorizar a atividade de itens de trabalho no projeto do Azure Boards a partir do canal do Slack.

A aplicação Azure Boards para Slack permite aos utilizadores configurar e gerir subscrições no respetivo canal do Slack. Podem gerir subscrições para criar, atualizar e outros eventos de itens de trabalho. Os utilizadores também podem receber notificações para estes eventos no respetivo canal do Slack. As conversas no canal do Slack podem ser utilizadas para criar itens de trabalho. As pré-visualizações para URLs de itens de trabalho ajudam os utilizadores a iniciar debates sobre o trabalho.

Leia este artigo para saber como:

• Adicionar a aplicação Azure Boards à área de trabalho do Slack
• Ligar e desassociar o projeto do Azure Boards à aplicação Azure Boards
• Configurar subscrições para eventos relacionados com itens de trabalho no seu canal do Slack
• Criar itens de trabalho a partir do seu canal do Slack
• Monitorizar a atividade de itens de trabalho no seu canal do Slack
• Obter notificações em canais privados do Slack

Nota

• A integração do Azure Boards e do Slack só é suportada para os Serviços de DevOps do Azure.
• Atualmente, as notificações não são suportadas dentro de mensagens diretas.

Pré-requisitos

• Para criar um item de trabalho, tem de ser um contribuidor para o projeto Azure Boards. Se ainda não tiver um projeto, pode inscrever-se e criar um projeto. Para obter mais informações, veja Começar a utilizar os Quadros do Azure.
• Para criar subscrições num canal do Slack para eventos de itens de trabalho, tem de ser membro do grupo Administradores de Projetos do Azure Boards ou do grupo Administradores de Equipa. Para ser adicionado, veja Alterar permissões ao nível do projeto ou Adicionar Administrador de Equipa.
• Para receber notificações, o acesso da aplicação de terceiros através da definição OAuth tem de estar ativado para a organização. Veja Alterar políticas de acesso a aplicações para a sua organização

Adicionar a aplicação Azure Boards à área de trabalho do Slack

1. Para instalar a aplicação Azure Boards na área de trabalho do Slack, abra um browser, inicie sessão no Slack e abra a aplicação Azure Boards.

2. Depois de adicionado, verá uma mensagem de boas-vindas da aplicação, conforme mostrado na imagem seguinte.

   

3. Utilize a alça do /azboards Slack para interagir com a aplicação. Uma lista de comandos é fornecida mais adiante neste artigo, Referência de comandos.

Ligar o projeto do Azure Boards à aplicação Azure Boards

Para utilizar a aplicação, primeiro tem de ligar o projeto Azure Boards ao seu canal do Slack.

1. Assim que a aplicação estiver instalada na área de trabalho do Slack, ligue-se e autentique-se nos Quadros do Azure.

   

2. Depois de iniciar sessão, utilize o seguinte comando de barra dentro de um canal do Slack para ligar ao projeto Azure Boards que especificar com o URL:

    /azboards link [project url]
   

   Por exemplo:

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

Assim que o projeto estiver ligado, pode criar itens de trabalho com /azboards create o comando ou utilizar ações de mensagens.

Configurar subscrições para monitorizar itens de trabalho

Pode criar subscrições para monitorizar itens de trabalho em qualquer altura com o /azboards subscriptions comando . Tem a opção de configurar subscrições logo após ligar um projeto.

1. Selecione o caminho de área pretendido, o evento no qual está interessado e utilize os filtros associados para personalizar o seu canal do Slack. Para configurar facilmente subscrições, os caminhos de área acedidos recentemente são apresentados na lista pendente do caminho da área.

   

   Caso o caminho da área da sua equipa não apareça no menu pendente Caminho da área, siga as instruções mencionadas na secção seguinte, Adicionar caminhos de área. Os caminhos de área adicionados através dos /azboards addAreapath caminhos de comando e área para os quais as subscrições são criadas no canal do Slack aparecem sempre na lista pendente Caminho da área juntamente com os caminhos de área acedidos recentemente.

Adicionar caminhos de área

Pode adicionar áreas em que a sua equipa trabalha no canal para que estejam sempre disponíveis para criar itens de trabalho e subscrições. Isto é importante principalmente para as equipas com mais de 100 caminhos de área.

• Utilize o seguinte comando para adicionar caminhos de área do projeto ao canal slack.

    /azboards addAreapath [area path]
  

  Por exemplo:

    /azboards addAreapath myproject\fabrikam
  

  

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

Criar um item de trabalho com um comando

1. Com a aplicação Azure Boards, pode criar itens de trabalho a partir do seu canal. A aplicação também suporta itens de trabalho personalizados.

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

  

2. Pode criar itens de trabalho diretamente a partir de um comando ao transmitir o tipo de item de trabalho e o título como parâmetros. Os itens de trabalho são criados apenas se não tiverem campos para serem preenchidos de forma obrigatória.

    /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 a partir de ações de mensagens

Muitas vezes, os debates num canal exigem a criação de itens de trabalho. Pode utilizar ações de mensagens para criar um item de trabalho. A mensagem selecionada é pré-preenchida na secção descrição do item de trabalho. Uma ligação para a conversação no canal é armazenada na secção Debate do item de trabalho recentemente criado, dando aos utilizadores acesso ao debate que levou à criação do item de trabalho.

• Para criar itens de trabalho com ações de mensagens

  

Gerir subscrições do Azure Boards

1. Para ver, adicionar e remover subscrições de um canal, utilize o /azboards subscriptions comando:

    /azboards subscriptions
   

   Este comando lista todas as subscrições atuais do canal e permite-lhe adicionar novas subscrições e remover as existentes. Como parte da adição de subscrições, também pode personalizar aquilo em que é notificado através de vários filtros.

[! NOTA]Os administradores de equipa não conseguem remover ou modificar subscrições criadas pelos administradores do Project.

Pré-visualizações de URLs de itens de trabalho

Para suportar a colaboração em torno de itens de trabalho discutidos num canal, é apresentada uma pré-visualização dos itens de trabalho referenciados no canal. Quando um utilizador cola o URL do item de trabalho, é apresentada uma pré-visualização semelhante à imagem seguinte. Esta pré-visualização ajuda a manter as conversações relacionadas com o item de trabalho relevantes e corretas.

Para que esta funcionalidade funcione, os utilizadores têm de ter sessão iniciada. Depois de iniciarem sessão, esta funcionalidade funciona para todos os canais numa área de trabalho.

Desassociar um projeto de um canal

Um canal do Slack só pode ligar a um projeto do Azure Boards de cada vez. Para ligar a um projeto diferente, primeiro tem de desassociar o projeto atual com /azboards unlink o comando .

Desassociar um projeto elimina todas as subscrições juntamente com caminhos de área adicionados do canal. Se o canal não tiver subscrições, qualquer utilizador pode desassociar um projeto. No entanto, se um canal tiver subscrições, apenas os administradores de projetos podem desassociar um projeto de um canal.

Referência de comandos

A tabela seguinte lista todos os /azboards comandos que pode utilizar no seu canal do Slack.

Comando Barra	Funcionalidade
/azboards link [url do projeto]	Ligar um projeto a este canal para criar itens de trabalho e receber notificações
/azboards subscriptions	Adicionar ou remover subscrições para este canal
/azboards create ou /azboards create [work item type] [title]	Criar um item de trabalho
/azboards addAreapath [caminho da área]	Adicionar um caminho de área do projeto a este canal
/azboards signin	Iniciar sessão na sua organização do Azure Boards
/azboards signout	Terminar sessão na sua organização do Azure Boards
/azboards desassociar	Desassociar um projeto deste canal
/azboards feedback	Comunicar um problema ou sugerir uma funcionalidade

Gerir trabalho em canais privados

A aplicação Azure Boards para Slack pode ajudá-lo a criar itens de trabalho e a monitorizar também a atividade do item de trabalho nos seus canais privados. Para convidar o bot para o seu canal privado, introduza /invite @azboards. Depois de publicar, pode criar itens de trabalho e gerir as suas notificações da mesma forma que faria para um canal público.

Resolver erros

Se estiver a deparar-se com os seguintes erros ao utilizar a Aplicação Azure Boards para Slack, siga os procedimentos nesta secção.

• Ocorreu um problema. Tente novamente.
• A configuração falhou. Certifique-se de que a organização "{organization name}" existe e que tem permissões suficientes.

Ocorreu um problema. Tente novamente.

A aplicação Azure Boards utiliza o protocolo de autenticação OAuth e requer o acesso de aplicações de terceiros através do OAuth para que a organização esteja ativada. Para ativar esta definição, aceda aDefinições da organização Políticas> deSegurança> e defina o acesso da aplicação de terceiros através do OAuth para a definição da organização como Ativado.

A configuração falhou. Certifique-se de que a organização "{organization name}" existe e que tem permissões suficientes.

Termine sessão no Azure DevOps ao utilizar https://aka.ms/VsSignout o browser.

Abra uma janela no browser privado ou incógnito e aceda a https://aex.dev.azure.com/me e inicie sessão. Na lista pendente sob o ícone de perfil à esquerda, selecione o diretório que contém a organização que contém o projeto que pretende ligar.

No mesmo browser, inicie um novo separador, aceda a https://slack.come inicie sessão no seu espaço de trabalho (utilize o cliente Web). Execute o /azboards signout comando seguido do /azboards signin comando .

Selecione o Sign in botão e será redirecionado para uma página de consentimento como a do exemplo seguinte. Certifique-se de que o diretório apresentado ao lado do e-mail é igual ao que foi escolhido no passo anterior. Aceite e conclua o processo de início de sessão.

Se estes passos não resolverem o problema de autenticação, contacte-nos na Comunidade de Programadores.

Artigos relacionados

• Definir caminhos de área e atribuir a uma equipa
• Pipelines do Azure com o Slack
• Repositórios do Azure com o Slack
• Criar um service hook para o Azure DevOps com o Slack