Verwenden der Azure Boards-App in Microsoft Teams

Azure DevOps Services

Wenn Sie Microsoft Teams verwenden, können Sie Arbeitselemente erstellen und die Arbeitselementaktivität in Ihrem Azure Boards-Projekt über Ihren Teams-Kanal überwachen. Sie erreichen dies, indem Sie die Azure Boards App für Microsoft Teams zu Ihrem Teams-Kanal hinzufügen.

Mit der Azure Boards-App für Microsoft Teams können Benutzer die folgenden Aufgaben ausführen:

• Einrichten und Verwalten von Abonnements zum Erstellen und Aktualisieren von Arbeitselementen
• Verwalten von anderen Arbeitselementereignissen
• Empfangen und Verwalten von Benachrichtigungen für Arbeitselementereignisse in ihrem Teams-Kanal
• Erstellen von Arbeitselementen aus Unterhaltungen im Kanal
• Suchen und Freigeben von Arbeitselementen für andere Mitglieder im Kanal mithilfe der Messagingerweiterung
• Anzeigen von Vorschauversionen für Arbeitselemente über ihre URLs, um Diskussionen zu starten und die Unterhaltungen kontextbezogen zu halten.

Lesen Sie diesen Artikel, um Folgendes zu erfahren:

• Hinzufügen der Azure Boards-App zu Ihrem Team in Microsoft Teams
• Verknüpfen Ihres Azure Boards-Projekts mit der Azure Boards-App und Aufheben der Verknüpfung
• Einrichten von Abonnements für auf Arbeitselemente bezogene Ereignisse in Ihrem Teams-Kanal
• Erstellen von Arbeitselementen von Ihrem Teams-Kanal aus
• Überwachen der Arbeitselementaktivität in Ihrem Teams-Kanal

Hinweis

Integration von Azure Boards und Microsoft Teams wird nur für Azure DevOps Services unterstützt.

Außerdem wird die Integration von Azure Boards und Microsoft Teams nicht unterstützt, wenn Sie ein O365 Government Community Cloud (GCC)-Kunde sind und ein Azure Commercial-Abonnement in Verbindung mit Ihrem GCC-Mandanten verwenden.

Voraussetzungen

• Um ein Arbeitselement zu erstellen, müssen Sie Mitwirkender beim Azure Boards-Projekt sein. Wenn Sie noch kein Projekt haben, können Sie sich registrieren und ein Projekt erstellen. Weitere Informationen finden Sie unter Erste Schritte mit Azure Boards.
• Um Abonnements in einem Teams-Kanal für Arbeitselementereignisse zu erstellen, müssen Sie Mitglied der Azure Boards-Projektadministratoren-Gruppe sein oder der Teamadministratorrolle für das Team hinzugefügt werden. Informationen zum Hinzufügen finden Sie unter Ändern von Berechtigungen auf Projektebene oder Hinzufügen eines Teamadministrators.
• Um Benachrichtigungen zu erhalten, müssen Sie die Einstellung Zugriff auf Anwendungen von Drittanbietern über OAuth für die Azure DevOps-Organisation aktivieren. Weitere Informationen finden Sie unter Ändern von Anwendungszugriffsrichtlinien für Ihre Organisation.

Hinweis

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

Hinzufügen der Azure Boards-App zu Microsoft Teams

Sie fügen die App Ihrem Teams-Kanal in Microsoft Teams hinzu.

1. Besuchen Sie den App Store in Microsoft Teams, und suchen Sie die Azure Boards-App. Nach der Installation wird eine Begrüßungsmeldung der App angezeigt, wie in der folgenden Abbildung dargestellt.

   

2. Verwenden Sie das @azure boards-Handle, um mit der App zu interagieren. Eine Liste der Befehle finden Sie weiter unten in diesem Artikel unter Befehlsreferenz.

Verknüpfen Ihres Azure Boards-Projekts mit der Azure Boards-App

Um die App zu verwenden, müssen Sie zuerst Ihr Azure Boards-Projekt mit Ihrem Teams-Kanal verknüpfen.

