Azure DevOps Services
Slack を使用している場合は、Slack 用 Azure Boards アプリ を使用して、作業項目の作成、Azure Boards プロジェクトでの作業項目のアクティビティ監視を Slack チャネルから行うことができます。
Slack 用 Azure Boards アプリを使用すると、ユーザーは Slack チャネルでサブスクリプションを設定および管理できます。 作成、更新、その他の作業項目イベンのサブスクリプションを管理できます。 また、ユーザーはこれらのイベントの通知を Slack チャネルで受け取ることもできます。 Slack チャネルの会話を使用して、作業項目を作成することができます。 作業項目 URL のプレビューは、ユーザーが作業に関するディスカッションを開始するのに役立ちます。
Note
通知はチャネルに送信され、直接メッセージには表示されません。
前提条件
| カテゴリ | 要求事項 |
|---|---|
| Platform | Azure Boards と Azure Boards Slack アプリは、Azure DevOps Services (クラウド) でのみ動作します。Azure DevOps Server ではサポートされていません。 |
| アクセス レベル | プロジェクトの共同作成者。 |
| Permissions | 作業項目イベントの Slack チャネルでサブスクリプションを作成するには: プロジェクト管理者 または チーム管理者グループの メンバー。 |
| Microsoft Entra アカウント | 組織が Microsoft Entra ID テナントに接続されている場合は、そのテナントのネイティブ メンバーであるアカウントでサインインします。ゲストアカウントまたは外部アカウントでは、Slack 経由でサインインするときに認証エラーが発生する可能性があります。 |
Azure Boards アプリを Slack ワークスペースに追加する
Azure Boards アプリを Slack ワークスペースにインストールするには、Web ブラウザーを開いて Slack にサインインし、Azure Boards アプリを開きます。
追加すると、次の図に示すように、アプリからの歓迎メッセージが表示されます。
/azboardsSlack ハンドルを使用してアプリを操作します。 コマンドの一覧は、この記事で後述するコマンド リファレンスにあります。
Azure Boards プロジェクトを Azure Boards アプリにリンクする
アプリを使うには、最初に Azure Boards プロジェクトを Slack チャネルにリンクする必要があります。
アプリが Slack ワークスペースにインストールされたら、Azure Boards に接続して認証します。
サインインした後、Slack チャネル内で slash コマンドを使って、URL で指定した Azure Boards プロジェクトにリンクします。
/azboards link [project url]次に例を示します。
/azboards link https://dev.azure.com/myorg/myproject
プロジェクトがリンクされたら、/azboards create コマンドを使って作業項目を作成したり、メッセージ アクションを使ったりできます。
作業項目を監視するサブスクリプションを設定する
/azboards subscriptions コマンドを使うと、いつでもサブスクリプションを作成して作業項目を監視できます。 プロジェクトをリンクした直後にサブスクリプションを設定するオプションもあります。
必要な区分パス、関心のあるイベントを選び、関連付けられたフィルターを使って Slack チャネルをカスタマイズします。 サブスクリプションを簡単に設定するため、最近アクセスした区分パスが [区分パス] ドロップダウンに表示されます。
チームの区分パスが [区分パス] ドロップダウン メニューに表示されない場合は、次の「区分パスを追加する」セクションで説明されている手順のようにします。
/azboards addAreapathコマンドを使って追加された区分パスと、Slack チャネルでサブスクリプションが作成されている区分パスは、最近アクセスされた区分パスと共に [区分パス] ドロップダウンに常に表示されます。
区分パスを追加する
チームが作業する区分をチャネルに追加して、作業項目とサブスクリプションの作成に常に使用できるようにすることができます。 このアクションは、主に 100 を超える区分パスを持つチームにとって重要です。
プロジェクトから Slack チャネルに区分パスを追加するには、次のコマンドを使います。
/azboards addAreapath [area path]次に例を示します。
/azboards addAreapath myproject\fabrikam
区分パスとしてプロジェクト名を選ぶと、プロジェクト内のすべての区分パスに関する通知を受け取ります。 論理的には、'任意' の区分パスを選ぶことと同じです。
コマンドを使用して作業項目を作成する
- Azure Boards アプリを使うと、チャネルから作業項目を作成できます。 このアプリでは、カスタム作業項目もサポートされています。
作業項目を作成するには、
/azboards createを使います。
作業項目の種類とタイトルをパラメーターとして渡すことで、コマンドから作業項目を直接作成できます。 作業項目は、必須に入力するフィールドがない場合にのみ作成されます。
/azboards create [work item type] [work item title]次に例を示します。
/azboards create 'user story' Push cloud monitoring alerts to mobile devices
メッセージ アクションから作業項目を作成する
多くの場合、チャネルでのディスカッションには、作業項目を作成する必要があります。 メッセージ アクションを使って作業項目を作成できます。 選んだメッセージは、作業項目の [説明] セクションにあらかじめ入力されます。 チャネル内の会話へのリンクは、新しく作成された作業項目の [ディスカッション] セクションに格納されます。ユーザーは作業項目の作成につながったディスカッションにアクセスできます。
メッセージ アクションを使って作業項目を作成するには
Azure Boards のサブスクリプションを管理する
チャネルのサブスクリプションを表示、追加、削除するには、
/azboards subscriptionsコマンドを使用します。/azboards subscriptionsこのコマンドを使うと、チャネルの現在のサブスクリプションがすべて一覧表示され、新しいサブスクリプションを追加したり、既存のものを削除したりできます。 サブスクリプションの追加の一部として、さまざまなフィルターを使って、通知を受け取るものをカスタマイズすることもできます。
Note
チーム管理者は、プロジェクト管理者によって作成されたサブスクリプションを削除または変更することはできません。
作業項目の URL のプレビュー
チャネル内でディスカッションが行われている作業項目に関する共同作業をサポートするため、チャネルに参照されている作業項目のプレビューが表示されます。 ユーザーが作業項目の URL を貼り付けると、次の図のようなプレビューが表示されます。 このプレビューは、作業項目関連の会話の関連性と正確性を維持するのに役立ちます。
この機能を使うには、ユーザーはサインインする必要があります。 サインインすると、この機能はワークスペース内のすべてのチャネルで機能します。
チャネルからプロジェクトのリンクを解除する
Slack チャネルは、一度に 1 つの Azure Boards プロジェクトにのみリンクできます。 別のプロジェクトにリンクするには、最初に /azboards unlink コマンドを使って現在のプロジェクトのリンクを解除する必要があります。
プロジェクトのリンクを解除すると、すべてのサブスクリプションと追加された区分パスがチャネルから削除されます。 チャネルにサブスクリプションがない場合は、すべてのユーザーがプロジェクトのリンクを解除できます。 一方、チャネルにサブスクリプションがある場合は、プロジェクト管理者のみがチャネルからプロジェクトのリンクを解除できます。
コマンド リファレンス
次の表に、Slack チャネルで使用できるすべての /azboards コマンドを示します。
| スラッシュ コマンド | 機能 |
|---|---|
| /azboards link [project url] | 作業項目を作成し、通知を受け取るため、プロジェクトをこのチャネルにリンクします |
| /azboards サブスクリプション | このチャネルのサブスクリプションを追加または削除する |
| /azboards create または /azboards create [作業項目の種類] [タイトル] | 作業項目の作成 |
| /azboards addAreapath [エリアパスを追加するコマンド] [area path] | プロジェクトからこのチャネルに区分パスを追加します |
| /azboards サインインコマンドを実行 | Azure Boards 組織にサインインします |
| /azboards signout コマンドは、アカウントからサインアウトします。 | Azure Boards 組織からサインアウトします |
| /azboards unlink | このチャネルからプロジェクトをリンク解除します |
| /azboards フィードバック | 問題を報告するか、機能を提案する |
| /azboards ヘルプ | コマンドに関するヘルプを表示する |
プライベート チャネルの作業を管理する
Slack 用 Azure Boards アプリを使うと、プライベート チャネルでも作業項目を作成し、作業項目のアクティビティを監視することができます。 プライベート チャネルにボットを招待するには、「/invite @azboards」と入力します。 それを投稿すると、パブリック チャネルと同じように作業項目を作成し、通知を管理できるようになります。
エラーのトラブルシューティング
Slack 用 Azure Boards アプリを使っているときに次のエラーが発生する場合は、このセクションの手順のようにします。
構成に失敗しました。 組織 '{organization name}' が存在し、十分なアクセス許可があることを確認します。
この認証の問題を解決するには、次の手順を実行します。
ブラウザーで
https://aka.ms/VsSignoutに移動して、Azure DevOps からサインアウトします。InPrivate (Microsoft Edge) または Incognito (Chrome) ブラウザー ウィンドウを開きます。
https://aex.dev.azure.com/meに移動し、自分の資格情報を使用してサインインします。プロファイル アイコンの下にあるドロップダウン メニューから適切なディレクトリを選択します。 リンクするプロジェクトを含む組織を含むディレクトリを選択します。
同じブラウザーで、新しいタブを開始し、
https://slack.comに移動し、作業空間にサインインします (Web クライアントを使用)。/azboards signoutコマンドを実行し、その後に/azboards signinコマンドを実行します。
これらの手順で認証の問題が解決しない場合は、Developer Community にお問い合わせください。