Verwenden von Azure Boards in Microsoft Teams

Azure DevOps Services

In diesem Artikel wird beschrieben, wie Sie die Azure Boards- und Azure DevOps-Apps für Microsoft Teams zum Erstellen und Überwachen von Azure Boards-Arbeitselementen aus Ihren Teams-Kanälen verwenden.

Hinweis

Dieses Feature ist nur auf Azure DevOps Services verfügbar. In der Regel werden zuerst neue Features im Clouddienst eingeführt und dann lokal in der nächsten Hauptversion oder dem nächsten Update von Azure DevOps Server verfügbar gemacht. Weitere Informationen finden Sie in der Azure DevOps-Featurezeitachse.

Mithilfe der Azure Boards-App für Microsoft Teams können Sie:

• Richten Sie Abonnements zum Erstellen und Verwalten von Arbeitsaufgaben- und Arbeitsaufgabenereignissen in Ihren Teams-Kanälen ein.
• Erstellen Sie Arbeitsaufgaben direkt aus Kanalunterhaltungen.
• Suchen und freigeben Sie Arbeitsaufgaben über kanäleübergreifend mithilfe der Messaging-Erweiterung.
• Zeigen Sie eine Vorschau von Arbeitsaufgaben aus URLs an.

Hinweis

• Azure Boards-Benachrichtigungen werden in Teams-Chats oder Direktnachrichten nicht unterstützt.
• Die Azure Boards-App für Microsoft Teams wird für O365 Government Community Cloud (GCC)-Kunden, die ein Azure Commercial-Abonnement in Verbindung mit einem GCC-Mandanten verwenden, nicht unterstützt.

Voraussetzungen

• Berechtigungen: Mitglied der Gruppe "Projektadministratoren" oder "Teamadministratoren" für Ihr Projekt sein.
• Richtlinien: Aktivieren Sie den Anwendungszugriff von Drittanbietern über die OAuth-Richtlinie.
• Access: Haben Sie Zugriff auf ein Team und einen Kanal in Microsoft Teams, in dem Sie eine App installieren können.

Hinzufügen der Azure Boards-App zu Teams

Führen Sie die folgenden Schritte aus, um die Azure Boards-App zu Ihren Teams-Kanälen hinzuzufügen.

1. Wählen Sie in Microsoft Teams Apps aus, suchen Sie nach Azure Boards, und wählen Sie dann Azure Boards aus.

   

2. Wählen Sie den Dropdownpfeil neben Öffnen und dann Zu einem Team hinzufügen aus.

   

3. Wählen Sie ihren Teamnamen aus, oder geben Sie sie ein, und wählen Sie dann Bot einrichten aus.

   

Nach der Installation der App wird eine Willkommensmeldung im Teams-Unterhaltungsbereich angezeigt.

Befehle in der Azure Pipelines-App

Sie können die folgenden @azure boards Befehle verwenden, um mit der Azure Boards-App in Ihrem Teams-Kanal zu interagieren.

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

Verknüpfen Ihres Azure Boards-Projekts mit der App

Um die App zu verwenden, melden Sie sich bei Azure Boards an, und verknüpfen Sie Ihr Azure Boards-Projekt mit Ihrem Teams-Kanal.

1. Geben Sie im Bereich Teams-Unterhaltung die Zeichenfolge ein @azure boards signin.

2. Wählen Sie Anmelden und Authentifizierung bei Azure Boards abschließen aus. Wählen Sie Mit anderer E-Mail-Adresse anmelden aus, wenn sich Microsoft Teams und Azure Boards in verschiedenen Mandanten befinden.

3. Verwenden Sie den @azure boards link Befehl, um eine Verknüpfung mit Ihrer Azure DevOps-Projekt-URL zu erstellen. Zum Beispiel:

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

4. Wählen Sie in der verknüpften Projektbenachrichtigung die Schaltfläche "Abonnement hinzufügen" aus, um mit der Überwachung Ihres Projekts zu beginnen.

   

Einrichten von Abonnements

Nachdem Ihr Projekt verknüpft wurde, beginnen Sie mit der Überwachung von Projektarbeitselementen, indem Sie die Schaltfläche "Abonnement hinzufügen" auswählen. Sie können jederzeit weitere Abonnements hinzufügen, indem Sie den @azure boards subscriptions Befehl verwenden.

