Verwenden der Azure Boards-App mit Slack zum Verwalten von Arbeitselementen

Azure DevOps Services

Wenn Sie Slack verwenden, können Sie die Azure Boards-App für Slack nutzen, um Arbeitselemente zu erstellen und die Arbeitselementaktivität in Ihrem Azure Boards-Projekt über Ihren Slack-Kanal zu überwachen.

Mit der Azure Boards-App für Slack können Benutzer Abonnements in ihrem Slack-Kanal einrichten und verwalten. Sie können Abonnements für Erstellungs-, Aktualisierungs- und andere Arbeitselementereignisse verwalten. Benutzer können auch Benachrichtigungen für diese Ereignisse in ihrem Slack-Kanal erhalten. Unterhaltungen im Slack-Kanal können zum Erstellen von Arbeitselementen verwendet werden. Vorschauversionen für Arbeitselement-URLs helfen Benutzern, Diskussionen rund um die Arbeit zu beginnen.

Bild: Benachrichtigung

Lesen Sie diesen Artikel, um Folgendes zu erfahren:

  • Hinzufügen der Azure Boards-App zu Ihrem Slack-Arbeitsbereich
  • 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 Slack-Kanal
  • Erstellen von Arbeitselementen von Ihrem Slack-Kanal aus
  • Überwachen der Arbeitselementaktivität in Ihrem Slack-Kanal
  • Abrufen von Benachrichtigungen in privaten Slack-Kanälen

Hinweis

  • Integration von Azure Boards und Slack wird nur für Azure DevOps Services unterstützt.
  • Benachrichtigungen werden derzeit nicht in Direktnachrichten unterstützt.

Voraussetzungen

Hinzufügen der Azure Boards-App zu Ihrem Slack-Arbeitsbereich

  1. Um die Azure Boards-App in Ihrem Slack-Arbeitsbereich zu installieren, öffnen Sie einen Webbrowser, melden Sie sich bei Slack an, und öffnen Sie die Azure Boards-App.

  2. Nach dem Hinzufügen erhalten Sie eine Begrüßungsnachricht von der App, wie in der folgenden Abbildung dargestellt.

    Bild: Begrüßungsmeldung

  3. Verwenden Sie den /azboards-Slack-Handle, um mit der App zu interagieren. Eine Befehlsliste finden Sie weiter unten in diesem Artikel unter Befehlsreferenz.

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

  1. Nachdem die App in Ihrem Slack-Arbeitsbereich installiert wurde, stellen Sie eine Verbindung mit Azure Boards her und authentifizieren sie sich.

    Screenshot: Anmelden

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

     /azboards link [project url]
    

    Beispiel:

     /azboards link https://dev.azure.com/myorg/myproject
    

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

Einrichten von Abonnements zum Überwachen von Arbeitselementen

Mit dem /azboards subscriptions-Befehl können Sie Abonnements erstellen, um jederzeit Arbeitselemente zu überwachen. Sie haben die Möglichkeit, Abonnements direkt nach dem Verknüpfen eines Projekts einzurichten.

  1. Wählen Sie den gewünschten Bereichspfad und das für Sie interessante Ereignis aus, und verwenden Sie die zugehörigen Filter, um Ihren Slack-Kanal anzupassen. Zur mühelosen Einrichtung von Abonnements werden die zuletzt aufgerufenen Bereichspfade in der Bereichspfad-Dropdownliste angezeigt.

    Richten Sie Abonnements ein.

    Falls der Bereichspfad Ihres Teams nicht im Bereichspfad-Dropdownmenü angezeigt wird, befolgen Sie die Anweisungen im nächsten Abschnitt, Hinzufügen von Bereichspfaden. Bereichspfade, die mithilfe des /azboards addAreapath-Befehls hinzugefügt wurden, und Bereichspfade, für die Abonnements im Slack-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. Dies ist vor allem für die Teams mit mehr als 100 Bereichspfaden wichtig.

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

      /azboards addAreapath [area path]
    

    Beispiel:

      /azboards addAreapath myproject\fabrikam
    

    Bereichspfad-Erfolgsmeldung hinzufügen

  • Wenn Sie den Projektnamen als Bereichspfad auswählen, erhalten Sie Benachrichtigungen für alle Bereichspfade im Projekt. Dies entspricht logisch der Auswahl des Bereichspfads „Beliebig“.

