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.

Pic: Notification

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

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. Nachdem Sie hinzugefügt haben, wird eine Willkommensnachricht aus der App angezeigt, wie in der folgenden Abbildung dargestellt.

    Pic: Welcome message

  3. Verwenden Sie das /azboards Slack-Handle, um mit der App zu interagieren. Eine Liste der Befehle wird weiter unten in diesem Artikel bereitgestellt, 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 her, und authentifizieren Sie sich selbst mit Azure Boards.

    screenshot of sign-in

  2. 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.

  1. 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.

    Set up subscriptions.

    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 addAreapath Befehls- 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
    

    add areapath success message

  • 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

  1. 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 .

    Create work item using command

  1. 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

    Create work item using message action

Verwalten 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 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.

Pic: View subscriptions

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.

Pic: URL unfurling

Damit dieses Feature funktioniert, müssen 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 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.

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.

Enable the Third-party application access via OAuth for the organization setting

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.

Select the directory that contains the organization that contains the project

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.

Consent to the requested app permissions

Wenn diese Schritte Ihr Authentifizierungsproblem nicht beheben, wenden Sie sich an uns an Entwicklercommunity.