Connettore di DevOps di Azure (anteprima)Azure DevOps connector (preview)

Con il connettore di Azure DevOps, l'organizzazione può indicizzare gli elementi di lavoro nella relativa istanza del servizio DevOps di Azure.With the Azure DevOps connector, your organization can index work items in its instance of the Azure DevOps service. Dopo aver configurato il connettore e l'indice del contenuto da Azure DevOps, gli utenti finali possono cercare gli elementi in Microsoft Search.After you configure the connector and index content from Azure DevOps, end users can search for those items in Microsoft Search.

Questo articolo è per gli amministratori di Microsoft 365 o per tutti coloro che configurano, eseguono e monitora un connettore di DevOps di Azure.This article is for Microsoft 365 administrators or anyone who configures, runs, and monitors an Azure DevOps connector. In questo articolo viene illustrato come configurare le funzionalità di connettore e connettore, le limitazioni e le tecniche di risoluzione dei problemi.It explains how to configure your connector and connector capabilities, limitations, and troubleshooting techniques.

Importante

Il connettore di Azure DevOps supporta solo il servizio cloud di DevOps di Azure.The Azure DevOps connector supports only the Azure DevOps cloud service. Azure DevOps server 2019, TFS 2018, TFS 2017, TFS 2015 e TFS 2013 non sono supportati da questo connettore.Azure DevOps Server 2019, TFS 2018, TFS 2017, TFS 2015, and TFS 2013 are not supported by this connector.

Connettersi a un'origine datiConnect to a data source

Per connettersi all'istanza di Azure DevOps, è necessario il nome dell' organizzazione di Azure DevOps, il relativo ID app e il segreto client per l'autenticazione OAuth.To connect to your Azure DevOps instance, you need your Azure DevOps organization name, its App ID, and client secret for OAuth authentication.

Registrare un'appRegister an app

È necessario registrare un'app in Azure DevOps in modo che l'app di ricerca di Microsoft possa accedere all'istanza.You must register an app in Azure DevOps so that the Microsoft Search app can access the instance. Per ulteriori informazioni, vedere la documentazione di Azure DevOps su come registrare un'app.To learn more, see Azure DevOps documentation on how to register an app.

Nella tabella seguente vengono fornite indicazioni su come compilare il modulo di registrazione delle app:The following table provides guidance on how to fill out the app registration form:

Campi obbligatoriMandatory Fields DescrizioneDescription Valore consigliatoRecommended Value
Nome della societàCompany Name Questo è il nome della società.This is the name of your company. Utilizzare un valore appropriatoUse an appropriate value
Nome applicazioneApplication name Questo valore univoco identifica l'applicazione che si sta autorizzando.This unique value identifies the application that you're authorizing. Microsoft SearchMicrosoft Search
Sito Web dell'applicazioneApplication website Questo campo obbligatorio è l'URL dell'applicazione che richiederà l'accesso all'istanza di Azure DevOps durante l'installazione del connettore.This required field is the URL of the application that will request access to your Azure DevOps instance during connector setup. https://gcs.office.com/
URL di callback di autorizzazioneAuthorization callback URL Un URL di callback obbligatorio a cui il server di autorizzazione reindirizza.A required callback URL that the authorization server redirects to. https://gcs.office.com/v1.0/admin/oauth/callback
Ambiti autorizzatiAuthorized scopes Questo è l'ambito di accesso per l'applicazioneThis is the scope of access for the application Selezionare gli ambiti seguenti: Identity (lettura), elementi di lavoro (lettura), gruppi di variabili (lettura), progetto e team (lettura), grafico (lettura)Select the following scopes: Identity (read), Work Items (read), Variable Groups (read), Project and team (read), Graph (read)

Durante la registrazione dell'app con i dettagli sopra riportati, si otterrà l' ID app e il segreto client che verrà utilizzato per configurare il connettore.On registering the app with the details above, you will get the App ID and Client Secret that will be used to configure the connector.

Nota

Per revocare l'accesso a qualsiasi applicazione registrata in Azure DevOps, passare a impostazioni utente all'inizio destro dell'istanza di DevOps di Azure.To revoke access to any app registered in Azure DevOps, go to User settings at the right top of your Azure DevOps instance. Fare clic su profilo e quindi su autorizzazioni nella sezione sicurezza del riquadro laterale.Click on Profile and then click on Authorizations in the Security section of the side pane. Posizionare il puntatore del mouse su un'app OAuth autorizzata per visualizzare il pulsante revoca all'angolo dei dettagli dell'app.Hover over an authorized OAuth app to see the Revoke button at the corner of the app details.

