Azure DevOps Connector (Vorschau)Azure DevOps connector (preview)

Mit dem Azure DevOps-Connector kann Ihre Organisation Arbeitsaufgaben in Ihrer Instanz des Azure DevOps-Diensts indizieren.With the Azure DevOps connector, your organization can index work items in its instance of the Azure DevOps service. Nachdem Sie den Connector-und den Index Inhalt aus Azure DevOps konfiguriert haben, können Endbenutzer nach diesen Elementen in der Microsoft-Suche suchen.After you configure the connector and index content from Azure DevOps, end users can search for those items in Microsoft Search.

Dieser Artikel richtet sich an Microsoft 365-Administratoren oder Personen, die einen Azure DevOps-Connector konfigurieren, ausführen und überwachen.This article is for Microsoft 365 administrators or anyone who configures, runs, and monitors an Azure DevOps connector. Es wird erläutert, wie Sie die Connector-und connectorfunktionen, Einschränkungen und Techniken zur Problembehandlung konfigurieren.It explains how to configure your connector and connector capabilities, limitations, and troubleshooting techniques.

Wichtig

Der Azure DevOps-Connector unterstützt nur den Azure DevOps Cloud Service.The Azure DevOps connector supports only the Azure DevOps cloud service. Azure DevOps Server 2019, TFS 2018, TFS 2017, TFS 2015 und TFS 2013 werden von diesem Connector nicht unterstützt.Azure DevOps Server 2019, TFS 2018, TFS 2017, TFS 2015, and TFS 2013 are not supported by this connector.

Herstellen einer Verbindung mit einer DatenquelleConnect to a data source

Um eine Verbindung mit ihrer Azure DevOps-Instanz herzustellen, benötigen Sie Ihren Azure DevOps- Organisations Namen, die APP-ID und den geheimen Client Schlüssel für die OAuth-Authentifizierung.To connect to your Azure DevOps instance, you need your Azure DevOps organization name, its App ID, and client secret for OAuth authentication.

Registrieren einer AppRegister an app

Sie müssen eine app in Azure DevOps registrieren, damit die Microsoft Search-App auf die Instanz zugreifen kann.You must register an app in Azure DevOps so that the Microsoft Search app can access the instance. Weitere Informationen finden Sie unter Azure DevOps-Dokumentation zum Registrieren einer APP.To learn more, see Azure DevOps documentation on how to register an app.

In der folgenden Tabelle finden Sie Anleitungen zum Ausfüllen des App-Registrierungsformulars:The following table provides guidance on how to fill out the app registration form:

Obligatorische FelderMandatory Fields BeschreibungDescription Empfohlener WertRecommended Value
FirmennameCompany Name Dies ist der Name Ihres Unternehmens.This is the name of your company. Verwenden eines geeigneten WertsUse an appropriate value
AnwendungsnameApplication name Dieser eindeutige Wert identifiziert die Anwendung, die Sie zu autorisieren haben.This unique value identifies the application that you're authorizing. Microsoft SearchMicrosoft Search
AnwendungswebsiteApplication website Dieses erforderliche Feld ist die URL der Anwendung, die während des Connector-Setups Zugriff auf Ihre Azure DevOps-Instanz anfordert.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/
Autorisierungs-Rückruf-URLAuthorization callback URL Eine erforderliche Rückruf-URL, an die der autorisierungsserver umgeleitet wird.A required callback URL that the authorization server redirects to. https://gcs.office.com/v1.0/admin/oauth/callback
Autorisierte BereicheAuthorized scopes Dies ist der Umfang des Zugriffs für die Anwendung.This is the scope of access for the application Wählen Sie die folgenden Bereiche aus: Identity (lesen), Arbeitsaufgaben (lesen), Variablen Gruppen (lesen), Projekt und Team (lesen), Grafik (lesen)Select the following scopes: Identity (read), Work Items (read), Variable Groups (read), Project and team (read), Graph (read)

Beim Registrieren der APP mit den obigen Details erhalten Sie die App-ID und den geheimen Client Schlüssel , die zum Konfigurieren des Connectors verwendet werden.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.

Hinweis

Um den Zugriff auf alle in Azure DevOps registrierten apps aufzuheben, wechseln Sie zu Benutzereinstellungen rechts oben in ihrer Azure DevOps-Instanz.To revoke access to any app registered in Azure DevOps, go to User settings at the right top of your Azure DevOps instance. Klicken Sie auf Profil, und klicken Sie dann im Abschnitt Sicherheit des Seitenbereichs auf Berechtigungen.Click on Profile and then click on Authorizations in the Security section of the side pane. Zeigen Sie mit der Maus auf eine autorisierte OAuth-APP, um die Schaltfläche Widerrufen an der Ecke der App-Details anzuzeigen.Hover over an authorized OAuth app to see the Revoke button at the corner of the app details.

