次の方法で共有


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

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

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

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

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

前提条件

前提 Description
アクセス許可 - Web ポータルで作業項目テンプレートを管理するには、テンプレートを所有するチームのメンバーになります。 その後、必要に応じてテンプレートを追加、編集、または削除できます。
- Web ポータルで作業項目テンプレートを使用するには、プロジェクトの 共同作成者 になります。 その後、既存の作業項目にテンプレートを適用できます。
ツール - Visual Studio Team Explorer を使用して作業項目テンプレートを追加、キャプチャ、または編集するには、 Microsoft Visual Studio Team Foundation Server 2015 Power Tools をインストールします。 これらのテンプレートは、チーム エクスプローラーのビューにのみ表示されます。

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

テンプレート タスク オプションの可用性は、クライアントとプラットフォームの構成によって異なります。 Web ポータルまたは Visual Studio 2015 以前のバージョンから、作業項目テンプレートを追加および管理できます。

次の表は、Web ポータルと Visual Studio 2015 以前のバージョンでのタスクのサポートを示しています。 タスクの説明リンクを使用して対応するセクションにジャンプする場合は、必要に応じて、プラットフォーム構成のセクションのコンテンツ バージョン (タブ) を選択してください。

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

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

Web ポータルで定義されているテンプレートは、Visual Studio で定義されたテンプレートとは異なります。

  • Web ポータルのテンプレートの管理と作業項目への適用は、Web ポータルからのみ行うことができます。
  • Visual Studio テンプレートは、Visual Studio の作業項目にのみ管理、表示、および適用できます。

ただし、両方のテンプレートの種類の URL を使用して、Web ポータルから作業項目を追加できます。

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

お使いのプラットフォーム、バージョン、クライアントにより、作業項目をキャプチャするために必要な手順が異なる場合があります。 次のセクションでは、Web ポータルと Visual Studio 2015 以前のバージョンの手順について説明します。

Azure DevOps は、Web ポータルでキャプチャされた各テンプレートに一意の GUID 識別子を割り当てます。 Web ポータルを使用して作業項目をテンプレートとしてキャプチャし、保存されたテンプレートのリンクにアクセスするには、次の手順に従います。

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

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

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

  3. [ キャプチャ テンプレート ] ダイアログで、必要なフィールドと任意のフィールドを構成します。

    • チーム: (必須) ドロップダウン リストを使用して、キャプチャされたテンプレートに関連付ける既存のチームを選択します。

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

    • フィールド: 追加 アクションを使用してフィールドを追加し、 削除 アクションを使用してフィールドを削除し、必要に応じて特定のフィールド を調整します。

    • : テンプレートに関する詳細情報を追加するには、ボックス内を選択します。 ボックス内を選択すると、編集ツールが表示されます。 キャプチャしたテンプレートから新しい作業項目を作成すると、 ディスカッション スレッドの最初のエントリとして情報が追加されます。

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

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

    このURLは、定義済みの値を持つ同じ種類の作業項目を追加する場合に使用します。 いくつかの例を次に示します。

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

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

Web ポータルから作業項目テンプレートにアクセスするには、次の手順に従います。

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

  2. [Boards]\ (ボード \) セクションで、[Team configuration]\( チームの構成\) を選択します。 別のチームに切り替える必要がある場合は、ページの階層リンク 証跡で チーム セレクターを使用します。

  3. [ ボード ] ページで、[テンプレート] セクション 選択します。

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

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

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

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

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

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

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

  2. [ 新しいテンプレート ] ダイアログで、テンプレートの 名前 (必須) を入力し、必要に応じて必要な値を含むフィールドを追加します。

  3. 保存 を選択します。 [ リンクのコピー] オプションが使用可能になります。 この URL を使うと、テンプレートを基にして作業項目を作成できます。

テンプレートを保存したら、テンプレートの編集または削除、テンプレートへの共有可能なリンクの作成、またはテンプレートのコピーの作成を行うことができます。

[作業項目の種類] ページで、[既存のテンプレートに対するその他のアクション] を選択し、メニュー オプションを選択します。

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

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

  • 削除: テンプレートを削除するには、[削除] を選択 します。 確認ダイアログで、[削除] を選択 します。 テンプレートを削除した後は、回復できません。

  • リンクのコピー: テンプレートの URL のコピーを取得するには、[リンクの コピー] を選択します。 このURLは、定義済みの値を持つ同じ種類の作業項目を追加する場合に使用します。 URL をテキスト ファイルとして保存したり、Web ページにハイパーリンクとして追加したり、共有ネットワークへのリンクをコピーしたり、電子メールでチームに送信したりできます。 また、チーム ダッシュボードにリンクを追加することを検討します。

  • コピーの作成: テンプレートのコピーを作成するには、[ コピーの作成] を選択します。 テンプレート コピーの名前を入力し、必要に応じてフィールドの追加、削除、更新を行います。 完了したら 、[保存] を選択します

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

テンプレートを使用して作業項目を追加する最も一般的な方法は、ブラウザー ウィンドウ内でテンプレート リンクを開く方法です。

  1. テンプレートのリンクを取得するには、 編集、削除、リンクのコピー、コピーの作成 に関するセクションをご覧ください。

  2. 新しい作業項目を作成するには、ブラウザー ウィンドウにテンプレート リンクを貼り付け、必要なフィールドを構成して、変更を保存します。

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

新しい作業項目または既存の作業項目にテンプレートを適用したり、複数の既存の作業項目を一括更新したりできます。

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

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

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

  1. テンプレート内で定義されているフィールドを使用して、更新する新しい作業項目または既存の作業項目を開きます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Visual Studio 2015 以前では、次の構文を使用して、複数のフィールド値を定義する作業項目テンプレートを指定できます。 定義済みの値を持つ同じ種類の作業項目を追加する場合は常に URL を使用できます。 このタスクは、Web ポータルでは使用できません。

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}&
. . .

たとえば、次のコードは、 TitleTaskTitle を使用して作業項目タスクを指定します。 この構文では、[ 割り当て済み]、[ 説明]、[ タグ]、[ アクティビティ]、[ 反復パス ] フィールドの値を指定します。

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 ページに追加することもできます。

Web ポータルのチーム ダッシュボードで Markdown ウィジェットへのリンクを追加できます。 これらのリンクにより、テンプレート定義フィールドが定義済みの作業項目が開きます。

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

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

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