次の方法で共有


Slack で Azure Boards を使用する

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 ワークスペースに追加する

  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
    

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

Note

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

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

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

チャネル内でディスカッションが行われている作業項目に関する共同作業をサポートするため、チャネルに参照されている作業項目のプレビューが表示されます。 ユーザーが作業項目の 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}' が存在し、十分なアクセス許可があることを確認します。

この認証の問題を解決するには、次の手順を実行します。

  1. ブラウザーで https://aka.ms/VsSignout に移動して、Azure DevOps からサインアウトします。

  2. InPrivate (Microsoft Edge) または Incognito (Chrome) ブラウザー ウィンドウを開きます。

  3. https://aex.dev.azure.com/me に移動し、自分の資格情報を使用してサインインします。

  4. プロファイル アイコンの下にあるドロップダウン メニューから適切なディレクトリを選択します。 リンクするプロジェクトを含む組織を含むディレクトリを選択します。

    プロジェクトを含む組織を含むディレクトリの選択を示すスクリーンショット。

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

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