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.
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
- 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 Starten der Verwendung von Azure Boards.
- Um Abonnements in einem Slack-Kanal für Arbeitselementereignisse zu erstellen, müssen Sie Mitglied der Gruppe Azure Boards-Projektadministratoren oder Teamadministratoren sein. Informationen zum Hinzufügen finden Sie unter Ändern von Berechtigungen auf Projektebene oder Hinzufügen eines Teamadministrators.
- Um Benachrichtigungen zu erhalten, muss die Einstellung Zugriff auf Anwendungen von Drittanbietern über OAuth für die Organisation aktiviert sein. Weitere Informationen finden Sie unter Ändern von Anwendungszugriffsrichtlinien für Ihre Organisation.
Hinzufügen der Azure Boards-App zu Ihrem Slack-Arbeitsbereich
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.
Nach dem Hinzufügen erhalten Sie eine Begrüßungsnachricht von der App, wie in der folgenden Abbildung dargestellt.
Verwenden Sie den
/azboards
-Slack-Handle, um mit der App zu interagieren. Eine Befehlsliste 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 Slack-Kanal verknüpfen.
Nachdem die App in Ihrem Slack-Arbeitsbereich installiert wurde, stellen Sie eine Verbindung mit Azure Boards her und authentifizieren sie sich.
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.
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.
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
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
- 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.
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
Verwalten von Azure Boards-Abonnements
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.
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.
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.
Aufheben der Verknüpfung eines Projekts mit einem Kanal
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 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. 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.
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.
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.
Wenn ihr Authentifizierungsproblem mit diesen Schritten nicht behoben werden kann, wenden Sie sich unter Entwicklercommunity an uns.