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
Wechseln Sie zur Azure Repos-App in Microsoft Teams, Microsoft Teams > Azure Repos.
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.
Geben Sie einen Team- oder Kanalnamen ein, und wählen Sie dann Bot einrichten aus.
Verbinden der Azure Repos-App mit Ihren Repositorys
Sobald die App in Ihrem Team installiert ist, geben Sie den folgenden Text in das Antwortfeld ein:
@azure repos signinWenn sich Microsoft Teams und Azure Boards in verschiedenen Mandanten befinden, wählen Sie Mit anderer E-Mail-Adresse anmelden aus.
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/myrepooder für TFVC-Repositorys:@azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl.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.
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.
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.
Geben Sie den folgenden Text in Ihren Kanal ein:
@azure repos subscriptions.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.
Wählen Sie die Schaltfläche Abonnement hinzufügen aus.
Wählen Sie einen Ereignistyp und dann Weiter aus.
Wählen Sie ein Repository und dann Weiter aus.
Wählen Sie die entsprechenden Filter, um Ihr Abonnement anzupassen, und wählen Sie dann Übermitteln aus.
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/pathaufweisen.
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.
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.
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 Threadbenachrichtigungen
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 Konfiguration ist fehlgeschlagen. Vergewissern Sie sich, dass die Organisation „{organization name}“ existiert und dass Sie über ausreichende Berechtigungen verfügen.
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.
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.
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.
Wenn ihr Authentifizierungsproblem mit diesen Schritten nicht behoben werden kann, wenden Sie sich unter Entwicklercommunity an uns.