Usar o Azure Boards no Microsoft Teams

  • Artigo

Azure DevOps Services

Este artigo descreve como usar os aplicativos Azure Boards e Azure DevOps para Microsoft Teams para criar e monitorar itens de trabalho do Azure Boards dos seus canais do Teams.

Observação

Esse recurso só está disponível no Azure DevOps Services. Normalmente, os novos recursos são introduzidos primeiro no serviço de nuvem e disponibilizados localmente na próxima versão principal ou atualização do Azure DevOps Server. Para obter mais informações, confira Linha do tempo do recurso Azure DevOps.

Usando o aplicativo Azure Boards para Microsoft Teams, você pode:

  • Configure e gerencie assinaturas para criar e gerenciar itens de trabalho e eventos de item de trabalho em seus canais do Teams.
  • Criar itens de trabalho a partir de conversas em um canal.
  • Pesquisar e compartilhar itens de trabalho com outros canais usando a extensão de mensagens.
  • Exibir visualizações de itens de trabalho de URLs.

Observação

As notificações do Azure Boards não funcionam no chat ou em mensagens diretas do Teams.

Neste artigo, você aprenderá como:

  • Adicionar o aplicativo Azure Boards à sua equipe no Microsoft Teams.
  • Vincular seu projeto do Azure Boards ao aplicativo Azure Boards.
  • Configurar assinaturas para eventos de itens de trabalho em seu canal do Teams.
  • Criar itens de trabalho do canal do Teams.
  • Monitorar a atividade do item de trabalho em seu canal do Teams.

Observação

O aplicativo Azure Boards para Microsoft Teams não funciona para clientes da Nuvem da Comunidade Governamental (GCC) do O365 que usam uma assinatura do Azure Commercial em conjunto com um locatário da GCC.

Pré-requisitos

  • Acesso a uma equipe e canal no Microsoft Teams onde você pode instalar um aplicativo.
  • Uma função administrador de projeto ou administrador de equipe em um projeto do Azure DevOps.
  • Acesso a aplicativos de terceiros por meio do OAuth habilitado nas configurações organizacionais do Azure DevOps.

Para saber mais, consulte os recursos a seguir:

Adicionar o aplicativo Azure Boards ao Teams

Você pode adicionar o aplicativo Azure Boards aos canais do Teams.

  1. No Microsoft Teams, selecione Aplicativos, pesquise Azure Boards e selecione Azure Boards.

    Captura de tela da seleção de Aplicativos e Azure Boards.

  2. Selecione a seta suspensa ao lado de Abrir e selecione Adicionar a uma equipe.

    Captura de tela da seleção de Abrir e de Adicionar a uma equipe.

  3. Selecione ou insira o nome da equipe e selecione Configurar um bot.

    Captura de tela da seleção de Configurar um bot.

Após a instalação do aplicativo, você verá uma mensagem de boas-vindas no painel de conversa do Teams.

Captura de tela da mensagem de boas-vindas no painel de conversa.

Comandos do aplicativo Azure Pipelines

Você pode usar os comandos @azure boards a seguir para interagir com o aplicativo Azure Boards em seu canal do Teams.

Comando Funcionalidade
@azure boards sign in Entrar na sua organização do Azure Boards.
@azure boards sign out Sair da sua organização do Azure Boards.
@azure boards link <URL do projeto> Vincular um projeto a esse canal para criar itens de trabalho e receber notificações.
@azure boards unlink Desvincular um projeto desse canal.
@azure boards subscriptions Adicionar ou remover as assinaturas para este canal.
@azure boards addAreapath <caminho da área> Adicionar um caminho de área do projeto a esse canal.
@azure boards feedback Relatar um problema ou sugerir um recurso.
@azure boards help Obter ajuda nos comandos.

