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

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

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

作業項目テンプレートを使うと、チームでよく使うフィールドの値が事前に設定された作業項目をすばやく作成できます。 作業項目テンプレートを使って、作業項目を作成したり、複数の作業項目を一括更新したりできます。 Web ポータルまたは Visual Studio 2015 以前のバージョンから、作業項目テンプレートを追加および管理できます。 作業項目テンプレートの使用方法を示す例については、作業項目テンプレートのサンプルに関する記事をご覧ください。

作業項目テンプレートは、プロセス テンプレートとは異なります。 詳細については、プロセスとプロセス テンプレートの概要に関する記事、または規定のプロセス テンプレートに関する具体的なトピック (基本アジャイルスクラムCMMI) を参照してください。

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

利用できるテンプレート タスクのオプションは、クライアントとプラットフォームのバージョンによって異なります。 Web ポータルまたは Visual Studio 2015 以前のバージョンから、作業項目テンプレートを追加および管理できます。 詳しくは、この記事の「前提条件」をご覧ください。

次の表の ✔️ で示されているタスクは、Web ポータルまたは Visual Studio 2015 以前のバージョンから使用できます。 (お使いのプラットフォームのバージョンに基づいて、コンテンツのバージョンを選んでください)。


タスク

Web ポータル

Visual Studio 2015


✔️

✔️


作業項目テンプレートを管理する
(定義、編集、削除、リンクのコピー、コピーの作成、名前の変更)

✔️

✔️


✔️

✔️


✔️

✔️


✔️

✔️


✔️

✔️


✔️


✔️


ヒント

Web ポータルで定義するテンプレートは、Visual Studio で定義するテンプレートとは異なります。 Web ポータルのテンプレートの管理と作業項目への適用は、Web ポータルからのみ行うことができます。 同様に、Visual Studio のテンプレートの管理、表示、作業項目への適用は、Visual Studio でのみ行うことができます。 ただし、両方のテンプレートの種類の URL を使うと、Web ポータルから作業項目を追加できます。

前提条件

  • Web ポータルで作業項目テンプレートを管理するには、それを所有しているチームに参加する必要があります。 その後、必要に応じてテンプレートを追加、編集、または削除できます。

  • Web ポータルで作業項目テンプレートを使うには、プロジェクト共同作成者およびチーム メンバーである必要があります。 その後、既存の作業項目にテンプレートを適用できます。

  • Web ポータルを使って作業項目テンプレートの追加、キャプチャ、編集、または削除を行うには、チーム管理者である必要があります。

  • チーム テンプレートを適用するには、プロジェクトの共同作成者であり、作業項目テンプレートが定義されているチームのメンバーである必要があります。

  • Visual Studio のチーム エクスプローラーを使って作業項目テンプレートの追加、キャプチャ、または編集を行うには、Microsoft Visual Studio Team Foundation Server 2015 Power Tools をインストールします。 これらのテンプレートは、チーム エクスプローラーのビューにのみ表示されます。

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

お使いのプラットフォーム、バージョン、クライアントにより、作業項目をキャプチャするために必要な手順が異なる場合があります。

Web ポータルでキャプチャされたテンプレートには、GUID が割り当てられます。

  1. Web ポータルから、テンプレートの基にする作業項目を開きます。

  2. アクション アイコンを選んでメニューを開きます。 [テンプレート] を選んでから、[キャプチャ] を選びます。

    Screenshot of Capture work item field definitions as a template, latest version.

    テンプレートの名前を指定し、保存するチームを選び、必要に応じてフィールドを定義またはクリアします。 終わったら、テンプレートを保存します。

    Screenshot of Capture template dialog.

  3. テンプレートを保存した後、[リンクのコピー] を選んでテンプレートの URL をキャプチャします。

  4. URL リンクをブラウザーに貼り付けて作業項目を作成したり、他のユーザーがそれを使って作業項目を追加できるよう提供したりできます。 たとえば、プロジェクトの WikiMarkdown ウィジェットを使用するダッシュボード、またはその他の共有ネットワーク リソースに、ハイパーリンクとして追加できます。

    定義済みの値で定義した種類の作業項目を追加するときは常に、この URL を使います。

