Usar o aplicativo Azure Boards no Microsoft Teams

Serviços de DevOps do Azure

Se utilizar o Microsoft Teams, pode criar itens de trabalho e monitorizar a atividade de itens de trabalho no projeto do Azure Boards a partir do canal do Teams. Pode fazê-lo ao adicionar a aplicação Azure Boards para Microsoft Teams ao canal do Teams.

A aplicação Azure Boards para Microsoft Teams permite aos utilizadores concluir as seguintes tarefas:

• Configurar e gerir subscrições para criar e atualizar itens de trabalho
• Gerir outros eventos de itens de trabalho
• Receber e gerir notificações para eventos de itens de trabalho no respetivo canal do Teams
• Criar itens de trabalho a partir de conversas no canal
• Pesquisar e partilhar itens de trabalho com outros membros no canal com a extensão de mensagens
• Ver as pré-visualizações de itens de trabalho a partir dos respetivos URLs para iniciar debates e manter as conversas contextuais.

Leia este artigo para saber como:

• Adicionar a aplicação Azure Boards à sua equipa no Microsoft Teams
• Vincule e desvincule seu projeto do Azure Boards ao aplicativo Azure Boards
• Configurar subscrições para eventos relacionados com itens de trabalho no seu canal do Teams
• Criar itens de trabalho a partir do seu canal do Teams
• Monitore a atividade do item de trabalho no seu canal do Teams

Nota

A integração do Azure Boards e do Microsoft Teams só é suportada para os Serviços de DevOps do Azure.

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

Pré-requisitos

• Para criar um item de trabalho, você deve ser um contribuidor para o projeto Azure Boards. Se ainda não tem um projeto, pode inscrever-se e criar um projeto. Para obter mais informações, consulte Começar a usar painéis do Azure.
• Para criar assinaturas em um canal do Teams para eventos de item de trabalho, você deve ser membro do grupo Administradores de Projeto de Painéis do Azure ou adicionado à função de administrador de equipe da equipe. Para ser adicionado, consulte Alterar permissões no nível do projeto ou Adicionar administrador da equipe.
• Para receber notificações, você deve habilitar a configuração Acesso a aplicativos de terceiros por meio de OAuth para a organização do Azure DevOps. Consulte Alterar políticas de acesso a aplicativos para sua organização.

Nota

• Você pode vincular o aplicativo Azure Boards para Microsoft Teams somente a um projeto hospedado nos Serviços de DevOps do Azure no momento.
• Atualmente, não há suporte para notificações dentro de mensagens diretas.
• Apenas os canais públicos são suportados.

Adicionar a aplicação Azure Boards ao Microsoft Teams

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

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

   

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

Vincular seu projeto do Azure Boards ao aplicativo Azure Boards

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

1. Depois que o aplicativo for instalado em sua equipe, conecte-se e autentique-se no Azure Boards. Utilize Iniciar sessão com e-mail diferente se o seu Microsoft Teams e Azure Boards estiverem em inquilinos diferentes.

   

   

2. Depois de entrar, use o seguinte comando dentro de um canal do Teams para vincular ao projeto Azure Boards especificado 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 @azure boards create ações de comando ou mensagem.

Configurar subscrições

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

1. Selecione o caminho da área desejado e o evento em que está interessado. Use os filtros associados para personalizar o que você será notificado em seu canal do Teams. Para ajudar a configurar facilmente as assinaturas, os caminhos de área acessados recentemente são mostrados na lista suspensa de caminho de área.

   

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 o comando e os @azure boards addAreapath caminhos de área para os quais as assinaturas são criadas no canal sempre aparecem no menu suspenso Caminho de área junto com os caminhos de área acessados recentemente.

Adicionar caminhos de área

Pode adicionar áreas em que a sua equipa trabalha ao canal para que estejam sempre disponíveis para criar itens de trabalho e subscrições. Este 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
  

  

• 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 a aplicação Azure Boards, pode criar itens de trabalho a partir do seu canal. O aplicativo também suporta itens de trabalho personalizados.

• Para criar um item de trabalho, use @azure boards create.

  

Criar um item de trabalho a partir de 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 é pré-preenchida 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

  

  

Gerir subscrições do Azure Boards

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

    @azure boards subscriptions
   

Este comando lista todas as assinaturas atuais para o canal e permite que você adicione novas assinaturas e remova as existentes. Como parte da adição de assinaturas, você também pode personalizar o que será notificado usando vários filtros.

