Freigeben über


Verwenden von Azure Repos mit Microsoft Teams

Azure DevOps Services

Wenn Sie Microsoft Teams und Azure Repos verwenden, können Sie die Azure Repos-App für Teams zur Überwachung Ihrer Repositorys verwenden. Die App unterstützt die Überwachung von Git- und TFVC-Repositorys (Team Foundation-Versionskontrolle), nicht aber die Integration in GitHub-Repositorys.

In diesem Artikel erfahren Sie, wie Sie die folgenden Aufgaben erledigen können:

  • Hinzufügen der Azure Repos-App zu Ihrem Team in Microsoft Teams
  • Verbinden der Azure Repos-App mit Ihren Repositorys
  • Verwalten von Abonnements für repositorybezogene Ereignisse in Ihrem Kanal
  • Suchen und Freigeben von PR-Informationen mithilfe der Compose-Erweiterung
  • Anzeigen einer Vorschau für PR-URLs
  • Entfernen von Abonnements und Repositorys aus einem Kanal

Voraussetzungen

  • Verwalten Sie Ihr Abonnement, sodass Sie Benachrichtigungen in Ihrem Kanal erhalten, wenn Code gepusht oder eingecheckt wird, oder wenn ein Pull Request (PR) erstellt, aktualisiert oder zusammengeführt wird. Um Abonnements für repositorybezogene Ereignisse zu erstellen, müssen Sie Mitglied der Gruppe Projektadministratoren oder ein Teamadministrator sein. Informationen zum Hinzufügen finden Sie unter Ändern von Berechtigungen auf Projektebene oder Hinzufügen eines Teamadministrators.
  • Um Benachrichtigungen zu erhalten, aktivieren Sie die Einstellung Zugriff auf Anwendungen von Drittanbietern über OAuth für die Azure DevOps-Organisation. Weitere Informationen finden Sie unter Ändern von Anwendungszugriffsrichtlinien für Ihre Organisation.

Hinweis

  • Benachrichtigungen werden derzeit nicht in Direktnachrichten unterstützt.
  • Sie können die Azure Repos-App für Microsoft Teams nur mit einem Projekt verknüpfen, das in Azure DevOps Services gehostet wird.

Hinzufügen der Azure Repos-App zu einem Team in Microsoft Teams

  1. Wechseln Sie zur Azure Repos-App in Microsoft Teams, Microsoft Teams > Azure Repos.

  2. Wählen Sie Hinzufügen oder für den Fall, dass Sie die App bereits heruntergeladen haben, das Dropdownmenü neben Öffnen und dann Zu einem Team hinzufügen aus.

  3. Geben Sie einen Team- oder Kanalnamen ein, und wählen Sie dann Bot einrichten aus.

    Screenshot: Begrüßungsnachricht von Azure Repos in Teams

Verbinden der Azure Repos-App mit Ihren Repositorys

  1. Sobald die App in Ihrem Team installiert ist, geben Sie den folgenden Text in das Antwortfeld ein: @azure repos signin

    Wenn sich Microsoft Teams und Azure Boards in verschiedenen Mandanten befinden, wählen Sie Mit anderer E-Mail-Adresse anmelden aus.

    Screenshot: Anmeldungseintrag von Teams für Azure Repos

    Screenshot: Vollständige Antwort für Anmeldung

  2. Um alle Git-Repositorys in einem Projekt zu überwachen, geben Sie @azure repos subscribe [project url] in den Kanal ein. Fügen Sie unbedingt Ihre Projekt-URL hinzu. Die Projekt-URL kann zu einer beliebigen Seite innerhalb Ihres Projekts führen (außer URLs zu Repositorys).

    Sie können ein bestimmtes Repository auch mit Folgendem überwachen: @azure repos subscribe [repo url].

    Die Repository-URL kann zu einer beliebigen Seite innerhalb Ihres Repositorys führen, die den Namen Ihres Repositorys trägt, z. B. @azure repos subscribe https://dev.azure.com/myorg/myproject/_git/myrepo oder für TFVC-Repositorys: @azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl.

  3. Mit dem subscribe-Befehl können Sie mit einem Standardabonnement beginnen. Bei Git-Repositorys wird der Kanal für das Ereignis Pull Request erstellt (mit Zielbranch = Main) abonniert. Für TFVC-Repositorys wird der Kanal für das Ereignis Code eingecheckt abonniert.

    Screenshot: Standardmeldung zur Erstellung von Abonnements

Verwalten von Abonnements

Um Abonnements für einen Kanal anzuzeigen, hinzuzufügen und zu entfernen, geben Sie den folgenden Text ein: @azure repos subscriptions.