Impostazioni di connessioneConnection settings

Dopo la registrazione dell'app di ricerca di Microsoft con Azure DevOps, è possibile completare il passaggio delle impostazioni di connessione.After registering the Microsoft Search app with Azure DevOps, you can complete the connection settings step. Immettere il nome dell'organizzazione, l'ID app e il segreto client.Enter your organization name, App ID, and Client secret.

Impostazioni dell'applicazione di connessione

Selezionare progetti e campiSelect projects and fields

È possibile scegliere di indicizzare l'intera organizzazione o i progetti specifici per la connessione.You can choose for the connection to index either the entire organization or specific projects.

Se si sceglie di indicizzare l'intera organizzazione, gli elementi in tutti i progetti nell'organizzazione verranno indicizzati.If you choose to index the entire organization, items in all projects in the organization will get indexed. I nuovi progetti e gli elementi verranno indicizzati durante la ricerca per indicizzazione successiva dopo la loro creazione.New projects and items will be indexed during the next crawl after they are created. Se si scelgono singoli progetti, verranno indicizzati solo gli elementi di lavoro di tali progetti.If you choose individual projects, only work items in those projects will be indexed.

Configurazione dei dati

Successivamente, selezionare i campi in cui si desidera che la connessione indici e visualizza in anteprima i dati in questi campi prima di continuare.Next, select which fields you want the connection to index and preview data in these fields before proceeding.

Scegliere Proprietà

Gestire le autorizzazioni di ricercaManage search permissions

Il connettore di Azure DevOps supporta le autorizzazioni di ricerca visibili  solo agli utenti che dispongono dell'accesso a questa origine dati o a tutti.The Azure DevOps connector supports search permissions visible to  Only people with access to this data source or Everyone. Se si sceglie solo persone con accesso a questa origine dati, i dati indicizzati verranno visualizzati nei risultati di ricerca per gli utenti che dispongono dell'accesso in base alle autorizzazioni per gli utenti o i gruppi a livello dell'organizzazione, del progetto o dell'area del percorso in Azure DevOps.If you choose Only people with access to this data source,indexed data will appear in the search results for users who have access to them based on permissions to users or groups at the Organization, Project or Area path level in Azure DevOps. Se si sceglie tutti, i dati indicizzati verranno visualizzati nei risultati della ricerca per tutti gli utenti.If you choose Everyone, indexed data will appear in the search results for all users.

Assegnare etichette delle proprietàAssign property labels

È possibile assegnare una proprietà di origine a ogni etichetta scegliendo da un menu di opzioni.You can assign a source property to each label by choosing from a menu of options. Anche se questo passaggio non è obbligatorio, l'utilizzo di alcune etichette di proprietà migliorerà la pertinenza della ricerca e assicurerà risultati di ricerca più accurati per gli utenti finali.While this step is not mandatory, having some property labels will improve the search relevance and ensure more accurate search results for end users.

Gestione dello schemaManage schema

Nella schermata Gestisci schema è possibile modificare gli attributi dello schema (Queryable, Searchable, Retrievable e per affinamento ricerca) associati alle proprietà, aggiungere alias facoltativi e scegliere la proprietà Content .On the Manage Schema screen, you have the option to change the schema attributes (queryable, searchable, retrievable, and refinable) associated with the properties, add optional aliases, and choose the Content property.

Impostare la pianificazione di aggiornamentoSet the refresh schedule

Il connettore di Azure DevOps supporta le pianificazioni di aggiornamento per le ricerche per indicizzazione complete e incrementali.The Azure DevOps connector supports refresh schedules for both full and incremental crawls. Una ricerca per indicizzazione completa trova gli elementi di lavoro eliminati precedentemente sincronizzati con l'indice di ricerca di Microsoft.A full crawl finds deleted work items that were previously synced to the Microsoft Search index. Viene eseguita una ricerca per indicizzazione completa per sincronizzare tutti gli elementi di lavoro.A full crawl runs to sync all the work items. Per sincronizzare nuovi elementi di lavoro e aggiornamenti per gli elementi di lavoro esistenti, è necessario pianificare ricerche per indicizzazione incrementali.To sync new work items and updates to existing work items, you need to schedule incremental crawls.

La pianificazione consigliata è un'ora per una ricerca per indicizzazione incrementale e un giorno per una ricerca per indicizzazione completa.The recommended schedule is one hour for an incremental crawl and one day for a full crawl.