Nota

Os administradores de equipe não podem remover ou modificar assinaturas criadas por administradores do Project.

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

Para ajudar os utilizadores a pesquisar e partilhar itens de trabalho, a aplicação Azure Boards para Microsoft Teams suporta a extensão de composição. Você pode pesquisar itens de trabalho por ID de item de trabalho, título ou comando funcional suportado. 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 @azure boards signin o comando ou entrando diretamente 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, uma visualização é mostrada semelhante à imagem a seguir. Essa visualização ajuda a manter as conversas relacionadas ao item de trabalho relevantes e corretas.

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

Desvincular um projeto de um canal

Um canal do Teams só pode ser vinculado a um projeto do Azure Boards de cada vez. Para vincular a um projeto diferente, você deve primeiro desvincular o projeto atual usando @azure boards unlink o comando.

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

Notificações encadeadas para vincular e reduzir notificações

O canal do Teams encadeia as notificações de modo a 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.

Vista compacta de notificações encadeadas

Vista expandida de notificações encadeadas

Referência de comando do Azure Boards

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

Comando	Caraterística
@azure link quadros [url do projeto]	Vincule um projeto a este canal para criar itens de trabalho e receber notificações
Subscrições @azure boards	Adicionar ou remover subscrições para este canal
@azure quadros criam	Criar um item de trabalho
@azure placas addAreapath [caminho da área]	Adicionar um caminho de área do seu projeto a este canal
@azure placas entrarem	Iniciar sessão na sua organização de Painéis do Azure
@azure placas saem	Sair da sua organização do Azure Boards
@azure placas desvinculam	Desvincular um projeto deste canal
Comentários dos @azure painéis	Comunicar um problema ou sugerir uma funcionalidade

Configurar guias Serviços de DevOps do Azure no Microsoft Teams

1. Para trazer seu quadro ou painel Kanban para o Microsoft Teams, selecione o botão '+' ('adicionar nova guia') na navegação superior do seu canal de 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 de A a Z para uma lista alfabética.

   

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

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

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

   

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

Suporte multi-inquilino

Na sua organização, se estiver a utilizar um e-mail ou inquilino diferente para o Microsoft Teams e o Azure DevOps, conclua os passos seguintes para iniciar sessão e ligar com base no seu caso de utilização.

Caso

ID de e-mail e locatário no Microsoft Teams

ID de email e locatário no Azure DevOps

Passos a dar

1

email1@abc.com
(inquilino 1)

email1@abc.com
(inquilino 1)

Inicie sessão utilizando o botão Iniciar sessão .

2

email1@abc.com
(inquilino 1)

email1@abc.com
(inquilino 2)

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

3

email1@abc.com
(inquilino 1)

email2@pqr.com
(inquilino 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
(inquilino 1)

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

Este cenário não é suportado atualmente

Resolver erros

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

• Ocorreu um problema. Tente novamente.
• Falha na configuração. Certifique-se de que a organização '{nome da organização}' existe e que tem permissões suficientes.

Ocorreu um problema. Tente novamente.

O aplicativo Azure Boards usa o protocolo de autenticação OAuth e requer acesso a aplicativos de terceiros via OAuth para que a organização seja habilitada. Para habilitar essa configuração, vá para Diretivas de segurança>de configurações>da organização e defina o Acesso a aplicativos de terceiros via OAuth para a configuração da organização como Ativado.

Falha na configuração. Certifique-se de que a organização '{nome da organização}' existe e que tem permissões suficientes.

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

Abra uma janela do navegador Em privado ou anónimo e aceda a https://aex.dev.azure.com/me iniciar sessão. Na lista suspensa sob o ícone de perfil à esquerda, selecione o diretório que contém a organização que contém o projeto que você deseja vincular.

No mesmo navegador, inicie uma nova guia, vá para https://teams.microsoft.com/. Execute o @azure boards signout comando e, em seguida, execute @azure boards signin o comando no canal onde o aplicativo Azure Boards para 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. Certifique-se de que o diretório mostrado ao lado do e-mail é o mesmo que foi escolhido na etapa anterior. Aceite e conclua o processo de início de sessão.

Se estas etapas não resolverem seu problema de autenticação, entre em contato conosco na Comunidade de desenvolvedores.

Artigos relacionados

• Definir caminhos de área e atribuir a uma equipa
• Azure Pipelines com o Microsoft Teams
• Azure Repos com o Microsoft Teams