Conector Itens de Trabalho do Microsoft Graph do Azure DevOps
O conector do Azure DevOps Graph permite à sua organização indexar itens de trabalho na instância do serviço Azure DevOps. Depois de configurar o conector e o conteúdo do índice a partir do Azure DevOps, os utilizadores finais podem procurar esses itens no Microsoft Search.
Observação
Leia o artigo Setup for your Microsoft Graph connector (Configuração do conector do Microsoft Graph ) para compreender as instruções gerais de configuração dos conectores.
Este artigo destina-se a qualquer pessoa que configure, execute e monitorize um conector do Azure DevOps. Complementa o processo de configuração geral e mostra instruções que se aplicam apenas a este conector.
Importante
O conector do Azure DevOps suporta apenas o serviço cloud do Azure DevOps. O Azure DevOps Server 2019, TFS 2018, TFS 2017, TFS 2015 e TFS 2013 não são suportados por este conector.
Antes de começar
Tem de ser o administrador do inquilino do M365 da sua organização, bem como o administrador da instância do Azure DevOps da sua organização.
Para permitir que o conector se ligue à sua Organização do Azure DevOps, tem de ativar o acesso de aplicações de terceiros através do OAuth. Veja a documentação do Azure DevOps para gerir políticas de segurança para saber mais.
Precisará das seguintes permissões concedidas à conta de utilizador cujas credenciais são utilizadas durante a configuração do conector:
| Nome da permissão | Tipo de permissão | Necessário para |
|---|---|---|
| Ver informações ao nível do projeto | Permissão do projeto | Pesquisar Itens de Trabalho do Azure DevOps. Esta permissão é obrigatória para os projetos que precisam de ser indexados. |
| Ver análise | Permissão do projeto | Pesquisar Itens de Trabalho do Azure DevOps. Esta permissão é obrigatória para os projetos que precisam de ser indexados. |
| Ver itens de trabalho neste nó | Caminho da área | Pesquisar Itens de Trabalho num caminho de área. Esta permissão é opcional. Apenas esses caminhos de área serão pesquisados para os quais a conta de utilizador tem permissões. |
Importante
A conta de utilizador tem de ter o nível de acesso Básico . Para saber mais sobre os níveis de acesso no Azure DevOps, leia os níveis de acesso suportados.
Passo 1: adicionar um conector no centro de administração do Microsoft 365
Adicionar o conector do Azure DevOps
(Veja as instruções gerais de configuração para obter mais detalhes)
Passo 2: atribuir um nome à ligação
Siga as instruções de configuração gerais.
Passo 3: Configurar as definições de ligação
Para ligar à instância do Azure DevOps, precisa do nome da organização do Azure DevOps, do ID da Aplicação e do segredo do cliente para a autenticação OAuth.
Registrar um aplicativo
Registe uma aplicação no Azure DevOps para que a aplicação Microsoft Search possa aceder à instância. Para saber mais, veja a documentação do Azure DevOps sobre como registar uma aplicação.
A tabela seguinte fornece orientações sobre como preencher o formulário de registo de aplicações:
| Campos Obrigatórios | Descrição | Valor Recomendado |
|---|---|---|
| Nome da Empresa | O nome da sua empresa. | Utilizar um valor adequado |
| Nome do aplicativo | Um valor exclusivo que identifica a aplicação que está a autorizar. | Pesquisa da Microsoft |
| Site da aplicação | O URL da aplicação que irá pedir acesso à instância do Azure DevOps durante a configuração do conector. (Obrigatório). | Para M365 Enterprise: https:// gcs.office.com/, Para o M365 Administração Pública: https:// gcsgcc.office.com/ |
| URL de chamada de retorno de autorização | Um URL de chamada de retorno necessário para o qual o servidor de autorização redireciona. | Para M365 Enterprise: https:// gcs.office.com/v1.0/admin/oauth/callback, For M365 Government: https:// gcsgcc.office.com/v1.0/admin/oauth/callback |
| Âmbitos autorizados | O âmbito de acesso da aplicação | Selecione os seguintes âmbitos: Identidade (leitura), Itens de Trabalho (leitura), Grupos de Variáveis (leitura), Projeto e equipa (leitura), Gráfico (leitura), Análise (leitura) |
Importante
Os âmbitos autorizados que selecionar para a aplicação devem corresponder exatamente aos âmbitos listados acima. Se omitir um dos âmbitos autorizados na lista ou adicionar outro âmbito, a autorização falhará.
Ao registar a aplicação com os detalhes acima, obterá o ID da Aplicação e o Segredo do Cliente que serão utilizados para configurar o conector.
Observação
Para revogar o acesso a qualquer aplicação registada no Azure DevOps, aceda a Definições de utilizador na parte superior direita da instância do Azure DevOps. Selecione Perfil e, em seguida, selecione Autorizações na secção Segurança do painel lateral. Paire o cursor sobre uma aplicação OAuth autorizada para ver o botão Revogar no canto dos detalhes da aplicação.
Definições de ligação
Depois de registar a aplicação Microsoft Search no Azure DevOps, pode concluir o passo de definições de ligação. Introduza o nome da sua organização, o ID da Aplicação e o Segredo do cliente.
Configurar dados: selecionar projetos e campos
Pode escolher a ligação para indexar toda a organização ou projetos específicos.
Se optar por indexar toda a organização, os itens em todos os projetos na organização serão indexados. Os novos projetos e itens serão indexados durante a próxima pesquisa depois de serem criados.
Se escolher projetos individuais, apenas os itens de trabalho nesses projetos serão indexados.
Observação
Os projetos do Azure DevOps podem ser pesquisados depois de lhes conceder as permissões Ver informações ao nível do projeto e Ver análise .
Em seguida, selecione os campos que pretende que a ligação indexe e pré-visualize os dados nestes campos antes de continuar.
Passo 4: Gerir permissões de pesquisa
O conector do Azure DevOps suporta permissões de pesquisa visíveis para Apenas pessoas com acesso a esta origem de dados ou a Todos. Se escolher Apenas pessoas com acesso a esta origem de dados, os dados indexados serão apresentados nos resultados da pesquisa para os utilizadores que têm acesso aos mesmos com base em permissões para utilizadores ou grupos ao nível do caminho organização, projeto ou área no Azure DevOps. Se escolher Todos, os dados indexados serão apresentados nos resultados da pesquisa para todos os utilizadores.
Passo 5: Atribuir etiquetas de propriedade
Siga as instruções de configuração gerais.
Passo 6: Gerir o esquema
Siga as instruções de configuração gerais.
Passo 7: escolher as definições de atualização
O conector do Azure DevOps suporta agendas de atualização para pesquisas completas e incrementais. A agenda recomendada é de uma hora para uma pesquisa incremental e um dia para uma pesquisa completa.
Passo 8: rever a ligação
Siga as instruções de configuração gerais.
Dica
Tipo de Resultado Predefinido
- O conector do Azure DevOps regista automaticamente um tipo de resultado assim que o conector for publicado. O tipo de resultado utiliza um esquema de resultados gerado dinamicamente com base nos campos selecionados no passo 3.
- Pode gerir o tipo de resultado ao navegar para Tipos de resultados no centro de administração do Microsoft 365. O tipo de resultado predefinido terá o nome "
ConnectionIdPredefinição". Por exemplo, se o ID de ligação forAzureDevOps, o esquema de resultados terá o nome: "AzureDevOpsDefault" - Além disso, pode optar por criar o seu próprio tipo de resultado, se necessário.
Solução de problemas
Depois de publicar a ligação, pode rever o estado no separador Origens de Dados no centro de administração. Para saber como fazer atualizações e eliminações, consulte Gerir o conector. Pode encontrar passos de resolução de problemas frequentemente vistos aqui.
Se tiver outros problemas ou quiser fornecer feedback, escreva-nos aka.ms/TalkToGraphConnectors.