Es wird eine Liste aller aktuellen Abonnements für den Kanal angezeigt, und Sie können neue Abonnements hinzufügen oder vorhandene Abonnements entfernen. Passen Sie Ihre Benachrichtigungen mit verschiedenen Filtern an, wie im folgenden Abschnitt beschrieben.

Hinweis

Teamadministratoren können keine von Projektadministratoren erstellten Abonnements entfernen oder ändern.

Anzeigen von Abonnements

Verwenden von Filtern zum Abrufen ausschließlich erwünschter Benachrichtigungen

Wenn Sie ein Repository mit @azure repos subscribe abonnieren, wird ein Standardabonnement erstellt, auf das keine Filter angewendet sind. Oft müssen Benutzer diese Abonnements anpassen, um nur dann benachrichtigt zu werden, wenn bestimmte Bedingungen erfüllt sind. Der folgende Screenshot zeigt ein Beispiel dafür, wie Sie Benachrichtigungen nur dann einrichten können, wenn sich unser Team in der Reviewerliste für einen PR befindet.

  1. Geben Sie den folgenden Text in Ihren Kanal ein: @azure repos subscriptions.

  2. Wenn es in der Liste der Abonnements ein Abonnement gibt, das nicht erwünscht ist oder geändert werden muss, wählen Sie Entfernen aus, um es zu löschen.

  3. Wählen Sie die Schaltfläche Abonnement hinzufügen aus.

  4. Wählen Sie einen Ereignistyp und dann Weiter aus.

    Screenshot: Auswahl des Ereignistyps

  5. Wählen Sie ein Repository und dann Weiter aus.

    Screenshot: Repositoryauswahl

  6. Wählen Sie die entsprechenden Filter, um Ihr Abonnement anzupassen, und wählen Sie dann Übermitteln aus.

    Screenshot: Ausgewählte Filter

Hinweis

  • Bei allen Filtern handelt es sich in der Regel um Dropdownlisten. Wenn die Dropdownliste jedoch mehr als 100 Elemente enthält, müssen Sie die Werte manuell eingeben.
  • Für das TFVC-Ereignis Code eingecheckt muss der Filter Unter Pfad das Format $/myproject/path aufweisen.

Suchen und Freigeben von Informationen zu Pull Requests mithilfe der Compose-Erweiterung

Damit Benutzer Informationen zu Pull Requests suchen und freigeben können, unterstützt die Azure Repos-App für Microsoft Teams eine Compose-Erweiterung. Sie können über die ID oder den Namen nach Pull Requests suchen. Damit die Erweiterung funktioniert, melden Sie sich beim Azure Repos-Projekt an, indem Sie @azure repos signin eingeben oder sich direkt bei der Compose-Erweiterung anmelden.

Screenshot: Compose-Erweiterung

Anzeigen einer Vorschau der Pull Request-URLs

Wenn Sie die URL eines PRs einfügen, wird eine Vorschau wie in der folgenden Abbildung angezeigt, was dazu beiträgt, dass PR-bezogene Unterhaltungen kontextbezogen und exakt bleiben. Sie müssen angemeldet sein, dann können Sie eine Vorschau der PRs für URLs in allen Kanälen in einem Team anzeigen.

Screenshot: Verbreitung der URL

Entfernen von Abonnements und Repositorys aus einem Kanal

Um alle Abonnements für ein beliebiges Repository im Projekt zu löschen und die Repositorys aus dem Kanal zu entfernen, geben Sie den folgenden Text in Teams ein: @azure repos unsubscribe all [project url]. Stellen Sie sicher, dass Sie die Projekt-URL eingeben. Nur Projektadministratoren können diese Aufgabe ausführen.

Threadbenachrichtigungen

Um eine Reihe von zusammenhängenden Benachrichtigungen zu verknüpfen und auch um den von den Benachrichtigungen belegten Platz in einem Kanal zu reduzieren, werden die Benachrichtigungen in Threads zusammengefasst. Alle Benachrichtigungen, die mit einem bestimmten Pull Request verbunden sind, werden miteinander verknüpft.

Kompakte Ansicht der ThreadbenachrichtigungenScreenshot: Kompakte Ansicht der Threadbenachrichtigungen

Erweiterte Ansicht der ThreadbenachrichtigungenScreenshot: Erweiterte Ansicht der Threadbenachrichtigungen

Befehlsreferenz

In der folgenden Tabelle sind alle azure repos-Befehle aufgeführt, die Sie in Ihrem Teams-Kanal verwenden können.

