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

Azure DevOps Services

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

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

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

前提条件

• 作業項目を作成するには、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 プロジェクトを Azure Boards アプリにリンクする

アプリを使うには、最初に 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 を使います。

  

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

    /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 を貼り付けると、次の図のようなプレビューが表示されます。 このプレビューは、作業項目関連の会話の関連性と正確性を維持するのに役立ちます。

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

チャネルからプロジェクトのリンクを解除する

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

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

コマンド リファレンス

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

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

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

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

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

• 申し訳ございません。問題が発生しました。 もう一度やり直してください。
• 構成に失敗しました。 組織 '{組織名}' が存在し、十分なアクセス許可があることを確認してください

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

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

関連記事

• 区分パスを定義してチームに割り当てる
• Slack を使用した Azure Pipelines
• Slack を使用した Azure Repos
• Slack を使用して Azure DevOps のサービス フックを作成する