Web ポータルでキャプチャされたテンプレートには GUID が割り当てられます。

  1. Web ポータルから、テンプレートの基にする作業項目を開きます。

    Web ポータル内では、作業項目テンプレートはチームに関連付けられます。 Web ポータルを使って作業項目にテンプレートを適用する場合は、チームに対して定義されているテンプレートにのみアクセスできます。

  2. アクション アイコンを選んでメニューを開きます。 [テンプレート] を選んでから、[キャプチャ] を選びます。

    Capture work item field definitions as a template

    テンプレートの名前を指定し、必要に応じてフィールドを定義またはクリアします。 終わったら、テンプレートを保存します。 テンプレートは、最初のステップで選んだチームの下に保存されます。

    Capture template dialog

  3. テンプレートを保存したら、[リンクのコピー] を選んで、テンプレートを使って作業項目を追加するために使用できるテンプレートの URL をキャプチャします。

  4. 定義済みの値で定義した種類の作業項目を追加するときは常に、この URL を使います。

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

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

作業項目の種類ごとに、チームが定義したテンプレートを表示および管理できます。 テンプレートに対して、追加、編集、コピー、削除、名前の変更、リンクの取得など、さまざまなアクションを実行できます。

  1. Web ポータルから、[プロジェクトの設定] を開きます。

    Screenshot showing project settings button.

    [Boards] を展開して、[チームの構成] を選びます。 別のチームに切り替える必要がある場合は、チーム セレクターを使用します。

  2. [テンプレート] を選びます。

    任意の作業項目の種類を選んで、その種類のテンプレートを表示または追加します。

チームの設定からテンプレートを管理します。 すべてのテンプレートは、チームに対して定義されます。 チームの管理者でない場合は、管理者として追加するよう依頼します。 作業項目テンプレートを変更できるのは、チームまたはプロジェクトの管理者だけです。

  1. Web ポータルから、チームの設定を開きます。

    歯車アイコンを選んで、チームの設定を開きます。

    ここでは、Web チームの管理者ページを開きます。

    Screenshot of admin page.

  2. [作業] > [テンプレート] を選択します。

    Screenshot of Open Work - Templates page for team.

    ここから、任意の作業項目の種類を選んで、その種類のテンプレートを表示または追加できます。

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

[プロジェクトの設定]>[チームの構成]>[テンプレート] を選びます。 作業項目の種類を選んで、定義されているテンプレートを表示します。

たとえば、ユーザー ストーリーをキャプチャするために定義されているテンプレートを表示するには、[ユーザー ストーリー] を選びます。

Screenshot of User Story templates selection.

作業項目の種類を選んで、定義されているテンプレートを表示します。

たとえば、ユーザー ストーリーをキャプチャするために定義されているテンプレートを表示するには、[ユーザー ストーリー] を選びます。

Screenshot of managing user story templates.

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

  1. 作業項目の種類のページで、green plus icon[新しいテンプレート] を選んで、テンプレートを最初から作成します。

    Screenshot showing adding a user story template.

  2. テンプレートの名前を指定し、必要に応じてフィールドを追加および削除します。 終わったら、テンプレートを [保存] します。

  3. テンプレートの URL を取得するには、[リンクのコピー] を選びます。 この URL を使うと、テンプレートを基にして作業項目を作成できます。

作業項目の種類のページで、既存のテンプレートの アクション アイコンを選んで、[編集][削除][リンクのコピー]、または [コピーの作成] のメニュー オプションにアクセスします。

Screenshot of Open template action menu.

  • 編集: [編集] を選んで、変更を [保存] します。
  • 削除: [削除] を選んでから、[テンプレートの削除] 確認ダイアログでもう一度 [削除] を選びます。 いったん削除したテンプレートは復元できません。
  • リンクのコピー: [リンクのコピー] を選びます。 定義済みの値で定義した種類の作業項目を追加するときは常に、この URL を使います。 URL をテキスト ファイルとして保存したり、Web ページにハイパーリンクとして追加したり、共有ネットワークにリンクをコピーしたり、メールでチームに送信したりできます。 また、チーム ダッシュボードにリンクを追加することを検討します。
  • コピーの作成: [コピーの作成] を選びます。 テンプレートに名前を付け、必要に応じてフィールドを追加および削除した後、済んだら [保存] します。

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