Para usar o aplicativo, entre no Azure Boards e vincule seu projeto do Azure Boards ao canal do Teams.

  1. No painel de conversa do Teams, insira @azure boards signin.

  2. Selecione Entrar e conclua a autenticação no Azure Boards. Selecione Entrar com email diferente se seu Microsoft Teams e o Azure Boards estiverem em locatários diferentes.

  3. Use o comando @azure boards link para vincular à URL do projeto do Azure DevOps. Por exemplo:

    @azure boards link https://dev.azure.com/myorg/myproject/

  4. Selecione o botão Adicionar assinatura na notificação do projeto vinculado para começar a monitorar seu projeto.

    Captura de tela da notificação do projeto vinculado com o botão Adicionar assinatura.

Configurar assinaturas

Depois que o projeto estiver vinculado, comece a monitorar os itens de trabalho do projeto selecionando o botão Adicionar assinatura. Você pode adicionar mais assinaturas a qualquer momento usando o comando @azure boards subscriptions.

  1. Em Escolher evento, selecione o evento no qual deseja se inscrever e selecione Avançar.

    Captura de tela da seleção do evento a ser monitorado.

  2. Em Escolher filtros, selecione Caminho de área, Tipo de item de trabalho e, opcionalmente, especifique Marcas ou uma cadeia de caracteres específica para filtrar. Então, selecione Enviar.

    Captura de tela da configuração da assinatura.

Adicionar caminhos de área

Os caminhos de área que têm assinaturas no canal, caminhos de área acessados recentemente e caminhos de área que você adiciona usando o comando @azure boards addAreapath são exibidos no menu suspenso Caminho de área quando você cria uma assinatura. Se o caminho de área em que sua equipe trabalha não aparecer no menu suspenso, você poderá adicioná-lo para que ele esteja sempre disponível para criar itens de trabalho e assinaturas. Esse recurso é especialmente útil para equipes com mais de 100 caminhos de área em seu projeto.

Use o comando @azure boards addAreapath para adicionar caminhos de área do seu projeto ao canal do Teams. Por exemplo:

@azure boards addAreapath 'VMdemo\Area4'

Você receberá uma mensagem indicando o êxito.

Captura de tela da adição de um caminho de área e a mensagem de êxito.

Se você escolher o nome do projeto como seu caminho de área, receberá notificações para todos os caminhos de área no projeto.

Criar um item de trabalho

Você pode usar o aplicativo Azure Boards para criar itens de trabalho do canal usando uma ação de mensagem.

  1. Em qualquer mensagem no canal, selecione a elipse Mais ações no painel de ações e, em seguida, selecione Criar item de trabalho.

    Captura de tela da seleção de criar item de trabalho no menu Mais ações.

  2. Selecione o tipo de item de trabalho que você deseja criar e selecione Avançar.

  3. Insira um Título e selecione um Caminho de área para o item de trabalho.

  4. O texto da mensagem se torna a Descrição do item de trabalho ou as Etapas de reprodução, dependendo do tipo de item de trabalho, ou você pode editar o texto. Selecione Criar.

    Captura de tela da configuração do item de trabalho.

O novo item de trabalho é exibido no Azure Boards e contém um link de volta para o item do Teams que gerou o item de trabalho.

Captura de tela do novo item de trabalho no Azure Boards.

Gerenciar assinaturas do Azure Boards

Para exibir, adicionar e remover assinaturas de um canal, use o comando @azure boards subscriptions. Esse comando lista todas as assinaturas atuais do canal. Você pode adicionar novas assinaturas e remover as existentes. Ao adicionar uma assinatura, você pode personalizar notificações usando filtros.

Captura de tela da lista de assinaturas.

Observação

Os Administradores de equipe não podem remover ou modificar assinaturas que os administradores do projeto criaram.

Usar a extensão de composição

Para ajudar você a pesquisar e compartilhar itens de trabalho, o aplicativo Azure Boards para Microsoft Teams dá suporte à extensão de composição. Você pode pesquisar itens de trabalho por ID do item de trabalho, título ou comando funcional com suporte. Para obter uma lista de comandos aceitos, consulte Pesquisa de item de trabalho funcional.