1. Wählen Sie unter "Ereignis auswählen" das Ereignis aus, das Sie abonnieren möchten, und wählen Sie "Weiter" aus.

   

2. Wählen Sie unter Filter auswählen den Bereichspfad, denArbeitselementtyp aus, und geben Sie optional Tags oder eine bestimmte Zeichenfolge an, nach der gefiltert werden soll, und wählen Sie dann Absenden aus.

   

Hinzufügen von Bereichspfaden

Bereichspfade mit Abonnements im Kanal, zuletzt aufgerufene Bereichspfade und Bereichspfade, die Sie mithilfe des @azure boards addAreapath Befehls hinzufügen, werden beim Erstellen eines Abonnements im Dropdownmenü "Bereichspfad " angezeigt. Wenn der Bereichspfad, an dem Ihr Team arbeitet, nicht im Dropdownmenü angezeigt wird, können Sie ihn hinzufügen, damit er immer zum Erstellen von Arbeitselementen und Abonnements verfügbar ist. Dieses Feature ist besonders nützlich für Teams, deren Projekt mehr als 100 Bereichspfade enthält.

Verwenden Sie den @azure boards addAreapath Befehl, um dem Teams-Kanal Bereichspfade aus Ihrem Projekt hinzuzufügen. Zum Beispiel:

@azure boards addAreapath 'VMdemo\Area4'

Daraufhin erhalten Sie eine Erfolgsmeldung.

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

Erstellen eines Arbeitselements

Sie können die Azure Boards-App verwenden, um Arbeitselemente aus Ihrem Kanal mithilfe einer Nachrichtenaktion zu erstellen.

1. Wählen Sie in einer beliebigen Nachricht im Kanal die Auslassungspunkte "Weitere Aktionen " im Aktionsbereich aus, und wählen Sie dann " Arbeitselement erstellen" aus.

   

2. Wählen Sie die Art des Arbeitselements aus, das Sie erstellen möchten, und wählen Sie Weiter aus.

3. Geben Sie einen Titel ein, und wählen Sie einen Bereichspfad für das Arbeitselement aus.

4. Der Text der Nachricht wird zur Beschreibung der Arbeitsaufgabe oder zum Erneuten Bereitstellen von Schritten, je nach Arbeitselementtyp, oder Sie können diesen Text bearbeiten. Klicken Sie auf Erstellen.

   

Das neue Arbeitselement wird in Azure Boards angezeigt und enthält einen Link zurück zum Teams-Element, das das Arbeitselement generiert hat.

Verwalten von Azure Boards-Abonnements

Um Abonnements für einen Kanal anzuzeigen, hinzuzufügen und zu entfernen, verwenden Sie den @azure boards subscriptions-Befehl. Mit diesem Befehl werden alle aktuellen Abonnements für den Kanal aufgelistet. Sie können neue Abonnements hinzufügen und vorhandene entfernen. Wenn Sie ein Abonnement hinzufügen, können Sie Benachrichtigungen mithilfe von Filtern anpassen.

Hinweis

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

Verwenden der Erstellerweiterung

Um Ihnen 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 unterstützten Befehle finden Sie unter Funktionale Suche nach Arbeitselementen.

Um die Erstellerweiterung zu verwenden, müssen Sie im Teams-Kanal beim Azure Boards-Projekt angemeldet sein. Wählen Sie das + Symbol im Nachrichtenfeld aus, wählen Sie Azure Boards aus, und suchen Sie dann nach einem Arbeitselement. Sie können auch "Arbeitselement erstellen" auswählen, um ein neues Arbeitselement zu erstellen.

Anzeigen einer Vorschau von Arbeitselementen

Um die Zusammenarbeit in Verbindung mit Arbeitselementen zu unterstützen, die Sie in einem Kanal besprechen, zeigt die Azure Boards App eine Vorschau der Arbeitselemente an, auf die Sie verweisen. Wenn Sie eine Arbeitselement-URL einfügen oder ein Arbeitselement aus der Erweiterung zum Verfassen auswählen, wird in der App eine Vorschau angezeigt, die der folgenden Abbildung ähnelt. Diese URL-Entfaltungsfunktion funktioniert für alle Kanäle im Team.

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 von @azure boards unlink aufheben.

