Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O conector Azure DevOps Work Items indexa itens de trabalho ( como histórias de utilizador, tarefas, erros e funcionalidades) da sua organização Azure DevOps Services para o Microsoft 365. Este guia descreve os passos para implementar e personalizar o conector.
Para obter Azure informações de configuração do DevOps, veja Configurar o ambiente Azure DevOps para ingestão de conectores.
Pré-requisitos
Antes de implementar o conector Azure DevOps Work Items, certifique-se de que o ambiente Azure DevOps está configurado na sua organização e que cumpre os seguintes pré-requisitos:
- Tem de ser um administrador do Microsoft 365.
- Identificou o Azure organização de DevOps para indexar.
- Configurou uma conta de pesquisa no Azure DevOps que tem, pelo menos, as permissões de leitura necessárias para que todos os projetos e caminhos de área sejam indexados.
- Criou uma aplicação no Microsoft Entra ID com permissões delegadas Azure API REST do DevOps.
- Gerou um segredo do cliente para a aplicação Microsoft Entra para autenticação baseada em OAuth.
Implementar o conector
Para adicionar o Azure conector Itens de Trabalho do DevOps para a sua organização:
- Na Centro de administração do Microsoft 365, no painel esquerdo, selecioneConectoresCopilot>.
- Selecione o separador Galeria .
- Na lista de conectores disponíveis, selecione Azure Itens de Trabalho do DevOps.
Definir nome a apresentar
O nome a apresentar é utilizado para identificar referências em respostas copilot para ajudar os utilizadores a reconhecer a origem de conteúdo associada. Pode aceitar o nome a apresentar predefinido Azure Itens de Trabalho do DevOps ou personalizá-lo conforme adequado para a sua organização.
Definir URL da instância
Indique o nome da sua organização Azure DevOps. O nome da organização Azure DevOps é o segmento a seguir https://dev.azure.com/a . Por exemplo:
- URL:
https://dev.azure.com/contoso - Organização:
contoso
Apenas o nome da organização é obrigatório. Não forneça o URL completo.
Escolher tipo de autenticação
Para sincronizar itens de trabalho do Azure DevOps, escolha um dos métodos de autenticação suportados e conclua a configuração necessária:
- Credencial Federada (recomendado) – utiliza um principal de serviço para pesquisar conteúdo.
- Microsoft Entra ID OAuth - Utiliza a conta de administrador do Microsoft 365 com sessão iniciada.
Credencial Federada (recomendado)
A Credencial Federada utiliza uma aplicação empresarial publicada pela Microsoft como a conta de serviço de pesquisa. Tem de conceder a este principal de serviço as permissões necessárias no Azure DevOps.
Confirme que a aplicação do principal de serviço está aprovisionada
- Aceda ao centro de administração do Microsoft Entra.
- Procure a Aplicação de Credenciais Federadas do Conector de Grafos ou utilize o ID da aplicação:
933838e2-bec1-440f-a634-9363c82e5b6d. - Se a aplicação não estiver aprovisionada, abra a página Conectores do Copilot no Centro de administração do Microsoft 365. O aprovisionamento pode demorar várias horas.
Conceder à aplicação Microsoft Entra acesso a projetos Azure DevOps
Conceda ao principal de serviço acesso aos Azure projetos de DevOps que pretende indexar.
- Aceda a Azure DevOps e selecione a organização.
- Selecione Definições da organização.
- No painel esquerdo, em Geral, selecione Utilizadores.
- Selecione Adicionar utilizadores.
- Em Utilizadores ou Principais de Serviço, introduza o ID da aplicação:
933838e2-bec1-440f-a634-9363c82e5b6d. - Atribua o nível de acesso Básico , selecione os projetos a indexar e adicione a aplicação ao grupo Administradores do Projeto (ou a um grupo equivalente). Desmarque a opção para enviar um convite por e-mail.
Configurar a autenticação de Credenciais Federadas
Selecione Credencial Federada como o tipo de autenticação e autentique-se quando lhe for pedido.
Microsoft Entra ID OAuth
Microsoft Entra ID OAuth utiliza a conta de administrador do Microsoft 365 com sessão iniciada como conta de serviço de pesquisa. Para permitir que o conector aceda Azure DevOps e atualize itens de trabalho, conceda as permissões necessárias.
Confirme que a sua organização Azure DevOps está ligada ao Microsoft Entra
O conector só pode indexar itens de trabalho de uma organização Azure DevOps que esteja ligada ao Microsoft Entra ID do seu inquilino.
- Aceda a Azure DevOps e selecione a organização.
- Selecione Definições da organização.
- No painel esquerdo, em Geral, selecione Microsoft Entra.
- Confirme que a organização está ligada à conta Microsoft Entra do inquilino.
Observação
O administrador que cria a ligação tem de ter acesso de Leitura ao projeto relevante.
Criar uma aplicação no Microsoft Entra ID
- Inicie sessão no portal do Azure com credenciais de administrador.
- Aceda a Microsoft Entra ID>Identity>Applications>Registros de aplicativo e, em seguida, selecione Novo registo.
- Introduza um nome para a aplicação e selecione Registar.
- Tenha em atenção o ID da Aplicação (cliente) – irá utilizá-lo para conceder acesso ao projeto no Azure DevOps.
- Abra permissões de API e selecione Adicionar uma permissão.
- Selecione Azure permissões>delegadas do DevOps.
- Adicione as seguintes permissões vso :
- vso.analytics – Análise (leitura)
- vso.graph – Microsoft Graph (leitura)
- vso.identity – Identidade (leitura)
- vso.project – Projeto e equipa (leitura)
- vso.variablegroups_read – Grupos de Variáveis (leitura)
- vso.work – Itens de trabalho (leitura)
- Selecione Conceder consentimento do administrador para <TenantName> e confirme.
- Verifique se todas as permissões são apresentadas como Concedidas.
- Abra Autenticação e selecione Adicionar uma Web de plataforma>. Adicione um dos seguintes URIs de redirecionamento:
-
Microsoft 365 Enterprise:
https://gcs.office.com/v1.0/admin/oauth/callback -
Microsoft 365 Government:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
-
Microsoft 365 Enterprise:
- Em Concessão implícita e fluxos híbridos, ative os tokens de ID e selecione Configurar.
- Aceda a Certificados e segredos e, em seguida, selecione Novo segredo do cliente. Escolha um período de expiração e guarde o valor do segredo gerado.
- Utilize o segredo do cliente e o ID da aplicação quando configurar o conector.
Autenticar a aplicação Microsoft Entra com uma conta de pesquisa
A aplicação utiliza o início de sessão único para autenticar com a conta de administrador do Microsoft 365 com sessão iniciada. Microsoft Entra ID emite um token de acesso que inclui as permissões delegadas concedidas ao utilizador. O conector só pode aceder a dados e executar ações que o utilizador autenticado está autorizado a executar.
Implementar
Para implementar o conector para uma audiência limitada, selecione o botão de alternar junto a Implementação para audiência limitada e especifique os utilizadores ou grupos para os quais pretende implementar o conector. Isto permite-lhe validar o conector antes de uma implementação completa. Para obter mais informações, veja Implementação faseada para conectores Copilot.
Selecione Criar para implementar a ligação. O conector Itens de Trabalho do Azure DevOps começa a indexar conteúdos imediatamente.
A tabela seguinte lista os valores predefinidos que estão definidos.
| Categoria | Valor padrão |
|---|---|
| Usuários | Apenas pessoas com acesso ao conteúdo na origem de dados. Identidades de origem de dados mapeadas com Microsoft Entra IDs. |
| Conteúdo | Todos os projetos são indexados. |
| Sincronização | Pesquisa completa todos os dias. Pesquisa incremental a cada 15 minutos. |
Para personalizar estes valores, selecione Configuração personalizada. Para obter mais informações, veja Personalizar definições.
Depois de criar a ligação, pode rever a status na secção Conectores do Centro de administração do Microsoft 365.
Personalizar definições (opcional)
Pode personalizar as predefinições do conector Itens de Trabalho do Azure DevOps ao selecionar Configuração personalizada na página do conector.
Personalizar as definições do utilizador
Permissões de acesso
O conector de Itens de Trabalho do Azure DevOps suporta as seguintes permissões de pesquisa:
- Visível para todos
- Apenas pessoas com acesso a esta origem de dados
Se escolher Visível para todos os utilizadores, os dados indexados são apresentados nos resultados da pesquisa para todos os utilizadores. Se escolher Apenas pessoas com acesso a esta origem de dados, os dados indexados são apresentados nos resultados da pesquisa para os utilizadores que têm acesso à mesma.
Observação
Atualizações a grupos que regem as permissões de acesso são sincronizados apenas em pesquisas completas. As pesquisas incrementais não suportam o processamento de atualizações para permissões.
Identidades do mapa
O mapeamento de identidades garante que Azure identidades do DevOps mapeiam corretamente para Microsoft Entra ID utilizadores. O conector utiliza o acesso delegado e alinha automaticamente as identidades através da conta de administrador do Microsoft 365 com sessão iniciada.
Personalizar definições de conteúdo
Gerir propriedades
Pode adicionar ou remover propriedades da sua origem de dados do Azure DevOps, atribuir um esquema à propriedade (definir se uma propriedade é pesquisável, queryable, recuperável ou refinável), alterar a etiqueta semântica e adicionar um alias à propriedade. A tabela seguinte lista as propriedades indexadas por predefinição.
| Propriedade | Etiqueta semântica | Descrição | Atributos de esquema |
|---|---|---|---|
| AreaPath | O caminho da área para o item de trabalho | Consultar, Obter, Procurar | |
| AssignedTo | Nome da pessoa a que o item de trabalho está atribuído | Consultar, Obter, Procurar | |
| Autores | Autores | Obter | |
| Alterado Por | Última modificação por | Nome da pessoa que modificou pela última vez o item de trabalho | Consultar, Obter |
| ChangedDate | Hora da última modificação | Consultar, Obter | |
| CreatedBy | Criado por | Nome da pessoa que criou o item de trabalho | Consultar, Obter, Procurar |
| CreatedDate | Data e hora de criação | Carimbo de data/hora quando o item de trabalho foi criado | Consultar, Obter |
| Descrição | Conteúdo | Descrição do item de trabalho | Pesquisar |
| IconUrl | IconUrl | Obter | |
| Id | ID do item de trabalho | Consultar, Obter, Procurar | |
| Prioridade | Prioridade do item de trabalho | Consultar, Obter | |
| Voltar a processar | Passos para reproduzir uma condição descrita no item de trabalho | ||
| Estado | Estado atual do item de trabalho | Consultar, Obter, Procurar | |
| Marcações | Consultar, Obter, Procurar | ||
| TeamProject | Obter | ||
| Título | Título | Título do item de trabalho | Obter, Procurar |
| URL | url | URL do item de trabalho | Obter |
| WorkItemType | Consultar, Obter, Procurar |
Personalizar intervalos de sincronização
Pode ajustar a frequência com que o conector pesquisa o seu Azure organização do DevOps. Estão disponíveis os seguintes intervalos de sincronização:
- Pesquisa completa: Recrawls the entire Azure DevOps dataset.
- Pesquisa incremental: Recrawls apenas itens atualizados.
As predefinições de sincronização são otimizadas para a maioria das organizações.
Para obter mais informações, veja Diretrizes para definições de sincronização.