VerbindungseinstellungenConnection settings

Nachdem Sie die Microsoft Search-App mit Azure DevOps registriert haben, können Sie den Schritt Verbindungseinstellungen durchführen.After registering the Microsoft Search app with Azure DevOps, you can complete the connection settings step. Geben Sie den Namen Ihrer Organisation, die APP-ID und den geheimen Client Schlüssel ein.Enter your organization name, App ID, and Client secret.

Einstellungen für die Verbindungsanwendung

Auswählen von Projekten und FeldernSelect projects and fields

Sie können auswählen, ob die Verbindung entweder die gesamte Organisation oder bestimmte Projekte indizieren soll.You can choose for the connection to index either the entire organization or specific projects.

Wenn Sie sich dafür entscheiden, die gesamte Organisation zu indizieren, werden Elemente in allen Projekten in der Organisation indiziert.If you choose to index the entire organization, items in all projects in the organization will get indexed. Neue Projekte und Elemente werden während der nächsten Durchforstung indiziert, nachdem Sie erstellt wurden.New projects and items will be indexed during the next crawl after they are created. Wenn Sie einzelne Projekte auswählen, werden nur Arbeitsaufgaben in diesen Projekten indiziert.If you choose individual projects, only work items in those projects will be indexed.

Konfigurieren von Daten

Wählen Sie als nächstes aus, welche Felder die Verbindung indizieren soll, und sehen Sie sich die Daten in diesen Feldern in der Vorschau an, bevor Sie fortfahren.Next, select which fields you want the connection to index and preview data in these fields before proceeding.

Auswählen von Eigenschaften

Verwalten von SuchberechtigungenManage search permissions

Der Azure DevOps-Connector unterstützt Suchberechtigungen, die  nur für Personen mit Zugriff auf diese Datenquelle oder für alle sichtbar sind.The Azure DevOps connector supports search permissions visible to  Only people with access to this data source or Everyone. Wenn Sie nur Personen mit Zugriff auf diese Datenquelle auswählen, werden indizierte Daten in den Suchergebnissen für Benutzer angezeigt, die basierend auf den Berechtigungen für Benutzer oder Gruppen auf Organisations-, Projekt-oder Bereichspfad Ebene in Azure DevOps auf diese zugreifen können.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. Wenn Sie alle auswählen, werden indizierte Daten für alle Benutzer in den Suchergebnissen angezeigt.If you choose Everyone, indexed data will appear in the search results for all users.

Zuweisen von Eigenschaften BezeichnungenAssign property labels

Sie können jeder Beschriftung eine Source-Eigenschaft zuweisen, indem Sie in einem Menü mit Optionen auswählen.You can assign a source property to each label by choosing from a menu of options. Dieser Schritt ist zwar nicht zwingend erforderlich, aber einige Eigenschaften Bezeichnungen verbessern die Suchrelevanz und stellen genauere Suchergebnisse für Endbenutzer sicher.While this step is not mandatory, having some property labels will improve the search relevance and ensure more accurate search results for end users.

Schema verwaltenManage schema

Auf dem Bildschirm " Schema verwalten " haben Sie die Möglichkeit, die den Eigenschaften zugeordneten Schema Attribute ( abfragbar, durchsuchbar, abrufbar und verfeinernd) zu ändern, optionale Aliase hinzuzufügen und die Content -Eigenschaft auszuwählen.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.

Festlegen des AktualisierungszeitplansSet the refresh schedule

Der Azure DevOps-Connector unterstützt Aktualisierungs Zeitpläne für vollständige und inkrementelle Crawls.The Azure DevOps connector supports refresh schedules for both full and incremental crawls. Bei einer vollständigen Durchforstung werden gelöschte Arbeitsaufgaben gesucht, die zuvor mit dem Microsoft-Suchindex synchronisiert wurden.A full crawl finds deleted work items that were previously synced to the Microsoft Search index. Eine vollständige Durchforstung wird ausgeführt, um alle Arbeitsaufgaben zu synchronisieren.A full crawl runs to sync all the work items. Um neue Arbeitsaufgaben und Aktualisierungen an vorhandenen Arbeitsaufgaben zu synchronisieren, müssen Sie inkrementelle Durchforstungen planen.To sync new work items and updates to existing work items, you need to schedule incremental crawls.

Der empfohlene Zeitplan beträgt eine Stunde für eine inkrementelle Durchforstung und einen Tag für eine vollständige Durchforstung.The recommended schedule is one hour for an incremental crawl and one day for a full crawl.