1. Nachdem die App in Ihrem Team installiert wurde, stellen Sie eine Verbindung her, und authentifizieren Sie sich bei Azure Boards. Wenn sich Microsoft Teams und Azure Boards in verschiedenen Mandanten befinden, wählen Sie Mit anderer E-Mail-Adresse anmelden aus.

   

   

2. Verwenden Sie nach der Anmeldung den folgenden Befehl in einem Teams-Kanal, um eine Verknüpfung mit dem Azure Boards-Projekt zu erstellen, das Sie mit der URL angeben:

    @azure boards link [project url]
   

   Beispiel:

    @azure boards link https://dev.azure.com/myorg/myproject
   

Sobald das Projekt verknüpft ist, können Sie Arbeitselemente mithilfe eines @azure boards create-Befehls erstellen oder Meldungsaktionen verwenden.

Einrichten von Abonnements

Mit dem @azure boards subscriptions-Befehl können Sie Abonnements erstellen, um jederzeit Arbeitselemente zu überwachen.

1. Wählen Sie den gewünschten Bereichspfad und das gewünschte Ereignis aus. Verwenden Sie die zugeordneten Filter, um anzupassen, worüber Sie in Ihrem Teams-Kanal benachrichtigt werden. Um das Einrichten von Abonnements zu vereinfachen, werden die zuletzt aufgerufenen Bereichspfade in der Bereichspfad-Dropdownliste angezeigt.

   

Falls der gewünschte Bereichspfad nicht im Bereichspfad-Dropdownmenü angezeigt wird, befolgen Sie die Anweisungen im nächsten Abschnitt, Hinzufügen von Bereichspfaden. Bereichspfade, die mithilfe des @azure boards addAreapath-Befehls hinzugefügt wurden, und Bereichspfade, für die Abonnements im Kanal erstellt werden, werden immer in der Bereichspfad-Dropdownliste zusammen mit zuletzt aufgerufenen Bereichspfaden angezeigt.

Hinzufügen von Bereichspfaden

Sie können dem Kanal Bereiche hinzufügen, an denen Ihr Team arbeitet, sodass sie immer zum Erstellen von Arbeitselementen und Abonnements verfügbar sind. Dieses Feature ist nützlich für Teams, deren Projekt mehr als 100 Bereichspfade enthält.

• Verwenden Sie den folgenden Befehl, um dem Teams-Kanal Bereichspfade aus Ihrem Projekt hinzuzufügen.

    @azure boards addAreapath [area path] 
  

  Beispiel:

    @azure boards addAreapath myproject\fabrikam
  

  

• Wenn Sie den Projektnamen als Bereichspfad auswählen, erhalten Sie Benachrichtigungen für alle Bereichspfade im Projekt.

Erstellen eines Arbeitselements mit einem Befehl

Mit der Azure Boards-App können Sie Arbeitselemente aus Ihrem Kanal erstellen. Die App unterstützt auch benutzerdefinierte Arbeitselemente.

• Verwenden Sie @azure boards create zum Erstellen eines Arbeitselements.

  

Erstellen eines Arbeitselements aus Meldungsaktionen

Häufig erfordern Diskussionen in einem Kanal die Erstellung von Arbeitselementen. Sie können Meldungsaktionen verwenden, um ein Arbeitselement zu erstellen. Der Beschreibungsabschnitt des Arbeitselements wird vorab mit der ausgewählten Meldung ausgefüllt. Im Abschnitt „Diskussion“ des neu hinzugefügten Arbeitselements wird ein Link zurück zur Konversation im Kanal gespeichert.

• So erstellen Sie Arbeitselemente mithilfe von Meldungsaktionen

  

  

Verwalten von Azure Boards-Abonnements

1. Um Abonnements für einen Kanal anzuzeigen, hinzuzufügen und zu entfernen, verwenden Sie den @azure boards subscriptions-Befehl:

    @azure boards subscriptions
   