Erstellen eines Arbeitselements mit einem Befehl

  1. Mit der Azure Boards-App können Sie Arbeitselemente aus Ihrem Kanal erstellen. Die App unterstützt auch benutzerdefinierte Arbeitselemente.
  • Verwenden Sie /azboards create zum Erstellen eines Arbeitselements.

    Erstellen eines Arbeitselements mithilfe des Befehls

  1. Sie können Arbeitselemente direkt mit einem Befehl erstellen, indem Sie den Arbeitselementtyp und den Titel als Parameter übergeben. Arbeitselemente werden nur erstellt, wenn sie keine Felder haben, die zwingend ausgefüllt werden müssen.

     /azboards create [work item type] [work item title]
    

    Beispiel:

     /azboards create 'user story' Push cloud monitoring alerts to mobile devices
    

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. Ein Link zurück zur Konversation im Kanal wird im Abschnitt „Diskussion“ des neu erstellten Arbeitselements gespeichert, sodass Benutzer auf die Diskussion zugreifen können, die zur Erstellung des Arbeitselements geführt hat.

  • So erstellen Sie Arbeitselemente mithilfe von Meldungsaktionen

    Erstellen eines Arbeitselements mithilfe einer Meldungsaktion

Verwalten von Azure Boards-Abonnements

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

     /azboards 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] Teamadministratoren können keine von Projektadministratoren erstellten Abonnements entfernen oder ändern.

Bild: Anzeigen von Abonnements

Vorschau von Arbeitselement-URLs

Um die Zusammenarbeit in Verbindung mit Arbeitselementen zu unterstützen, die in einem Kanal besprochen werden, wird eine Vorschau der Arbeitselemente angezeigt, auf die im Kanal 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.

Bild: URL-Verbreitung

Damit dieses Feature funktioniert, müssen die Benutzer angemeldet sein. Sobald sie angemeldet sind, funktioniert dieses Feature für alle Kanäle in einem Arbeitsbereich.

Ein Slack-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 /azboards 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.

Befehlsreferenz

In der folgenden Tabelle sind alle /azboards-Befehle aufgeführt, die Sie in Ihrem Slack-Kanal verwenden können.

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

Verwalten von Arbeiten in privaten Kanälen

Die Azure Boards-App für Slack kann Ihnen auch beim Erstellen von Arbeitselementen und beim Überwachen der Arbeitselementaktivität in Ihren privaten Kanälen helfen. Um den Bot zu Ihrem privaten Kanal einzuladen, geben Sie /invite @azboards ein. Nachdem Sie dies veröffentlicht haben, können Sie Arbeitselemente erstellen und Ihre Benachrichtigungen auf die gleiche Weise wie für einen öffentlichen Kanal verwalten.

Beheben von Fehlern

Wenn bei Ihnen die folgenden Fehler auftreten, wenn Sie die Azure Boards-App für Slack verwenden, befolgen Sie die Verfahren in diesem Abschnitt.

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. Um diese Einstellung zu aktivieren, wechseln Sie zuSicherheitsrichtlinien> der Organisation>, und legen Sie den Zugriff von Drittanbieteranwendungen über OAuth für die organization Einstellung 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 bei Azure DevOps ab, indem Sie zu https://aka.ms/VsSignout Ihrem Browser wechseln.

Öffnen Sie ein Privates oder Inkognito-Browserfenster , und wechseln Sie zu https://aex.dev.azure.com/me , 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.

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

Starten Sie im selben Browser eine neue Registerkarte, wechseln Sie zu https://slack.com, und melden Sie sich bei Ihrem Arbeitsbereich an (verwenden Sie den Webclient). Führen Sie den Befehl /azboards signout gefolgt von dem Befehl /azboards signin aus.

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.

Zustimmung zu den angeforderten App-Berechtigungen

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