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 verwenden, um Arbeitsaufgaben zu erstellen und Arbeitsaufgabenaktivitäten in Ihrem Azure Boards Projekt aus Ihrem Slack-Kanal zu überwachen.
Mit der Azure Boards-App für Slack können Benutzer Abonnements im Slack-Kanal einrichten und verwalten. Sie können Abonnements zum Erstellen, Aktualisieren und anderen Arbeitsaufgabenereignissen verwalten. Benutzer können auch Benachrichtigungen für diese Ereignisse im Slack-Kanal erhalten. Unterhaltungen im Slack-Kanal können zum Erstellen von Arbeitselementen verwendet werden. Vorschauen für URLs für Arbeitsaufgaben helfen Benutzern beim Starten von Diskussionen zur Arbeit.
Lesen Sie diesen Artikel, um zu erfahren, wie Sie:
- Hinzufügen der Azure Boards-App zu Ihrem Slack-Arbeitsbereich
- Verknüpfen und Aufheben der Verknüpfung Ihres Azure Boards Projekts mit der Azure Boards-App
- Einrichten von Abonnements für arbeitsbezogene Ereignisse in Ihrem Slack-Kanal
- Erstellen von Arbeitselementen aus Ihrem Slack-Kanal
- Überwachen der Arbeitsaufgabenaktivität in Ihrem Slack-Kanal
- Abrufen von Benachrichtigungen in privaten Slack-Kanälen
Hinweis
- Azure Boards- und Slack-Integration wird nur für Azure DevOps Services unterstützt.
- Benachrichtigungen werden derzeit in direkten Nachrichten nicht unterstützt.
Voraussetzungen
- Um eine Arbeitsaufgabe zu erstellen, müssen Sie ein Mitwirkender am Azure Boards Projekt sein. Wenn Sie noch kein Projekt haben, können Sie sich registrieren und ein Projekt erstellen. Ausführliche Informationen finden Sie unter "Starten der Verwendung von Azure Boards".
- Um Abonnements in einem Slack-Kanal für Arbeitsaufgabenereignisse zu erstellen, müssen Sie Mitglied der Gruppe Azure Boards Project Administratoren oder Teamadministratoren sein. Informationen zum Hinzufügen finden Sie unter Ändern von Berechtigungen auf Projektebene oder Hinzufügen von Teamadministratoren.
- Um Benachrichtigungen zu erhalten, muss der Zugriff der Drittanbieteranwendung über die OAuth-Einstellung für die Organisation aktiviert sein. Siehe Ä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.
Nachdem Sie hinzugefügt haben, wird eine Willkommensnachricht aus der App angezeigt, wie in der folgenden Abbildung dargestellt.
Verwenden Sie das
/azboardsSlack-Handle, um mit der App zu interagieren. Eine Liste der Befehle wird weiter unten in diesem Artikel bereitgestellt, 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 her, und authentifizieren Sie sich selbst mit Azure Boards.
Verwenden Sie nach der Anmeldung den folgenden Schrägstrichbefehl in einem Slack-Kanal, um einen Link zum 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 von /azboards create Befehlen erstellen oder Nachrichtenaktionen verwenden.
Einrichten von Abonnements zum Überwachen von Arbeitselementen
Sie können Abonnements erstellen, um Arbeitselemente jederzeit mithilfe des /azboards subscriptions Befehls zu überwachen. Sie haben die Möglichkeit, Abonnements direkt nach dem Verknüpfen eines Projekts einzurichten.
Wählen Sie den gewünschten Bereichspfad aus, das Ereignis, an dem Sie interessiert sind, und verwenden Sie die zugehörigen Filter, um Ihren Slack-Kanal anzupassen. Um Abonnements ganz einfach einzurichten, werden Ihre zuletzt zugegriffenen Bereichspfade im Dropdownmenü für den Bereichspfad angezeigt.
Wenn der Bereichspfad Ihres Teams nicht im Dropdownmenü "Bereichspfad" angezeigt wird, folgen Sie den Anweisungen im nächsten Abschnitt, "Bereichspfade hinzufügen". Bereichspfade, die mithilfe der
/azboards addAreapathBefehls- und Bereichspfade hinzugefügt werden, für die Abonnements im Slack-Kanal erstellt werden, werden immer in der Dropdownliste "Bereichspfad" zusammen mit zuletzt zugegriffenen Bereichspfaden angezeigt.
Hinzufügen von Bereichspfaden
Sie können dem Kanal Bereiche hinzufügen, an denen Ihr Team arbeitet, damit sie immer für das Erstellen von Arbeitselementen und Abonnements verfügbar sind. Dies ist hauptsächlich für die Teams mit mehr als 100 Flächenpfaden wichtig.
Verwenden Sie den folgenden Befehl, um Bereichspfade aus Ihrem Projekt zum Slack-Kanal 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. Es entspricht logisch der Auswahl des Bereichspfads "Any".
Erstellen einer Arbeitsaufgabe 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 createzum Erstellen einer Arbeitsaufgabe .
Sie können Arbeitselemente direkt aus einem Befehl erstellen, indem Sie Arbeitselementtyp und Titel als Parameter übergeben. Arbeitselemente werden nur erstellt, wenn sie keine Felder haben, die obligatorisch ausgefüllt werden sollen.
/azboards create [work item type] [work item title]Beispiel:
/azboards create 'user story' Push cloud monitoring alerts to mobile devices
Erstellen einer Arbeitsaufgabe aus Nachrichtenaktionen
Häufig rufen Diskussionen in einem Kanal zum Erstellen von Arbeitselementen auf. Sie können Nachrichtenaktionen verwenden, um eine Arbeitsaufgabe zu erstellen. Die ausgewählte Nachricht wird im Beschreibungsbereich des Arbeitselements vorab ausgefüllt. Ein Link zurück zur Unterhaltung im Kanal wird im Diskussionsbereich der neu erstellten Arbeitsaufgabe gespeichert, sodass Benutzer auf die Diskussion zugreifen können, die zur Erstellung der Arbeitsaufgabe geführt hat.
So erstellen Sie Arbeitselemente mithilfe von Nachrichtenaktionen
Verwalten Azure Boards Abonnements
Um Abonnements für einen Kanal anzuzeigen, hinzuzufügen und zu entfernen, verwenden Sie den
/azboards subscriptionsBefehl:/azboards subscriptionsDieser Befehl listet alle aktuellen Abonnements für den Kanal auf und ermöglicht es Ihnen, neue Abonnements hinzuzufügen und vorhandene abonnements zu entfernen. Im Rahmen des Hinzufügens von Abonnements können Sie auch anpassen, was Sie über verschiedene Filter benachrichtigt werden.
[! HINWEIS]Teamadministratoren können abonnements, die von Project Administratoren erstellt wurden, nicht entfernen oder ändern.
Vorschau von UrLs für Arbeitsaufgaben
Um die Zusammenarbeit um arbeitsinterne Elemente zu unterstützen, die in einem Kanal behandelt werden, wird eine Vorschau von Arbeitselementen angezeigt, auf die im Kanal verwiesen wird. Wenn ein Benutzer die Arbeitselement-URL einfüge, wird eine Vorschau ähnlich wie in der folgenden Abbildung angezeigt. Diese Vorschau hilft, arbeitsbezogene Unterhaltungen relevant und korrekt zu halten.
Damit dieses Feature funktioniert, müssen Benutzer angemeldet sein. Sobald sie angemeldet sind, funktioniert dieses Feature für alle Kanäle in einem Arbeitsbereich.
Aufheben der Verknüpfung eines Projekts aus einem Kanal
Ein Slack-Kanal kann jeweils nur mit einem Azure Boards Projekt verknüpft werden. Wenn Sie eine Verknüpfung mit einem anderen Projekt herstellen möchten, müssen Sie zuerst die Verknüpfung mit dem aktuellen Projekt mit /azboards unlink dem Befehl aufheben.
Das Aufheben der Verknüpfung eines Projekts löscht alle Abonnements zusammen mit hinzugefügten Bereichspfaden aus dem Kanal. Wenn der Kanal über keine Abonnements verfügt, kann jeder Benutzer die Verknüpfung eines Projekts aufheben. Wenn ein Kanal jedoch Über Abonnements verfügt, können nur Projektadministratoren die Verknüpfung eines Projekts von einem Kanal aufheben.
Befehlsreferenz
In der folgenden Tabelle sind alle Befehle aufgeführt, die /azboards Sie in Ihrem Slack-Kanal verwenden können.
| Befehl "Schrägstrich" | Funktionalität |
|---|---|
| /azboards link [project url] | Verknüpfen eines Projekts mit diesem Kanal zum Erstellen von Arbeitselementen und Empfangen von Benachrichtigungen |
| /azboards-Abonnements | Hinzufügen oder Entfernen von Abonnements für diesen Kanal |
| /azboards create or /azboards create [work item type] [title] | Erstellen eines Arbeitselements |
| /azboards addAreapath [Bereichspfad] | Hinzufügen eines Bereichspfads von Ihrem Projekt zu diesem Kanal |
| /azboards signin | Melden Sie sich bei Ihrer Azure Boards Organisation an |
| /azboards signout | Abmelden von Ihrer Azure Boards Organisation |
| /azboards unlinks | Aufheben der Verknüpfung eines Projekts aus diesem Kanal |
| /azboards Feedback | Melden eines Problems oder Vorschlag eines Features |
Verwalten von Arbeiten in privaten Kanälen
Die Azure Boards-App für Slack kann Ihnen dabei helfen, Arbeitselemente zu erstellen und die Arbeitselementaktivität in Ihren privaten Kanälen zu überwachen. Um den Bot zu Ihrem privaten Kanal einzuladen, geben Sie die Eingabetaste /invite @azboardsein. Nachdem Sie dies veröffentlicht haben, können Sie Arbeitselemente erstellen und Ihre Benachrichtigungen auf dieselbe Weise verwalten wie für einen öffentlichen Kanal.
Fehlerbehandlung
Wenn beim Verwenden der Azure Boards App für Slack die folgenden Fehler auftreten, folgen Sie den Verfahren in diesem Abschnitt.
- Das hat leider nicht geklappt. Wiederholen Sie den Vorgang.
- Fehler bei der Konfiguration. Stellen Sie sicher, dass die Organisation '{Organisationsname}' vorhanden ist und über ausreichende Berechtigungen verfügt.
Das hat leider nicht geklappt. Wiederholen Sie den Vorgang.
Die Azure Boards-App verwendet das OAuth-Authentifizierungsprotokoll und erfordert den Zugriff von Drittanbietern über OAuth für die Organisation, die aktiviert werden soll. Um diese Einstellung zu aktivieren, navigieren Sie zu Organisation Einstellungen>SecurityPolicies>, und legen Sie den Anwendungszugriff von Drittanbietern über OAuth für die Organisationseinstellung auf "On" fest.
Fehler bei der Konfiguration. Stellen Sie sicher, dass die Organisation '{Organisationsname}' vorhanden ist und über ausreichende Berechtigungen verfügt.
Melden Sie sich von Azure DevOps ab, indem Sie mit https://aka.ms/VsSignout Ihrem Browser navigieren.
Öffnen Sie ein privates oder inkognito-Browserfenster , und navigieren Sie zu https://aex.dev.azure.com/me und melden Sie sich an. Wählen Sie im Dropdownfeld unter dem Profilsymbol links das Verzeichnis aus, das die Organisation enthält, die das Projekt enthält, das Sie verknüpfen möchten.
Starten Sie in demselben Browser eine neue Registerkarte, navigieren Sie zu https://slack.com, und melden Sie sich bei Ihrem Arbeitsbereich an (Verwenden des Webclients). Führen Sie den /azboards signout/azboards signin Befehl gefolgt vom Befehl aus.
Wählen Sie die Sign in Schaltfläche aus, und Sie werden auf eine Zustimmungsseite wie das folgende Beispiel umgeleitet. Stellen Sie sicher, dass das verzeichnis, das neben der E-Mail angezeigt wird, gleich dem ist, was im vorherigen Schritt ausgewählt wurde. Akzeptieren und Abschließen des Anmeldevorgangs.
Wenn diese Schritte Ihr Authentifizierungsproblem nicht beheben, wenden Sie sich an uns an Entwicklercommunity.