作業項目テンプレートの使用

Azure DevOps サービス |Azure DevOps Server |Azure DevOps Server 2022

Visual Studio 2022 |Visual Studio 2019 |Visual Studio 2017 |Visual Studio 2015

作業項目テンプレートを使用して、定義済みの値を持つ作業項目を作成し、類似項目間で一貫した更新を適用します。 この記事では、Web ポータルのテンプレート ワークフローと、2015 年以前のレガシ環境Visual Studioについて説明します。 例については、「 サンプル作業項目テンプレート」を参照してください。

ほとんどのチームでは、Web ポータルを使用します。 Visual Studio 2015 を Power Tools で使用するのは、まだチーム エクスプローラーベースのテンプレート管理に依存している場合のみです。

作業項目テンプレートは、プロセス テンプレートとは異なります。 背景については、「基本、アジャイルスクラムおよび機能成熟度モデル統合 (CMMI)」のプロセスとプロセス テンプレートについて、および既定のプロセス ガイダンスを参照してください。

Tip

この記事の後半でAI を使用してこのタスクに役立てる方法をご説明します。または、Azure DevOps MCP Server で AI サポートを有効にする方法を参照して作業を開始できます。

ワークフローを選択する

この表を使用して、シナリオに最適なワークフローを選択します。

もし望むなら... 用途 なぜでしょうか
現在のAzure DevOpsでテンプレートを作成、管理、適用する Web ポータル (プライマリ) 標準の Web エクスペリエンスでチーム スコープのテンプレートをサポートします。
チームと作業項目の種類別に共有の既定値を再利用する 保存されたテンプレート チームが一貫性のあるフィールドと値を適用するのに役立ちます。
事前入力された作業項目を開く直接リンクを共有する テンプレート URL ダッシュボード、Wiki、チャットでの軽量な共有に最適です。
チーム エクスプローラーベースのテンプレート ワークフローを続行する power Tools を使用した Visual Studio 2015 (レガシ) 環境がまだレガシ ツールに依存している場合にのみ使用します。

前提条件

Workflow Requirements
Web ポータル (プライマリ) - Azure DevOpsの組織とプロジェクトへのアクセス。
- テンプレートを管理するには、テンプレートを所有するチームのメンバーになります。
- テンプレートを適用するには、プロジェクトへの 共同作成者 アクセス権を持っています。
- サポートされているブラウザーを使用し、Web ポータルでAzure DevOpsを開きます。
power Tools を使用した Visual Studio 2015 (レガシ) - このワークフローは、環境がまだチーム エクスプローラー テンプレートの管理に依存している場合にのみ使用します。
- Microsoft Visual Studio Team Foundation Server 2015 Power Tools をインストールします。
- このワークフローで作成されたテンプレートはユーザー スコープであり、チーム エクスプローラーにのみ表示されます。

テンプレートの使用に関する制限事項

Web ポータル テンプレートとVisual Studio テンプレートは別々のストアです。 1 つのクライアントで作成されたテンプレートは、もう一方のクライアントには表示されません。

テンプレートの種類 Scope 管理できる場所 適用できる場所
Web ポータル テンプレート チーム スコープ Web ポータル Web ポータル
Visual Studio テンプレート ユーザー スコープ Visual Studio Visual Studio

どちらのテンプレートの種類の URL を使用しても、Web ポータルで作業項目を作成できます。

サポートされているテンプレート タスク

タスクの可用性は、使用するクライアントによって異なります。 プライマリ Azure DevOps ワークフローには Web ポータルを使用し、従来のシナリオでのみ Visual Studio 2015 と Power Tools を使用します。

次の表は、クライアントによるサポートを示しています。

テンプレート-タスク Web ポータル Visual Studio
作業項目をテンプレートとしてキャプチャする ✅ サポートされています ✅ サポートされています
作業項目テンプレートを管理する
(定義、編集、削除、リンクのコピー、コピーの作成、名前の変更)
✅ サポートされています ✅ サポートされています
テンプレートのリンク (URL) をコピーする ✅ サポートされています ✅ サポートされています
テンプレートを使用して作業項目を追加する ✅ サポートされています ✅ サポートされています
作業項目テンプレートを定義する ✅ サポートされています ✅ サポートされています
1 つ以上の作業項目にテンプレートを適用する ✅ サポートされています ✅ サポートされています
テンプレートのタグを追加または削除する ❌ サポートされていません ✅ サポートされています
ハイパーリンクを使用してテンプレートを定義する ✅ サポートされています ❌ サポートされていません