Dieser Befehl listet alle aktuellen Abonnements für den Kanal auf und ermöglicht Ihnen, neue Abonnements hinzuzufügen und bestehende zu entfernen. Im Rahmen des Hinzufügens von Abonnements können Sie auch anpassen, worüber Sie benachrichtigt werden, indem Sie verschiedene Filter verwenden.

Hinweis

Teamadministrator*innen können keine von Projektadministrator*innen erstellten Abonnements entfernen oder ändern.

Suchen und Freigeben von Arbeitselementen mithilfe der Erstellungserweiterung

Um Benutzer*innen beim Suchen und Freigeben von Arbeitselementen zu helfen, unterstützt die Azure Boards-App für Microsoft Teams die Erstellungserweiterung. Sie können nach Arbeitselement-ID, Titel oder unterstütztem funktionsbezogenem Befehl nach Arbeitselementen suchen. Eine Liste der Befehle finden Sie unter Funktionale Suche nach Arbeitselementen. Um die Erstellungserweiterung verwenden zu können, müssen sich Benutzer*innen bei der Azure Boards-App anmelden, indem sie entweder den @azure boards signin-Befehl ausführen oder sich direkt bei der Erstellungserweiterung anmelden.

Vorschau der Arbeitselement-URLs

Um die Zusammenarbeit in Verbindung mit Arbeitselementen zu unterstützen, die in einem Kanal besprochen werden, zeigt der Kanal eine Vorschau der Arbeitselemente an, auf die verwiesen wird. Wenn Benutzer*innen die Arbeitselement-URL einfügen, wird eine Vorschau ähnlich der folgenden Abbildung angezeigt. Diese Vorschau hilft, arbeitselementbezogene Konversationen relevant und korrekt zu halten.

Damit dieses Feature funktioniert, müssen Benutzer*innen angemeldet sein. Nach der Anmeldung funktioniert dieses Feature für alle Kanäle in einem Team in Microsoft Teams.

Aufheben der Verknüpfung eines Projekts mit einem Kanal

Ein Teams-Kanal kann jeweils nur mit einem Azure Boards-Projekt verknüpft sein. Um eine Verknüpfung mit einem anderen Projekt herzustellen, müssen Sie die Verknüpfung mit dem aktuellen Projekt zunächst mithilfe des @azure boards unlink-Befehls aufheben.

Wenn Sie die Verknüpfung mit einem Projekt aufheben, werden alle Abonnements zusammen mit hinzugefügten Bereichspfaden aus dem Kanal gelöscht. Wenn der Kanal nicht über Abonnements verfügt, kann jede*r Benutzer*in die Verknüpfung mit einem Projekt aufheben. Wenn ein Kanal jedoch über Abonnements verfügt, können nur Projektadministrator*innen die Verknüpfung eines Kanals mit einem Projekt aufheben.

Threadbenachrichtigungen zum Verknüpfen und Reduzieren von Benachrichtigungen

Der Teams-Kanal stellt Benachrichtigungen in einen Thread, um verwandte Benachrichtigungen im Kanal logisch zu verknüpfen und zu reduzieren. Alle Benachrichtigungen, die mit einem bestimmten Arbeitselement verbunden sind, werden miteinander verknüpft.

Kompakte Ansicht von Threadbenachrichtigungen

Erweiterte Ansicht von Threadbenachrichtigungen

Azure Boards-Befehlsreferenz

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

Befehl	Funktionalität
@azure boards link [Projekt-URL]	Verknüpfen eines Projekts mit diesem Kanal, um Arbeitselemente zu erstellen und Benachrichtigungen zu erhalten
@azure boards subscriptions	Hinzufügen oder Entfernen von Abonnements für diesen Kanal
@azure boards create	Erstellen eines Arbeitselements
@azure boards addAreapath [Bereichspfad]	Hinzufügen eines Bereichspfads aus Ihrem Projekt zu diesem Kanal
@azure boards sign in	Anmelden bei Ihrer Azure Boards-Organisation
@azure boards sign out	Abmelden von Ihrer Azure Boards-Organisation
@azure boards unlink	Aufheben der Verknüpfung eines Projekts mit diesem Kanal
@azure boards feedback	Melden eines Problems oder Vorschlagen eines Features