テンプレートを使って作業項目を追加する主要な方法は、ブラウザー ウィンドウ内でテンプレートのリンクを開くことです。 テンプレートのリンクを取得するには、編集、削除、リンクのコピー、コピーの作成に関するセクションをご覧ください。

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

テンプレートを 1 つの作業項目に適用することも、複数の作業項目をまとめて更新することもできます。

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

  1. テンプレートで定義されているフィールドを使って更新する新しい作業項目または既存の作業項目を開き、 アクション アイコンを選んでメニューを開いて、[テンプレート] を選んでから、定義されているテンプレートの名前を選びます。

    Screenshot of Apply a template to an existing work item within the form.

    自分が所属するチームに対して定義されているテンプレートのみが表示されます。

    ヒント

    追加された最新のテンプレートを見つけるには、ブラウザーを最新の情報に更新します。 テンプレートが表示されない場合は、その作業項目の種類にはテンプレートがない可能性があります。

  2. 変更を適用する作業項目を保存します。 変更されたフィールドが、[履歴] フィールドで示されます。

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

  1. テンプレートで定義されているフィールドを使って更新する作業項目を開き、 アクション アイコンを選んでメニューを開いて、[テンプレート] を選んでから、定義されているテンプレートの名前を選びます。

    Screenshot of Apply a template to an existing work item within the form.

    ヒント

    追加された最新のテンプレートを見つけるには、ブラウザーを最新の情報に更新してください。 テンプレートが何も表示されない場合は、その作業項目の種類に対して定義されているものがない可能性があります。

  2. 変更を適用する作業項目を保存します。 変更されたフィールドが、[履歴] フィールドで示されます。

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

  1. 複数の作業項目を一括で更新するには、最初にバックログまたはクエリ結果の一覧からそれらを選び、そのうちの 1 つのアクション メニューを開きます。 選択するすべての作業項目は、同じ作業項目の種類である必要があります。 たとえば、すべてがユーザー ストーリーや、すべてがバグなどです。

  2. 適用するテンプレートを選びます。

    Screenshot of Bulk update several work items.

  3. フィールドの変更が自動的に適用され、作業項目が保存されます。 一括更新について詳しくは、作業項目の一括変更に関する記事をご覧ください。

  1. 複数の作業項目を一括で更新するには、最初にバックログまたはクエリ結果の一覧からそれらを選び、そのうちの 1 つのアクション メニューを開きます。 選択するすべての作業項目は、同じ作業項目の種類である必要があります。 たとえば、すべてがユーザー ストーリーや、すべてがバグなどです。

  2. 適用するテンプレートを選びます。

    Screenshot of Bulk updating several work items.

  3. フィールドの変更が自動的に適用され、作業項目が保存されます。 一括更新について詳しくは、作業項目の一括変更に関する記事をご覧ください。

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

テンプレートにタグを追加でき、テンプレートを使うと作業項目にタグが適用されます。 2 つ以上のタグを追加するには、コンマ (,) で区切ります。

Edit bug template, add or remove tags

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

次の構文を使って、複数のフィールド値を指定する作業項目テンプレートを指定できます。 定義済みの値で定義した種類の作業項目を追加するときは常に、この URL を使います。

https://dev.azure.com/{OrganizationName}/{ProjectName}/_workItems/create/{WorkItemType}?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .
http://{ServerName}:8080/tfs/DefaultCollection/{ProjectName}/_workItems/create/{WorkItemType}?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

たとえば、次の構文では、TaskTitle というタイトルの作業項目タスクを指定します。 [割り当て先]、[説明]、[タグ]、[アクティビティ]、[イテレーション パス] の各フィールドの値を指定します。

https://dev.azure.com/{OrganizationName}/{ProjectName}/_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://{ServerName}:8080/tfs/DefaultCollection/{ProjectName}/_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 ページに追加することもできます。

Web ポータルのチーム ダッシュボードに表示される Markdown ウィジェットにリンクを追加できます。 これらのリンクでは、定義済みのフィールドが定義されたテンプレートを使って作業項目が開かれます。

たとえば、次のウィジェットには 3 つのテンプレートへのリンクが含まれます。

Markdown widget with links to templates

Markdown ウィジェットについて詳しくは、「ダッシュボードに Markdown を追加する」の Markdown ウィジェットに関する説明を参照してください。