作業項目をテンプレートとしてキャプチャする

ご利用のクライアントに応じた手順を使用してください: Web ポータル (メイン) または Visual Studio 2015 以前 (従来)。

Web ポータルでキャプチャする各テンプレートは、一意の GUID を取得します。 作業項目をテンプレートとしてキャプチャし、そのリンクをコピーするには、次の手順に従います。

  1. Web ポータルで、テンプレート ソースとして使用する作業項目を開きます。

  2. 右側にある その他のアクション>Templates>Capture を選択します。

    [その他のアクション] メニューからテンプレート オプションとして作業項目フィールド定義をキャプチャする方法を示すスクリーンショット。

  3. キャプチャ テンプレートで、必須フィールドと省略可能なフィールドを構成します。

    • チーム (必須): テンプレートに関連付けるチームを選択します。

    • 名前 (必須): テンプレート名を入力します。

    • フィールド: 追加 を使用してフィールドを含め、 削除 してフィールドを削除し、必要に応じてフィールド 値を 設定します。

    • : テンプレート コンテキストを追加します。 テンプレートから作業項目を作成すると、このテキストは ディスカッション スレッドの最初のエントリとして表示されます。

    Web ポータルの [キャプチャ テンプレート] ダイアログでフィールドを構成する方法を示すスクリーンショット。

  4. [ 保存] を選択し、[ コピー] リンク を選択してテンプレートの URL をコピーします。

    URL を使用して、定義済みの値を持つ同じ種類の作業項目を作成します。 一般的な共有シナリオについては、「 テンプレート URL から作業項目を作成 する」および「 チーム ダッシュボードへのテンプレート リンクの追加」を参照してください。

  5. 選択したチームのテンプレート リストにその作業項目の種類のテンプレートが表示され、コピーされたリンクによって、定義済みの値を含む新しい作業項目フォームが開きます。

作業項目テンプレートを管理する

作業項目の種類ごとに、チームによって定義されたテンプレートを表示および管理できます。 テンプレート リンクの追加、編集、コピー、削除、名前変更、およびコピーを行うことができます。

Web ポータルで作業項目テンプレートを開くには、次の手順に従います。

  1. Web ポータルで、Project設定を開きます。

  2. [ Boards]\(ボード\) で、[ Team configuration]\(チーム構成\) を選択します。

  3. 別のチームを使用する必要がある場合は、パンくずリストの Team セレクターを使用してください。

  4. [ ボード ] ページで、[ テンプレート] を選択します。

    Azure DevOps のプロジェクト設定、ボード、チーム構成、テンプレートから、保存されたテンプレートの一覧にアクセスする方法を示すスクリーンショット

  5. バグ機能テスト ケースなどの作業項目の種類を選択して、その種類のテンプレートを表示または追加します。

    バグ作業項目の種類に対して定義されているテンプレートのスクリーンショット。

作業項目テンプレートを作成する

