Usar o aplicativo Azure Boards no Microsoft Teams

  • Artigo

Azure DevOps Services

Se você usa o Microsoft Teams, poderá criar itens de trabalho e monitorar a atividade do item de trabalho em seu projeto do Azure Boards a partir do canal do Teams. Você pode fazer isso adicionando o aplicativo Azure Boards para Microsoft Teams ao canal do Teams.

O aplicativo Azure Boards para Microsoft Teams permite que os usuários concluam as seguintes tarefas:

  • Configurar e gerenciar assinaturas para criar e atualizar itens de trabalho
  • Gerenciar outros eventos de itens de trabalho
  • Receber e gerenciar notificações para eventos de itens de trabalho no canal do Teams
  • Criar itens de trabalho a partir de conversas no canal
  • Pesquisar e compartilhar itens de trabalho com outros membros do canal usando a extensão de mensagens
  • Exiba pré-visualizações de itens de trabalho a partir de URLs para iniciar discussões e manter as conversas contextuais.

Imagem: Notificação

Leia este artigo para saber como fazer:

  • Adicionar o aplicativo Azure Boards à sua equipe no Microsoft Teams
  • Vincular e desvincular seu projeto do Azure Boards ao aplicativo Azure Boards
  • Configurar assinaturas para eventos relacionados a 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

A integração do Microsoft Teams com o Azure Boards só tem suporte para o Azure DevOps Services.

Além disso, não há suporte para Azure Boards e integração do Microsoft Teams se você for um cliente do O365 Government Community Cloud (GCC) que usa uma assinatura comercial do Azure em conjunto com seu locatário do GCC.

Pré-requisitos

Observação

  • Você pode vincular o aplicativo Azure Boards para Microsoft Teams apenas a um projeto hospedado no Azure DevOps Services no momento.
  • No momento, não há suporte para notificações dentro de mensagens diretas.
  • Há suporte apenas para canais públicos.

Adicionar o aplicativo Azure Boards ao Microsoft Teams

Você adiciona o aplicativo ao canal do Teams no Microsoft Teams.

  1. Visite a App Store no Microsoft Teams e pesquise o aplicativo Azure Boards. Após a instalação, uma mensagem de boas-vindas do aplicativo é exibida conforme mostrado na imagem a seguir.

    Imagem: Mensagem de boas-vindas

  2. Use o identificador @azure boards para interagir com o aplicativo. Para obter uma lista de comandos, consulte Referência de comando fornecida posteriormente neste artigo.

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

  1. Depois que o aplicativo tiver sido instalado na sua equipe, conecte-se e autentique-se no Azure Boards. Use Entrar com email diferente se seu Microsoft Teams e o Azure Boards estiverem em locatários diferentes.

    Conecte-se e autentique-se no Azure Boards.

    Conecte-se e autentique-se no Azure Boards, etapa 2.

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

     @azure boards link [project url]

    Por exemplo:

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

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

Configurar assinaturas

Você pode criar assinaturas para monitorar itens de trabalho a qualquer momento usando o comando @azure boards subscriptions.

  1. Selecione o caminho de área desejado e o evento no qual você está interessado. Use os filtros associados para personalizar sobre o que você recebe notificação no canal do Teams. Para ajudar a configurar assinaturas facilmente, seus caminhos de área acessados recentemente são mostrados no menu suspenso Caminho de área.

    Configure assinaturas.

Caso o caminho de área desejado 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 os caminhos de comando e área @azure boards addAreapath para os quais as assinaturas são criadas no canal sempre aparecem na lista suspensa Caminho de área, juntamente com 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. Esse recurso é útil para equipes com mais de 100 caminhos de área em seu projeto.

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

      @azure boards addAreapath [area path]

    Por exemplo:

      @azure boards addAreapath myproject\fabrikam

    mensagem de sucesso ao adicionar caminho de área

  • 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 com um comando

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 @azure boards create.

    Criar item de trabalho usando comando

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. A seção Discussão do item de trabalho recém-adicionado armazena um link de volta para a conversa no canal.

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

    Criar item de trabalho usando ação de mensagem

    Criar item de trabalho usando ação de mensagem, etapa 2.

Gerenciar assinaturas do Azure Boards

  1. Para exibir, adicionar e remover assinaturas de um canal, use o @azure boards subscriptions comando:

     @azure boards 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.

Exibir assinaturas

Observação

Os administradores de equipe não podem remover ou modificar assinaturas criadas pelos administradores do Projeto.

Pesquisar e compartilhar itens de trabalho usando a extensão de composição

Para ajudar os usuários 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, consulte Pesquisa de item de trabalho funcional. Para usar a extensão de composição, os usuários devem entrar no aplicativo Azure Boards executando o comando @azure boards signin ou entrando diretamente na extensão de composição.

Entrar na extensão de composição.