Befehl Funktionalität
@azure repos subscribe [repo url/ project url] Abonnieren eines Repositorys oder aller Repositorys in einem Projekt zum Empfangen von Benachrichtigungen
@azure repos subscriptions Hinzufügen oder Entfernen von Abonnements für diesen Kanal
@azure repos signin Anmelden bei Ihrer Azure Repos-Organisation
@azure repos signout Abmelden von Ihrer Azure Repos-Organisation
@azure repos feedback Melden eines Problems oder Vorschlagen eines Features
@azure repos unsubscribe all [project url] Entfernen aller Repositorys (zu einem Projekt gehörend) und deren zugeordneten Abonnements aus einem Kanal

Unterstützung mehrerer Mandanten

Wenn Sie eine andere E-Mail oder einen anderen Mandanten für Microsoft Teams und Azure DevOps verwenden, führen Sie je nach Anwendungsfall die folgenden Schritte aus, um sich anzumelden.

Anwendungsfall E-Mail-ID und Microsoft Teams-Mandant E-Mail-ID und Azure DevOps-Mandant Schritte
1 email1@abc.com (Mandant 1) email1@abc.com (Mandant 1) Wählen Sie Anmelden.
2 email1@abc.com (Mandant 1) email1@abc.com (Mandant 2) Melden Sie sich bei Azure DevOps an. Starten Sie im selben Browser eine neue Registerkarte, und wechseln Sie zu https://teams.microsoft.com/. Führen Sie den Anmeldebefehl aus, und wählen Sie Anmelden aus.
3 email1@abc.com (Mandant 1) email2@pqr.com (Mandant 2) Wählen Sie Mit anderer E-Mail-Adresse anmelden aus, und verwenden Sie dann in der E-Mail-ID-Auswahl die andere E-Mail-Adresse, um sich bei Azure DevOps anzumelden.
4 email1@abc.com (Mandant 1) email2@pqr.com (nicht Standardmandant 3) Dieses Szenario wird nicht unterstützt.

Problembehandlung

Wenn bei Ihnen die folgenden Fehler auftreten, wenn Sie die Azure Repos-App verwenden, befolgen Sie die Verfahren in diesem Abschnitt.

Das hat leider nicht geklappt. Wiederholen Sie den Vorgang.

Die Azure Repos-App verwendet das OAuth-Authentifizierungsprotokoll und erfordert die Aktivierung von Zugriff auf Anwendungen von Drittanbietern über OAuth für die Organisation. Um diese Einstellung zu aktivieren, navigieren Sie zu Organisationseinstellungen>Sicherheit>Richtlinien, und legen Sie die Einstellung Zugriff auf Anwendungen von Drittanbietern über OAuth für die Organisation auf Ein fest.

Aktivieren der Einstellung „Zugriff auf Anwendungen von Drittanbietern über OAuth für die Organisation“

Die Konfiguration ist fehlgeschlagen. Vergewissern Sie sich, dass die Organisation „{organization name}“ existiert und dass Sie über ausreichende Berechtigungen verfügen.

Melden Sie sich von Azure DevOps ab, indem Sie mithilfe Ihres Browsers zu https://aka.ms/VsSignout navigieren.

Öffnen Sie ein Browserfenster vom Typ InPrivate oder Inkognito, und navigieren Sie zu https://aex.dev.azure.com/me, um sich anzumelden. Wählen Sie in der Dropdownliste unter dem Profilsymbol auf der linken Seite das Verzeichnis aus, das die Organisation enthält, in der sich das Repository befindet, das Sie abonnieren möchten.

Auswählen des Verzeichnisses, das die Organisation enthält, die wiederum das Projekt enthält

Starten Sie im selben Browser eine neue Registerkarte, und wechseln Sie zu https://teams.microsoft.com/. Führen Sie den @Azure Repos signout-Befehl und anschließend den Befehl @Azure Repos signin in dem Kanal aus, in dem die Azure Repos-App für Microsoft Teams installiert ist.

Wählen Sie die Sign in-Schaltfläche aus, und Sie werden zu einer Zustimmungsseite wie im folgenden Beispiel weitergeleitet. Stellen Sie sicher, dass das neben der E-Mail angezeigte Verzeichnis mit dem Verzeichnis identisch ist, das Sie im vorherigen Schritt ausgewählt haben. Akzeptieren und den Anmeldevorgang abschließen.

Zustimmung zu den angeforderten App-Berechtigungen

Wenn ihr Authentifizierungsproblem mit diesen Schritten nicht behoben werden kann, wenden Sie sich unter Entwicklercommunity an uns.