Conector microsoft Graph do Wiki do Azure DevOps
O conector do Wiki Graph do Azure DevOps permite que a sua organização indexe wikis na instância do serviço Azure DevOps. Depois de configurar o conector, os utilizadores finais podem procurar wikis de projetos e wikis de código do Azure DevOps no Microsoft Search.
Observação
- Leia o artigo Setup for your Graph connector (Configuração do conector do Graph ) para compreender as instruções gerais de configuração dos conectores do Graph.
Este artigo destina-se a qualquer pessoa que configure, execute e monitorize um conector do Wiki Graph do Azure DevOps. Complementa o processo de configuração geral e mostra instruções que se aplicam apenas ao conector do Wiki Graph do Azure DevOps.
Importante
O conector Wiki 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 de pesquisa 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. |
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 do Graph no centro de administração do Microsoft 365
Adicionar o conector Wiki do Azure DevOps
Siga as instruções de configuração gerais.
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 ID da Aplicação da conta do Azure DevOps 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 registar a aplicação, visite a ligação para registar a aplicação. 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), Código (leitura), Elegibilidades (Leitura), Projeto e equipa (leitura), Grafo (leitura), Gestão de Entidades Membros (leitura), Wiki (leitura) |
Importante
Os âmbitos autorizados selecionados para a aplicação devem corresponder exatamente aos âmbitos listados acima. Se estiverem selecionados mais ou menos âmbitos, 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 ID da Aplicação e o Segredo do cliente.
Configurar dados: selecionar organização, projetos e campos
Neste passo, vai especificar o âmbito dos dados que pretende indexar com o conector de gráficos Wiki do Azure DevOps.
Como primeiro passo, pode escolher a organização à qual pretende indexar, de todas as organizações às quais tem acesso. Em seguida, pode escolher a ligação para indexar toda a organização ou projetos específicos na organização selecionada.
Se optar por indexar toda a organização, os wikis em todos os projetos na organização serão indexados. Os novos projetos e wikis serão indexados durante a próxima pesquisa depois de serem criados.
Se optar por indexar projetos individuais, apenas os wikis nos projetos selecionados serão indexados.
Passo 4: Gerir permissões de pesquisa
O conector do Azure DevOps suporta permissões de pesquisa visíveis para Todos. Com a opção 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 Wiki do Azure DevOps suporta agendas de atualização para pesquisas completas e incrementais. A agenda recomendada é de uma hora para uma pesquisa incremental e uma semana para uma pesquisa completa.
Passo 8: rever a ligação
Siga as instruções de configuração gerais.
Passo 9: Configurar a página de resultados da pesquisa
Depois de publicar a ligação, tem de personalizar a página de resultados da pesquisa com verticais e tipos de resultados. Para saber mais sobre como personalizar os resultados da pesquisa, reveja como gerir verticais e tipos de resultados. Também pode utilizar o esquema de resultados de exemplo para o conector Wiki do Azure DevOps. Basta copiar e colar o JSON do esquema de resultados para começar.
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.