Visualizar URLs de item de trabalho

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

A URL do item de trabalho é desenrolada.

Para que esse recurso funcione, os usuários devem estar conectados. Depois de conectado, esse recurso funciona para todos os canais em uma equipe no Microsoft Teams.

Um canal do Teams só pode vincular a um projeto do Azure Boards por vez. Para vincular a um projeto diferente, primeiro você deve desvincular o projeto atual usando o comando @azure boards 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.

O canal do Teams encadeia notificações para vincular logicamente e reduzir as notificações relacionadas no canal. Todas as notificações vinculadas a um item de trabalho específico são vinculadas em conjunto.

Exibição compacta de notificações encadeadas

Thread compacto

Exibição expandida de notificações encadeadas

Thread expandido

Referência de comando do Azure Boards

A tabela a seguir lista todos os comandos @azure boards que você pode usar em seu canal do Microsoft Teams.

Comando Funcionalidade
@azure boards link [url do projeto] Vincular um projeto a esse canal para criar itens de trabalho e receber notificações
@azure boards subscriptions Adicionar ou remover as assinaturas deste canal
@azure boards create Criar um item de trabalho
@azure boards addAreapath [caminho de área] Adicionar um caminho de área do projeto a esse canal
@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 unlink Desvincular um projeto desse canal
@azure boards feedback Relatar um problema ou sugerir um recurso

Configurar guias do Azure DevOps Services no Microsoft Teams

  1. Para trazer seu quadro Kanban ou Painel para o Microsoft Teams, selecione o botão '+' ('adicionar nova guia') na navegação superior do canal da equipe.

    A caixa de diálogo Adicionar uma guia é exibida. Os ícones são organizados normalmente de acordo com o acesso mais recente. Você pode selecionar A-Z para uma lista em ordem alfabética.

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

  2. Escolha o ícone Azure DevOps e autentique sua identidade. Opcionalmente, você pode escolher o ícone Site e adicionar a URL do quadro Kanban ou painel ao canal.

  3. Escolha a organização cujo quadro ou painel deseja adicionar.

  4. Preencha o formulário apresentado. Por exemplo, aqui, adicionamos um painel para a equipe do Azure DevOps para o projeto TechnicalContent.

    Caixa de diálogo para adicionar um painel de equipe a um canal do Teams.

  5. O quadro Kanban ou painel que você selecionou é exibido.

Suporte para multilocatário

Na sua organização, se você estiver usando um email ou locatário diferente para o Microsoft Teams e o Azure DevOps, conclua as etapas a seguir para entrar e se conectar com base no seu caso de uso.

Case

ID de email e locatário no Microsoft Teams

ID de email e locatário no Azure DevOps

Etapas a serem realizadas

1

email1@abc.com
(locatário 1)

email1@abc.com
(locatário 1)

Entre usando o botão Entrar.

2

email1@abc.com
(locatário 1)

email1@abc.com
(locatário 2)

  • Entrar na conta do Azure DevOps
  • No mesmo navegador, inicie uma nova guia, vá para https://teams.microsoft.com
  • Execute o comando signin e escolha o botão Entrar.

3

email1@abc.com
(locatário 1)

email2@pqr.com
(locatário 2)

Entre usando Entrar com endereço de email diferente, no seletor de ID de email, use o email2 para entrar no Azure DevOps.

4

email1@abc.com
(locatário 1)

email2@pqr.com
(locatário não padrão 3)

Não há suporte para esse cenário no momento

Solucionar problemas de erros

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

Algo deu errado. Tente novamente.

O aplicativo Azure Boards usa o protocolo de autenticação OAuth e requer que o acesso de aplicativos de terceiros por meio do OAuth para a organização seja habilitado. Para habilitar essa configuração, vá para Configurações da organização Políticas> deSegurança> e defina o acesso de aplicativos de terceiros via OAuth para a configuração da organização como Ativado.

Habilitar o acesso de aplicativos de terceiros por meio do OAuth para a configuração da organização

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

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

Abra uma janela do navegador In private ou incognito e acesse https://aex.dev.azure.com/me e entre. Na lista suspensa, no ícone de perfil à esquerda, selecione o diretório que contém a organização com o projeto que você deseja vincular.

Selecione o diretório que contém a organização que contém o projeto

No mesmo navegador, inicie uma nova guia, vá para https://teams.microsoft.com/. Execute o comando @azure boards signout e depois execute o comando @azure boards signin no canal em que o aplicativo Azure Boards do Microsoft Teams está instalado.

Selecione o Sign in botão e você será redirecionado para uma página de consentimento como a do exemplo a seguir. Verifique se o diretório mostrado ao lado do e-mail é o mesmo que foi escolhido na etapa anterior. Aceite e conclua o processo de entrada.

Consentimento para as permissões de aplicativo solicitadas

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