Para usar a extensão de composição, você deve estar conectado ao projeto do Azure Boards no canal do Teams. Selecione o símbolo + no campo de mensagem, selecione Azure Boards e pesquise um item de trabalho. Você também pode selecionar Criar item de trabalho para criar um item de trabalho.

Captura de tela mostrando a extensão de redação.

Visualizar itens de trabalho

Para dar suporte à colaboração nos itens de trabalho discutidos em um canal, o aplicativo Azure Boards exibe uma visualização dos itens de trabalho mencionados. Quando você cola uma URL de item de trabalho ou seleciona um item de trabalho na extensão de composição, o aplicativo mostra uma visualização semelhante à imagem a seguir. Esse recurso de desdobramento de URL funciona para todos os canais da equipe.

Captura de tela mostrando o desenrolamento da URL do item de trabalho.

Um canal do Teams pode vincular somente a um projeto do Azure Boards por vez. Para vincular a um projeto diferente, primeiro você deve desvincular o projeto atual usando @azure boards unlink.

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

Expandir e recolher threads

Um canal do Teams recolhe postagens em threads para vincular e reduzir logicamente postagens relacionadas no canal. Todas as respostas a uma postagem específica são vinculadas.

Para expandir o thread, selecione o link de thread compactado.

Captura de tela mostrando a visualização de thread compacta.

Para retornar ao canal e recolher o thread, selecione Ir para o canal.

Captura de tela mostrando a visualização de thread expandida.

Configurar guias do Azure DevOps

Para trazer o painel do projeto ou o quadro Kanban para o Teams, você pode instalar o aplicativo Azure DevOps em uma guia no canal do Teams. O aplicativo Azure DevOps permite inserir conteúdo do aplicativo em mensagens e receber notificações do aplicativo em seus canais.

  1. No Teams, selecione o + símbolo na navegação superior do canal ou selecione Aplicativos no menu à esquerda.

  2. Pesquise, se necessário, e selecione Azure DevOps.

    Captura de tela para adicionar uma nova guia ao canal do Teams.

  3. Selecione e entre em sua organização do Azure DevOps.

  4. Na tela do Azure DevOps , selecione um Projeto e se deseja adicionar um Painel ou um Quadro Kanban à guia. Selecione outras configurações, dependendo da escolha, e selecione se deseja postar no canal sobre como adicionar a guia.

    Captura de tela mostrando a adição de um Painel para Azure DevOps no Teams.

  5. Selecione Salvar. A nova guia e o quadro são exibidos no canal.

Conectar diferentes locatários

Se você usar diferentes emails ou locatários para o Microsoft Teams e o Azure DevOps, siga estas etapas para entrar e se conectar com base nas configurações.

Microsoft Teams Azure DevOps Ação de entrada
email1@abc.com (tenant1) email1@abc.com (tenant1) Selecione Entrar
email1@abc.com (tenant1) email2@abc.com (tenant2) 1. Entre no Azure DevOps.
2. No mesmo navegador, inicie uma nova guia e acesse https://teams.microsoft.com/.
3. Execute o comando sign in e selecione Entrar.
email1@abc.com (tenant1) email2@pqr.com (tenant2) 1. Selecione Entrar com endereço de email diferente.
2. No seletor de ID de email, use o email2 para entrar.
email1@abc.com (tenant1) email2@pqr.com (nondefault tenant3) Não há suporte.

Solucionar problemas de autenticação

Se você receber o erro Falha na configuração. Certifique-se de que a organização '{nome da organização}' exista e que você tem permissões suficientes. Tente as etapas a seguir para resolver o erro.

  1. No mesmo navegador, inicie uma nova guia e entre em https://teams.microsoft.com/.

  2. Nessa guia, acesse o canal em que o aplicativo Azure Boards do Microsoft Teams está instalado e execute os comandos @azure boards signout e @azure boards signin.

  3. Selecione o botão Entrar e conclua o processo de entrada. Verifique se o diretório mostrado é o mesmo que você escolheu na etapa anterior.

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