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:

  • Abonnements einrichten, um Arbeitselemente und Arbeitselementereignisse in Ihren Teams-Kanälen zu erstellen und zu verwalten.
  • Arbeitselemente aus Unterhaltungen in einem Kanal erstellen.
  • Mit der Messaging-Erweiterung Arbeitselemente suchen und mit anderen Kanälen teilen.
  • Vorschau von Arbeitselementen aus URLs anzeigen.

Hinweis

Azure Boards-Benachrichtigungen werden in Teams-Chats oder Direktnachrichten nicht unterstützt.

In diesem Artikel werden folgende Vorgehensweisen behandelt:

  • Hinzufügen der Azure Boards-App zu Ihrem Team in Microsoft Teams.
  • Verknüpfen Ihres Azure Boards-Projekts mit der Azure Boards-App.
  • 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

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

  • Zugriff auf ein Team und einen Kanal in Microsoft Teams, in dem Sie eine App installieren können.
  • Rolle Projektadministrator oder Teamadministrator in einem Azure DevOps-Projekt.
  • Zugriff auf Drittanbieteranwendungen über OAuth , der in den Azure DevOps-Organisationseinstellungen aktiviert ist.

Weitere Informationen finden Sie in den folgenden Ressourcen:

Hinzufügen der Azure Boards-App zu Teams

Sie können die Azure Boards-App zu Ihren Teams-Kanälen hinzufügen.

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

    Screenshot der Auswahl von Apps, dann Azure Boards.

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

    Screenshot zum Auswählen von

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

    Screenshot der Auswahl Einrichtung eines Bots.

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

Screenshot der Willkommensnachricht im Unterhaltungsbereich.

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.

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.

    Screenshot der verknüpften Projektbenachrichtigung mit der Schaltfläche

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.

    Screenshot: Auswählen des zu überwachenden Ereignisses.

  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.

    Screenshot des Einrichtens des Abonnements.

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.

Screenshot des Hinzufügens eines Bereichspfads und der 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.

    Screenshot der Auswahl von

  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.

    Screenshot der Konfiguration des Arbeitselements.

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

Screenshot des neuen Arbeitselements in Azure Boards.

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.

Screenshot der Liste der Abonnements.

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.

Screenshot: Compose-Erweiterung

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.

Screenshot, der zeigt, wie die URL des Arbeitselements entfaltet wird.

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.

Screenshot der kompakten Thread-Ansicht.

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

Screenshot der erweiterten Thread-Ansicht.

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.

    Screenshot: Hinzufügen einer neuen Registerkarte zum Teams-Kanal.

  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.

    Screenshot, der das Hinzufügen eines Dashboards für Azure DevOps in Teams zeigt.

  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.