Microsoft Teams で Azure Boards を使用する

Azure DevOps Services

この記事では、Microsoft Teams 用の Azure Boards アプリと Azure DevOps アプリを使用して、Teams チャネルから Azure Boards 作業項目を作成して監視する方法について説明します。

Microsoft Teams 用の Azure Boards アプリを使用すると、次のことができます。

• Teams チャネルで作業項目と作業項目イベントを作成して管理するためのサブスクリプションを設定して管理する。
• チャネル内の会話から作業項目を作成する。
• メッセージング拡張機能を使用して、作業項目を検索したり、他のチャネルと作業項目を共有したりする。
• URL から作業項目のプレビューを表示する。

この記事では、次のことについて説明します。

• Azure Boards アプリを Microsoft Teams のチームに追加する。
• Azure Boards プロジェクトを Azure Boards アプリにリンクする。
• Teams チャネルで作業項目イベントへのサブスクリプションを設定する。
• Teams チャネルから作業項目を作成する。
• Teams チャネルで作業項目アクティビティを監視する。

前提条件

• アプリをインストールできる Microsoft Teams のチームとチャネルへのアクセス。
• Azure DevOps プロジェクトのプロジェクト管理者またはチーム管理者のロール。
• [OAuth を使用したサードパーティ アプリケーションのアクセス] が Azure DevOps 組織設定で有効になっている。

詳細については、次のリソースを参照してください。

• プロジェクトの作成
• プロジェクト レベルのアクセス許可を変更する
• チーム管理者を追加する
• 組織のアプリケーション アクセス ポリシーを変更する

Azure Boards アプリを Teams に追加する

Azure Boards アプリを Teams チャネルに追加できます。

1. Microsoft Teams で [アプリ] を選択して [Azure Boards] を検索し、[Azure Boards] を選択します。

   

2. [開く] の横にあるドロップダウン矢印を選択し、[チームに追加] を選択します。

   

3. チーム名を選択または入力してから、[ボットの設定] を選択します。

   

アプリがインストールされると、Teams の会話ウィンドウにウェルカム メッセージが表示されます。

Azure Pipelines アプリのコマンド

次の @azure boards コマンドを使用すると、Teams チャネルで Azure Boards アプリを操作できます。

Azure Boards プロジェクトを Azure Boards アプリにリンクする

アプリを使用するには、Azure Boards にサインインして、Azure Boards プロジェクトを Teams チャネルにリンクします。

1. Teams の会話ウィンドウで、「@azure boards signin」と入力します。

2. [サインイン] を選択し、Azure Boards への認証を完了します。 Microsoft Teams と Azure Boards が異なるテナントにある場合は、[別のメール アドレスでサインインする] を選択します。

3. @azure boards link コマンドを使用して、Azure DevOps プロジェクトの URL にリンクします。 次に例を示します。

   @azure boards link https://dev.azure.com/myorg/myproject/
   

4. リンクされたプロジェクト通知の [サブスクリプションの追加] ボタンを選択して、プロジェクトの監視を開始します。

   

サブスクリプションを設定する

プロジェクトがリンクされたら、[サブスクリプションの追加] ボタンを選択して、プロジェクトの作業項目の監視を開始します。 @azure boards subscriptions コマンドを使用すると、いつでもサブスクリプションを追加できます。

1. [イベントの選択] で、サブスクライブするイベントを選び、[次へ] を選択します。

   

2. [フィルターの選択] で、[区分パス]、[作業項目の種類] を選択し、必要に応じて [タグ] またはフィルターする特定の文字列を指定してから、[送信] を選択します。

   

区分パスを追加する

チャネルにサブスクリプションがある区分パス、最近アクセスした区分パス、および @azure boards addAreapath コマンドを使用して追加した区分パスは、サブスクリプションの作成時に [区分パス] ドロップダウン メニューに表示されます。 チームが作業している区分パスがドロップダウン メニューに表示されない場合は、その区分パスを追加して、作業項目とサブスクリプションの作成時に常に使用できるようにすることができます。 この機能は、プロジェクトで 100 を超える区分パスを持つチームにとっては特に便利です。

プロジェクトから Teams チャネルに区分パスを追加するには、@azure boards addAreapath コマンドを使用します。 次に例を示します。

@azure boards addAreapath 'VMdemo\Area4'

性交メッセージが表示されます。

プロジェクト名を区分パスとして選択すると、プロジェクト内のすべての区分パスに関する通知が届きます。

作業項目を作成する