Konfigurieren der Azure DevOps Services-Registerkarten in Microsoft Teams

1. Um Ihr Kanban-Board oder Dashboard in Microsoft Teams zu integrieren, wählen Sie im oberen Navigationsbereich Ihres Teamkanals die Schaltfläche „+“ (neue Registerkarte hinzufügen) aus.

   Das Dialogfeld Registerkarte hinzufügen wird angezeigt. Symbole sind in der Regel nach dem letzten Zugriff angeordnet. Sie können A-Z für eine alphabetisierte Liste auswählen.

   

2. Wählen Sie das Azure DevOps-Symbol aus, und authentifizieren Sie Ihre Identität. Optional können Sie das Website-Symbol auswählen und die URL Ihres Kanban-Boards oder Dashboard dem Kanal hinzufügen.

3. Wählen Sie die Organisation aus, deren Board oder Dashboard Sie hinzufügen möchten.

4. Füllen Sie das angezeigte Formular aus. Hier fügen wir beispielsweise ein Dashboard für das Azure DevOps-Team für das TechnicalContent-Projekt hinzu.

   

5. Das ausgewählte Kanban-Board oder Dashboard wird angezeigt.

Unterstützung mehrerer Mandanten

Wenn Sie in Ihrer Organisation eine andere E-Mail-Adresse oder einen anderen Mandanten für Microsoft Teams und Azure DevOps verwenden, führen Sie die folgenden Schritte aus, um sich basierend auf Ihrem Anwendungsfall anzumelden und eine Verbindung herzustellen.

Case

E-Mail-ID und Mandant in Microsoft Teams

E-Mail-ID und Mandant in Azure DevOps

Erforderliche Schritte

1

email1@abc.com
(Mandant 1)

email1@abc.com
(Mandant 1)

Melden Sie sich mit der Schaltfläche Anmelden an.

2

email1@abc.com
(Mandant 1)

email1@abc.com
(Mandant 2)

• Anmelden beim Azure DevOps-Konto
• Öffnen Sie im selben Browser eine neue Registerkarte und navigieren Sie zu https://teams.microsoft.com
• Führen Sie den signin-Befehl aus, und wählen Sie die Schaltfläche Anmelden aus.

3

email1@abc.com
(Mandant 1)

email2@pqr.com
(Mandant 2)

Melden Sie sich unter Verwendung von Mit anderer E-Mail-Adresse anmelden an, und verwenden Sie in der E-Mail-ID-Auswahl die andere E-Mail-Adresse (email2), um sich bei Azure DevOps anzumelden.

4

email1@abc.com
(Mandant 1)

email2@pqr.com
(nicht Standardmandant 3)

Dieses Szenario wird derzeit nicht unterstützt.

Beheben von Fehlern

Wenn bei Ihnen die folgenden Fehler auftreten, wenn Sie die Azure Boards-App für Microsoft Teams 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 Boards-App verwendet das OAuth-Authentifizierungsprotokoll und erfordert die Aktivierung von Zugriff auf Anwendungen von Drittanbietern über OAuth für die Organisation. Zum Aktivieren dieser Einstellung navigieren Sie zu Organisationseinstellungen>Sicherheit>Richtlinien und legen Sie die Einstellung Zugriff auf Drittanbieteranwendung über OAuth für die Organisation auf Aktiviert 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 mit Ihrem Browser zu https://aka.ms/VsSignout navigieren.

Öffnen Sie ein Browserfenster im Modus Privat oder Inkognito, rufen Sie https://aex.dev.azure.com/me auf und melden Sie sich an. 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 Projekt befindet, zu dem Sie eine Verknüpfung herstellen möchten.

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

Wählen Sie die Sign in Schaltfläche aus, und Sie werden zu einer Einwilligungsseite 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.

Verwandte Artikel

• Definieren von Bereichspfaden und Zuweisen zu einem Team
• Azure Boards mit Microsoft Teams
• Azure Repos mit Microsoft Teams