Wenn Sie die Verknüpfung eines Projekts aufheben, werden alle Projektabonnements und hinzugefügten Bereichspfade 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 der Kanal über Abonnements verfügt, können nur Projektadministratoren die Verknüpfung des Projekts aufheben.

Erweitern und Reduzieren von Threads

Ein Teams-Kanal reduziert Beiträge in Threads, um logisch zu verknüpfen und verwandte Beiträge im Kanal zu reduzieren. Alle Antworten auf einen bestimmten Beitrag werden miteinander verknüpft.

Um den Thread zu erweitern, wählen Sie den komprimierten Threadlink aus.

Um zum Kanal zurückzukehren und den Thread zu reduzieren, wählen Sie "Zum Kanal wechseln" aus.

Konfigurieren von Azure DevOps Registerkarten

Um Ihr Projektdashboard oder Kanban-Board in Teams zu bringen, können Sie die Azure DevOps-App auf einer Registerkarte in Ihrem Teams-Kanal installieren. Mit der Azure DevOps-App können Sie Inhalte aus der App in Nachrichten einfügen und Benachrichtigungen von der App in Ihren Kanälen erhalten.

1. Wählen Sie in Teams das + Symbol in der oberen Navigationsleiste Ihres Kanals aus, oder wählen Sie "Apps " im linken Menü aus.

2. Suchen Sie bei Bedarf nach Azure DevOps, und wählen Sie dann Azure DevOps aus.

   

3. Wählen Sie Ihre Azure DevOps-Organisation aus und melden Sie sich dort an.

4. Wählen Sie auf dem Azure DevOps-Bildschirm ein Projekt aus, und ob Sie der Registerkarte ein Dashboard oder ein Kanban-Board hinzufügen möchten. Wählen Sie je nach Ihrer Wahl andere Konfigurationen aus, und wählen Sie aus, ob Sie im Kanal posten möchten, um die Registerkarte hinzuzufügen.

   

5. Wählen Sie Speichern. Die neue Registerkarte und das neue Board werden in Ihrem Kanal angezeigt.

Verbinden verschiedener Mandanten

Wenn Sie andere E-Mail-Adressen oder Mandanten für Microsoft Teams und Azure DevOps verwenden, befolgen Sie diese Schritte, um sich anzumelden und eine Verbindung entsprechend Ihren Einstellungen herzustellen.

Microsoft Teams	Azure DevOps	Anmeldeaktion
email1@abc.com (Mandant1)	email1@abc.com (Mandant1)	Wählen Sie Anmelden aus
email1@abc.com (Mandant1)	email2@abc.com (Mandant2)	1. Melden Sie sich bei Azure DevOps an. 2. Starten Sie im selben Browser eine neue Registerkarte, und wechseln Sie zu https://teams.microsoft.com/. 3. Führen Sie den sign in Befehl aus, und wählen Sie Anmelden aus.
email1@abc.com (Mandant1)	email2@pqr.com (Mandant2)	1. Wählen Sie Mit anderer E-Mail-Adresse anmelden aus. 2. Verwenden Sie in der E-Mail-ID-Auswahl die E-Mail2,um sich anzumelden.
email1@abc.com (Mandant1)	email2@pqr.com (nicht standardmäßiger Mandant3)	Nicht unterstützt.

Behandeln von Authentifizierungsproblemen

Wenn Sie den Fehler Konfiguration fehlgeschlagen erhalten. Stellen Sie sicher, dass die Organisation "{organisationsname}" vorhanden ist und sie über ausreichende Berechtigungen verfügen, führen Sie die folgenden Schritte aus, um den Fehler zu beheben.

1. Starten Sie im selben Browser eine neue Registerkarte, und wechseln Sie zu https://teams.microsoft.com/.

2. Gehen Sie auf dieser Registerkarte zu dem Kanal, auf dem die Azure Boards-App für Microsoft Teams installiert ist, und führen Sie den @azure boards signout Befehl und anschließend den @azure boards signin Befehl aus.

3. Wählen Sie die Schaltfläche "Anmelden " aus, und schließen Sie den Anmeldevorgang ab. Stellen Sie sicher, dass das angezeigte Verzeichnis dasselbe ist, das Sie im vorherigen Schritt ausgewählt haben.

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

Verwandte Artikel

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