Web ポータルで作業項目テンプレートを作成するには、次の手順に従います。

  1. [作業項目の種類] ページで、[新しいテンプレート選択します。

    バグ作業項目の種類に新しいテンプレートを追加する方法を示すスクリーンショット。

    大きなテキスト フィールドで markdown を使用する場合は、 <br> タグを追加して改行を管理し、マークダウンが正しくレンダリングされるようにします。

  2. [ 新しいテンプレート ] ダイアログで 、名前 (必須) を入力し、オプションのフィールドと値を追加します。

  3. 保存を選びます。 [ リンクのコピー] オプションが使用可能になります。

  4. [ コピー] リンク を選択して、テンプレートの URL をコピーします。

  5. 選択した作業項目の種類のテンプレートが一覧表示され、コピーされたリンクによってテンプレート値を含む新しい作業項目フォームが開かれることを確認します。

テンプレートを保存したら、テンプレートの更新、削除、リンクのコピー、またはコピーの作成を行うことができます。

[作業項目の種類] ページでテンプレートの [その他のアクション] を選択し、次のいずれかのオプションを選択します。

選択したテンプレートの [その他のアクション] メニュー オプションのスクリーンショット。

  • 編集: [ 編集] を選択し、テンプレートを更新して、[ 保存] を選択します。

  • 削除: [ 削除] を選択し、確認します。 削除されたテンプレートは復旧できません。

  • [リンクのコピー]: [ コピー] リンク を選択して、テンプレートの URL をコピーします。 共有オプションについては、「 テンプレート URL から作業項目を作成する 」および「 チーム ダッシュボードへのテンプレート リンクの追加」を参照してください。

  • コピーの作成: [ コピーの作成] を選択し、名前を入力し、必要に応じてフィールドを調整して、[ 保存] を選択します。

  1. テンプレート リストにアクション (更新された値、名前が変更された項目、コピーされたテンプレート、または削除されたテンプレート) が反映されていることを確認します。

  2. コピー リンクで、期待されるテンプレート値を含む新しい作業項目フォームが開かれることを確認します。

テンプレートを使用して作業項目を追加する

ブラウザーのテンプレート リンクを使用して、定義済みの値を持つ作業項目を作成します。

  1. テンプレート リンクを取得します。 詳細については、「編集、 削除、リンクのコピー、コピーの作成」を参照してください。

  2. テンプレート リンクをブラウザーに貼り付け、必須フィールドに入力し、変更を保存します。

  3. 保存する前に、新しい作業項目がテンプレートで定義された値が入力された状態で開くことを確認してください。

新規または既存の作業項目にテンプレートを適用する

新規または既存の作業項目にテンプレートを適用するか、一括更新にテンプレートを使用します。

Web ポータルでは、開いている作業項目または選択した作業項目全体にテンプレートを適用できます。

作業項目内でテンプレートを適用する

新しい作業項目または既存の作業項目にテンプレートを適用するには、次の手順に従います。

  1. テンプレート定義値で更新する新規または既存の作業項目を開きます。

  2. [その他のアクション>テンプレート] を選択し、定義済みのテンプレートの名前を選択します。

    フォーム内の既存の作業項目にテンプレートを適用する方法を示すスクリーンショット。

    [テンプレート] リストには、自分がメンバーになっているチームに対して定義されたテンプレートが表示されます。 リストが空の場合、作業項目の種類のテンプレートがない可能性があります。 ブラウザーを最新の情報に更新して、使用可能な最新のテンプレートを見つけられます。

  3. [ 保存] を 選択してテンプレートを適用します。 フィールドの変更は、作業項目 履歴 フィールドに記録されます。

  4. フォームのフィールドの更新を確認し、作業項目 履歴 に保存された変更が記録されていることを確認します。

複数の作業項目にテンプレートを適用する

一括更新の選択した作業項目にテンプレートを適用するには、次の手順に従います。

  1. [バックログ] または [クエリ] の結果の一覧から作業項目を選択します。 選択したすべてのアイテムは、 バグ機能など、同じ作業項目の種類である必要があります。

  2. [その他のアクション]>選択した作業項目のテンプレートを選択し、適用するテンプレートを選択します。

    一括更新の複数の作業項目にテンプレートを適用する方法を示すスクリーンショット。

    フィールドの変更が自動的に適用され、保存されます。 フィールドの変更は、作業項目 履歴 フィールドに記録されます。 一括更新の詳細については、「 作業項目の一括変更」を参照してください。

  3. 選択した各作業項目に、更新されたフィールド値と対応する 履歴 エントリが表示されていることを確認します。

テンプレートのタグを追加または削除する

Visual Studio 2015 以前のバージョンでは、テンプレートにタグを追加できます。 テンプレートを使用すると、タグが作業項目に自動的に適用されます。 2 つ以上のタグを追加するには、コンマ (,) で区切ります。 Web ポータルでタグを追加することはできません。

タグを追加または削除する方法を示す [テンプレートの編集] ダイアログのスクリーンショット。

削除するタグを指定しない場合、作業項目内のすべてのタグは定義されたままです。 既存の作業項目に作業項目テンプレートを適用した場合でも、タグは定義されたままです。

Visual Studioで、テンプレートが構成済みのタグを保持し、適用された作業項目に保存後にそれらのタグが含まれることを確認します。

テンプレート URL から作業項目を作成する

定義済みのフィールド値を持つ新しい作業項目を開く URL を作成します。 共通の作業項目構成への共有可能なショートカットが必要な場合は、この方法を使用します。

チーム管理の再利用可能な既定値には、保存されたテンプレートを使用します。 直接リンク共有が主要なエクスペリエンスである場合は、テンプレート URL を使用します。

  • チームで一元管理の既定値が必要な場合は、保存されたテンプレートを使用します。
  • ダッシュボード、Wiki、またはメッセージで軽量な共有が必要な場合は、テンプレート URL を使用します。
https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .
http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

次の例では、定義済みのタイトル割り当て対象説明タグアクティビティ反復パスを使用してタスク作業項目を作成します。

https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/Task?
[System.Title]=TaskTitle&
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1
http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/Task?
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1

一部のブラウザー クライアントでは、フィールド値に 2,000 文字の制限が課されます。

URL をテキスト ファイルとして保存したり、ダッシュボードまたは Web ページにハイパーリンクとして追加したりできます。

URL を開くと、正しい作業項目の種類が読み込まれることを確認し、新しい作業項目フォームに定義済みのフィールド値を表示します。

Web ポータルのチーム ダッシュボードで Markdown ウィジェットへのテンプレート リンクを追加します。 各リンクは、定義済みのテンプレート値を持つ新しい作業項目を開きます。

次の例は、3 つのテンプレートへのリンクを含む Markdown ウィジェットを示しています。

テンプレートへのリンクを含む Markdown ウィジェットのスクリーンショット。

セットアップ手順については、「 ダッシュボードに Markdown を追加する(Markdown ウィジェット)」を参照してください。

テンプレートの問題のトラブルシューティング

  • [テンプレート] メニューが表示されない: プロジェクトへのアクセス権があり、クライアントでサポートされているワークフローを使用していることを確認します。
  • Web ポータルでテンプレートの一覧が空の場合: 選択した作業項目の種類のテンプレートが存在し、テンプレートを所有するチームのメンバーであることを確認します。 ブラウザーを更新して最新のテンプレートを読み込みます。
  • チーム テンプレートを管理できない: テンプレートを所有するチームのメンバーであることを確認します。
  • 複数の作業項目にテンプレートを適用できない: 選択したすべての作業項目が同じ作業項目の種類であることを確認します。
  • Visual Studio テンプレート オプションを使用できません:レガシ Visual Studio 2015 ワークフローを使用していること、および Team Foundation Server 2015 Power Tools Microsoft Visual Studioインストールされていることを確認します。
  • テンプレート URL が予期した値なしで開く: 各フィールド参照名がターゲット作業項目の種類に対して有効であること、および値が URL エンコードされていることを確認します (たとえば、 +%20などのスペース)。
  • テンプレート URL の読み込みに失敗する: URL が正しい組織、プロジェクト、作業項目の種類を使用していること、およびプロジェクト アクセス権を持つアカウントにサインインしていることを確認します。
  • テンプレートの一部のフィールドが設定されない: 作業項目の種類にフィールドがまだ存在し、プロセスカスタマイズルールによって制限されていないことを確認します。

AI を使用して作業項目テンプレートを作成して適用する

Azure DevOps MCP サーバーを構成する場合は、Web ポータルまたはチーム エクスプローラーで各手順を手動で行う代わりに、テンプレート関連のタスクを自然言語で記述できます。

次のプロンプトをシナリオの例として扱います。 使用可能な操作は、MCP サーバーのバージョン、有効なツール、およびアクセス許可によって異なる場合があります。

プロンプトを実行する前に、プレースホルダーを環境の値 ( <ProjectName><TeamName><TemplateName><WorkItemId><IterationPath>) に置き換えます。

Task プロンプトの例
項目からテンプレートを作成する Capture work item <WorkItemId> in project <ProjectName> as a template named "Security bug" for team <TeamName>
新しいテンプレートを作成する Create a Bug template named "Regression" for team <TeamName> in project <ProjectName> with Priority 2 and tag "regression"
テンプレートを 1 つの項目に適用する Apply the "<TemplateName>" template to work item <WorkItemId> in project <ProjectName>
テンプレートを一括適用する Apply the "<TemplateName>" template to all active Bugs tagged "regression" in project <ProjectName>
テンプレートから作業項目を作成する Create 5 Bugs in project <ProjectName> for team <TeamName> using the "<TemplateName>" template with the titles I provide
テンプレート URL を生成する Generate a template URL that creates a Task in project <ProjectName> with Activity=Development and Iteration=<IterationPath>
テンプレートの更新 Update the "<TemplateName>" template for team <TeamName> in project <ProjectName> to set Severity to 2 - High
テンプレートをコピーする Create a copy of the "<TemplateName>" template named "Regression - Mobile" for team <TeamName> in project <ProjectName>
テンプレートが見つからないチームを見つける List teams in project <ProjectName> that don't have a Bug template defined
テンプレートの使用状況の監査 Show which work items in iteration <IterationPath> were created from the "<TemplateName>" template in project <ProjectName>

Visual Studio Codeを使用している場合、エージェント モードは複雑なテンプレート操作に特に役立ちます。