次の方法で共有


Azure Boards アプリと Slack を使って作業項目を管理する

Azure DevOps Services

Slack を使用している場合は、Slack 用 Azure Boards アプリを使用して、作業項目の作成、Azure Boards プロジェクトでの作業項目のアクティビティ監視を Slack チャネルから行うことができます。

Slack 用 Azure Boards アプリを使用すると、ユーザーは Slack チャネルでサブスクリプションを設定および管理できます。 作成、更新、その他の作業項目イベンのサブスクリプションを管理できます。 また、ユーザーはこれらのイベントの通知を Slack チャネルで受け取ることもできます。 Slack チャネルの会話を使用して、作業項目を作成することができます。 作業項目 URL のプレビューは、ユーザーが作業に関するディスカッションを開始するのに役立ちます。

画像: 通知

この記事では、以下の方法について説明します。

  • Azure Boards アプリを Slack ワークスペースに追加する
  • Azure Boards プロジェクトを Azure Boards アプリにリンクする、リンクを解除する
  • Slack チャネルで作業項目関連のイベントへのサブスクリプションを設定する
  • Slack チャネルから作業項目を作成する
  • Slack チャネルで作業項目のアクティビティを監視する
  • プライベート Slack チャネルで通知を受け取る

注意

  • Azure Boards と Slack の統合は、Azure DevOps Services でのみサポートされます。
  • 通知は、現在、ダイレクト メッセージ内ではサポートされていません。

前提条件

  • 作業項目を作成するには、Azure Boards プロジェクトの共同作成者である必要があります。 プロジェクトがまだない場合は、サインアップしてプロジェクトを作成できます。 詳細については、「Azure Boardsの使用を開始する」を参照してください。
  • Slack チャネルで作業項目イベントのサブスクリプションを作成するには、Azure Boards プロジェクト管理者グループまたはチーム管理者グループのメンバーである必要があります。 追加するには、「プロジェクト レベルのアクセス許可を変更する」またはチーム管理者の追加に関する記事を参照してください。
  • 通知を受け取るために、[OAuth を使用したサード パーティ アプリケーションのアクセス] 設定を組織に対して有効にする必要があります。 組織のアプリケーション アクセス ポリシーの変更に関する記事を参照してください

Azure Boards アプリを Slack ワークスペースに追加する

  1. Azure Boards アプリを Slack ワークスペースにインストールするには、Web ブラウザーを開いて Slack にサインインし、Azure Boards アプリを開きます。

  2. 追加すると、次の画像に示すように、アプリからのウェルカム メッセージが表示されます。

    画像: ウェルカム メッセージ

  3. /azboards Slack ハンドルを使用してアプリを操作します。 コマンドの一覧は、この記事の後半にある「コマンド リファレンス」に記載されています。

アプリを使うには、最初に Azure Boards プロジェクトを Slack チャネルにリンクする必要があります。

  1. アプリが Slack ワークスペースにインストールされたら、Azure Boards に接続して認証を受けます。

    サインインのスクリーンショット

  2. サインインしたら、Slack チャネル内で slash コマンドを使って、URL で指定した Azure Boards プロジェクトにリンクします。

     /azboards link [project url]
    

    次に例を示します。

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

プロジェクトがリンクされたら、/azboards create コマンドを使って作業項目を作成したり、メッセージ アクションを使ったりできます。

作業項目を監視するサブスクリプションを設定する

/azboards subscriptions コマンドを使うと、いつでもサブスクリプションを作成して作業項目を監視できます。 プロジェクトをリンクした直後にサブスクリプションを設定するオプションもあります。

  1. 必要な区分パス、関心のあるイベントを選び、関連付けられたフィルターを使って Slack チャネルをカスタマイズします。 サブスクリプションを簡単に設定できるように、最近アクセスした区分パスが [区分パス] ドロップダウンに表示されます。

    サブスクリプションを設定します。

    チームの区分パスが [区分パス] ドロップダウン メニューに表示されない場合は、次の「区分パスを追加する」セクションで説明されている手順を実行します。 /azboards addAreapath コマンドを使って追加された区分パスと、Slack チャネルでサブスクリプションが作成されている区分パスは、最近アクセスされた区分パスと共に [区分パス] ドロップダウンに常に表示されます。

区分パスを追加する

チームが作業する区分をチャネルに追加して、作業項目とサブスクリプションの作成に常に使用できるようにすることができます。 これが重要なのは、主に区分パスが 100 を超えるチームです。

  • プロジェクトから Slack チャネルに区分パスを追加するには、次のコマンドを使います。

      /azboards addAreapath [area path]
    

    次に例を示します。

      /azboards addAreapath myproject\fabrikam
    

    区分パスの追加の成功メッセージ

  • 区分パスとしてプロジェクト名を選ぶと、プロジェクト内のすべての区分パスに関する通知を受け取ります。 論理的には、'任意' の区分パスを選ぶことと同じです。

コマンドを使って作業項目を作成する

  1. Azure Boards アプリを使うと、チャネルから作業項目を作成できます。 このアプリでは、カスタム作業項目もサポートされています。
  • 作業項目を作成するには、/azboards create を使います。

    コマンドを使って作業項目を作成する

  1. 作業項目の種類とタイトルをパラメーターとして渡すことで、コマンドから作業項目を直接作成できます。 作業項目は、必須に入力するフィールドがない場合にのみ作成されます。

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

    次に例を示します。

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