Azure Boards アプリを使用すると、メッセージ アクションを使用してチャネルから作業項目を作成できます。

1. チャネル内の任意のメッセージで、アクション パネルの [その他の操作] の省略記号を選択し、[作業項目の作成] を選びます。

   

2. 作成する作業項目の種類を選び、[次へ] を選択します。

3. [タイトル] を入力して、作業項目の [区分パス] を選択します。

4. メッセージのテキストは、作業項目の種類に応じて、作業項目の [説明] または [ステップの再現] になります。あるいは、このテキストを編集することもできます。 ［作成］ を選択します

   

新しい作業項目が Azure Boards に表示されます。新しい作業項目には、その作業項目を生成した Teams 項目へのリンクが含まれます。

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

チャネルのサブスクリプションを表示、追加、削除するには、@azure boards subscriptions コマンドを使用します。 このコマンドにより、チャネルの現在のすべてのサブスクリプションが一覧表示されます。 新しいサブスクリプションを追加したり、既存のサブスクリプションを削除したりできます。 サブスクリプションを追加するときに、フィルターを使用すると通知をカスタマイズできます。

作成拡張機能を使用する

ユーザーが作業項目を検索したり共有したりできるように、Microsoft Teams 用の Azure Boards アプリでは作成拡張機能がサポートされています。 作業項目 ID、タイトル、またはサポートされている機能コマンドで作業項目を検索できます。 サポートされているコマンドの一覧については、「機能作業項目の検索」を参照してください。

作成拡張機能を使用するには、Teams チャネルで Azure Boards プロジェクトにサインインする必要があります。 メッセージ フィールドで + 記号を選び、[Azure Boards] を選択してから、作業項目を検索します。 [作業項目の作成] を選択して新しい作業項目を作成することもできます。

作業項目のプレビュー

チャネルでユーザーが説明する作業項目に関するコラボレーションをサポートするために、Azure Boards アプリではユーザーが参照する作業項目のプレビューを表示できます。 作業項目の URL を貼り付けるか、作成拡張機能から作業項目を選択すると、アプリには次の図のようなプレビューが表示されます。 この URL の展開機能は、チーム内のすべてのチャネルで動作します。

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

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

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

スレッドの展開と折りたたみ

Teams チャネルはスレッド内の投稿を折りたたんで、チャネル内の関連する投稿を論理的にリンクおよび縮小します。 特定の投稿に対するすべての返信がリンクされます。

スレッドを展開するには、圧縮されたスレッド リンクを選択します。

チャネルに戻り、スレッドを折りたたむには、[チャネルに移動] を選択します。

Azure DevOps タブを構成する

プロジェクト ダッシュボードまたはかんばんボードを Teams に取り込むには、Teams チャネルのタブに Azure DevOps アプリをインストールします。 Azure DevOps アプリを使用すると、アプリのコンテンツをメッセージに挿入したり、アプリからの通知をチャネルで受け取ったりできます。

1. Teams の チャネルの上部ナビゲーションで + 記号を選択するか、左側のメニューから [アプリ] を選択します。

2. 必要に応じて検索し、[Azure DevOps] を選択します。

   

3. Azure DevOps Services 組織を選択してサインインします。

4. [Azure DevOps] 画面で、[プロジェクト] を選択し、タブに [ダッシュボード] または [かんばんボード] を追加するかどうかを選択します。選択に応じて他の構成を選び、タブの追加についてチャネルに投稿するかどうかを選択します。

   

5. [保存] を選択します。 チャネルに新しいタブとボードが表示されます。

異なるテナントを接続する

Microsoft Teams と Azure DevOps に異なるメールまたはテナントを使用している場合は、次の手順を実行し、設定に基づいてサインインして接続します。

認証の問題のトラブルシューティング

"構成に失敗しました。組織 '{{組織名}}' が存在していること、および十分な権限があることを確認してください" というエラーが表示された場合には、次の手順を試してエラーを解決してください。

1. 同じブラウザーで、新しいタブを開始し、https://teams.microsoft.com/ にサインインします。

2. このタブで、Microsoft Teams 用の Azure Boards アプリがインストールされているチャネルに移動し、@azure boards signout コマンド、@azure boards signin コマンドの順に実行します。

3. [サインイン] ボタンを選択し、サインイン プロセスを完了します。 表示されているディレクトリが前の手順で選択したものと同じであることを確認します。

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

関連記事

• 区分パスを定義してチームに割り当てる
• Microsoft Teams と共に Azure Pipelines を使用する
• Microsoft Teams と共に Azure Repos を使用する