メッセージ アクションから作業項目を作成する

多くの場合、チャネルでのディスカッションには、作業項目の作成が必要です。 メッセージ アクションを使って作業項目を作成できます。 選んだメッセージは、作業項目の [説明] セクションにあらかじめ入力されます。 チャネル内の会話へのリンクは、新しく作成された作業項目の [ディスカッション] セクションに格納されます。ユーザーは作業項目の作成につながったディスカッションにアクセスできます。

  • メッセージ アクションを使って作業項目を作成するには

    メッセージ アクションを使って作業項目を作成する

Azure Boards のサブスクリプションを管理する

  1. チャネルのサブスクリプションを表示、追加、削除するには、/azboards subscriptions コマンドを使用します。

     /azboards subscriptions
    

    このコマンドを使うと、チャネルの現在のサブスクリプションがすべて一覧表示され、新しいサブスクリプションを追加したり、既存のものを削除したりできます。 サブスクリプションの追加の一部として、さまざまなフィルターを使って、通知を受け取るものをカスタマイズすることもできます。

[!注] チーム管理者は、プロジェクト管理者によって作成されたサブスクリプションを削除または変更することはできません。

画像: サブスクリプションを表示する

作業項目の URL のプレビュー

チャネル内でディスカッションが行われている作業項目に関する共同作業をサポートするため、チャネルには参照されている作業項目のプレビューが表示されます。 ユーザーが作業項目の URL を貼り付けると、次の図のようなプレビューが表示されます。 このプレビューは、作業項目関連の会話の関連性と正確性を維持するのに役立ちます。

画像: URL の展開

この機能を機能させるには、ユーザーがサインインする必要があります。 サインインすると、この機能はワークスペース内のすべてのチャネルで機能します。

Slack チャネルは、一度に 1 つの Azure Boards プロジェクトにのみリンクできます。 別のプロジェクトにリンクするには、最初に /azboards unlink コマンドを使って現在のプロジェクトのリンクを解除する必要があります。

プロジェクトのリンクを解除すると、すべてのサブスクリプションと追加された区分パスがチャネルから削除されます。 チャネルにサブスクリプションがない場合は、すべてのユーザーがプロジェクトのリンクを解除できます。 一方、チャネルにサブスクリプションがある場合は、プロジェクト管理者のみがチャネルからプロジェクトのリンクを解除できます。

コマンド リファレンス

次の表に、Slack チャネルで使用できるすべての /azboards コマンドを示します。

スラッシュ コマンド 機能
/azboards link [プロジェクトの URL] 作業項目を作成し、通知を受け取るため、プロジェクトをこのチャネルにリンクする
/azboards subscriptions このチャネルのサブスクリプションを追加または削除する
/azboards create または /azboards create [作業項目の種類] [タイトル] 作業項目の作成
/azboards addAreapath [区分パス] プロジェクトからこのチャネルに区分パスを追加する
/azboards signin Azure Boards 組織にサインインする
/azboards signout Azure Boards 組織からサインアウトする
/azboards unlink このチャネルからプロジェクトのリンクを解除する
/azboards feedback 問題を報告するか、機能を提案する

プライベート チャネルの作業を管理する

Slack 用 Azure Boards アプリを使うと、プライベート チャネルでも作業項目を作成し、作業項目のアクティビティを監視することができます。 プライベート チャネルにボットを招待するには、「/invite @azboards」と入力します。 それを投稿すると、パブリック チャネルと同じように作業項目を作成し、通知を管理できるようになります。

エラーをトラブルシューティングする

Slack 用 Azure Boards アプリを使っているときに次のエラーが発生する場合は、このセクションの手順に従ってください。

申し訳ございません。問題が発生しました。 もう一度やり直してください。

Azure Boards アプリは OAuth 認証プロトコルを使っているため、[Third-party application access via OAuth for the organization] (組織の OAuth を使用したサードパーティ アプリケーションのアクセス) を有効にする必要があります。 この設定を有効にするには、[組織の設定>] [セキュリティ>ポリシー] に移動し、[organization] 設定の [OAuth 経由のサードパーティ アプリケーション アクセス] を [オン] に設定します。

[Third-party application access via OAuth for the organization](組織の OAuth を使用したサードパーティ アプリケーションのアクセス) 設定を有効にする

構成に失敗しました。 組織 '{組織名}' が存在し、十分なアクセス許可があることを確認してください

ブラウザーを使用して https://aka.ms/VsSignout Azure DevOps からサインアウトします。

[プライベートまたはシークレット] ブラウザー ウィンドウを開き、 にhttps://aex.dev.azure.com/me移動してサインインします。 左側のプロファイル アイコンの下のドロップダウンで、リンクするプロジェクトが含まれる組織を含むディレクトリを選びます。

プロジェクトを含む組織が含まれるディレクトリを選択する

同じブラウザーで、新しいタブを開始し、 にhttps://slack.com移動し、作業空間にサインインします (Web クライアントを使用)。 /azboards signout コマンドを実行し、その後に /azboards signin コマンドを実行します。

Sign in ボタンを選択すると、次の例のような同意ページにリダイレクトされます。 メール アドレスの横に表示されるディレクトリが、前の手順で選択したディレクトリと同じであることを確認します。 サインイン プロセスを受け入れて完了します。

要求されたアプリのアクセス許可への同意

これらの手順で認証の問題が解決しない場合は、Developer Community にお問い合わせください。