フィールドの追加と管理 (継承プロセス)

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

ユーザー設定フィールドを追加して、追加のデータ要件の追跡をサポートしたり、 フィールドの選択属性を変更したりできます。 たとえば、ユーザー設定フィールドを追加したり、継承されたフィールドの作業項目フォームに表示されるラベルを変更したりできます。

重要

この記事は、Azure DevOps Services および Azure DevOps Server 2019 以降のバージョンに適用されます。 TFS 2018 以前のコレクションで定義されているプロジェクトをカスタマイズするには、「 オンプレミス XML プロセス モデル」を参照してください。

重要

継承プロセス モデルは、継承プロセス モデルをサポートするように構成されたプロジェクト コレクションで定義されているプロジェクトにのみ使用できます。 オンプレミスのコレクションがオンプレミスの XML プロセス モデルを使用するように構成されている場合は、そのプロセス モデルのみを使用して作業追跡エクスペリエンスをカスタマイズできます。 詳細については、「 作業追跡のカスタマイズ」、プロジェクト コレクションのプロセス モデルの選択に関するページを参照してください。

TFS 2018 以前のコレクションで定義されているプロジェクトをカスタマイズするには、「 オンプレミス XML プロセス モデル」を参照してください。

組織に対して定義されているすべてのフィールド (システムおよび継承されたプロセスに定義されているすべてのフィールドを含む) の一覧については、「 作業項目のフィールドと属性を表示する」を参照してください。

ユーザー設定フィールドを追加したら、 クエリ、 グラフ、または 分析ビューと Power BI レポート を作成して、それに関連するデータを追跡できます。

前提条件

プロセスをカスタマイズする前に、「Azure Boardsの構成とカスタマイズ」を確認することをお勧めします。これにより、ビジネス ニーズに合わせてAzure Boardsをカスタマイズする方法に関するガイダンスが提供されます。 さまざまなバックログとボードの説明については、「 バックログ、ボード、タスクボード、プランでサポートされるタスク」を参照してください。

• Azure DevOps Servicesで作成された組織が必要です。 まだ作成していない場合は、 今すぐ作成してください。
• プロセスを作成、編集、管理するには、 Project Collection Administrators グループのメンバーであるか、対応するコレクション レベルのアクセス許可 [プロセスの作成]、[プロセスの 削除]、[ プロセスの編集]、または [ 組織からのフィールドの削除 ] が [許可] に設定されている必要があります。 「作業の追跡のためのアクセス許可とアクセスの設定」、継承されたプロセスのカスタマイズに関するページを参照してください。

• プロジェクトが作成されるプロジェクト コレクションの継承プロセス モデルを選択している必要があります。 詳細については、「 プロジェクト コレクションのプロセス モデルを選択する」を参照してください。
• プロセスを作成、編集、管理するには、 プロジェクト コレクション管理者 グループのメンバーであるか、対応するアクセス許可 [プロセスの作成]、[ プロセスの 削除]、[プロセスの 編集]、または [ 組織からのフィールドの削除 ] が [許可] に設定されている必要があります。 「作業の追跡のためのアクセス許可とアクセスの設定」、継承されたプロセスのカスタマイズに関するページを参照してください。

設定プロセスを>開く

[組織の設定] [プロセス]> からプロセスを作成、管理、カスタマイズします。

1. Azure DevOps ロゴを 選択して 、[プロジェクト] を開きます。 次に、[ 組織の設定] を選択します。

   

2. 次に、[ プロセス] を選択します。

   

   重要

   [プロセス] が表示されない場合は、TFS-2018 以前のバージョンから作業しています。 [プロセス] ページはサポートされていません。 オンプレミスの XML プロセス モデルでサポートされている機能を使用する必要があります。

コレクション設定>プロセスからプロセスを作成、管理、カスタマイズします。

1. Azure DevOps ロゴを 選択して 、[プロジェクト] を開きます。 プロセスをカスタマイズするプロジェクト コレクションを選択し、[ コレクションの設定] を選択します。

   

2. 次に、[ プロセス] を選択します。

   

プロセスの作成、管理、カスタマイズは、管理設定>のプロセスから行います。

1. Azure DevOps ロゴを 選択して 、[プロジェクト] を開きます。 次に、[管理設定] を選択します。

   

2. 次に、[ プロセス] を選択します。

   

Note

継承されたプロセスをカスタマイズすると、そのプロセスを使用するすべてのプロジェクトが、カスタマイズを反映するように自動的に更新されます。 このため、カスタマイズを組織にロールアウトする前にテストするために行うカスタマイズが多数ある場合は、テスト プロセスとテスト プロジェクトを作成することをお勧めします。 詳細については、「 継承されたプロセスの作成と管理」を参照してください。

ユーザー設定フィールド名

継承されたプロセスにユーザー設定フィールドを追加すると、Azure DevOps によって、プレフィックスに Custom が付いた参照名が割り当てられ、次にスペースが削除されたフィールドの名前が割り当てられます。 たとえば、DevOps Triage という名前のフィールドを追加すると、参照名は Custom.DevOpsTriage になります。 参照名内にスペースは使用できません。

カスタム フィールドを追加する

フィールドを追加し、表示するグループとページを指定できます。 また、フィールドを追加したら、ページ内でフィールドをドラッグ アンド ドロップして、フォーム内でその配置を移動できます。 ユーザー設定のページまたはグループに追加するフィールドが複数ある場合は、 最初にそれらのページまたはグループを追加 してから、フィールドを追加します。

Note

各プロセスでは、システム継承フィールドを含め、最大 1024 個のフィールドを定義できます。 フォーム上のページ内でのみフィールドを追加できます。 [割り当て先]、[状態]、[理由] フィールドがあるフォーム内の灰色の領域にフィールドを追加することはできません。

1. 選択した継承されたプロセスの [ プロセス ] ページで、ユーザー設定フィールドを追加する作業項目の種類を選択します。

   ここでは、バグ WIT を選択します。 [すべてのプロセスと MyAgile プロセス] ページに戻ることができる階層リンクに注意してください。

   

   [新規] フィールドとその他のオプションが無効になっている場合、プロセスを編集するために必要なアクセス許可がありません。 「作業の追跡のためのアクセス許可とアクセスの設定」、継承されたプロセスのカスタマイズに関するページを参照してください。

2. WIT が選択された状態で、[新規] フィールドを選択します。

   

3. フィールドに名前を付け、サポートされているデータ型の 1 つからフィールド型を選択します。 必要に応じて、説明を追加します。

   Note

   組織内で一意のフィールド名を指定する必要があります。 あるプロセスに対して定義されたユーザー設定フィールドは、別のプロセスに定義されている名前と同じにすることはできません。 フィールド名の詳細については、「フィールドとは」を参照してください 。フィールド名はどのように使用されますか?

   ここでは、Customer Ticket というラベルの付いた整数フィールドを追加します。

   

4. (省略可能)[ オプション ] タブで、フィールドが必須かどうかを示し、既定値を指定します。 または、値を空白のままにします。 フィールドを 必須にすることで、ユーザーは作業項目を保存するフィールドの値を指定する必要があります。 作業項目を作成するときと、他のユーザーが作業項目を開いてフィールドが空になるたびに、既定値が設定されます。

   

5. (省略可能)[ レイアウト ] タブでは、フィールドの名前とは異なるフォーム ラベルを入力できます。 また、フォームにフィールドが表示されるページとグループを選択することもできます。

   ここでは、[顧客チケット] フィールドを [顧客フォーカス] というラベルの付いた新しいグループに追加します。

   

   Note

   フォーム ラベルは変更できますが、カードにフィールドを追加するとき (かんばん、 タスクボード)、またはフィールドに基づいて クエリを作成する 場合は、フィールド名を使用する必要があります。

6. [ フィールドの追加] を選択して、フィールドの追加を完了します。 レイアウトの場所を指定しない場合は、フォーム上のフィールドの最初のグループに追加されます。

7. すべての変更を完了したら、カスタマイズした種類の作業項目を開きます。

   ここでは、[顧客チケット] フィールドが [状態] グループに追加されたことを示します。 変更を確認するには、ブラウザーの更新が必要な場合があります。

   

選択リストを追加する

作業の追跡、処理、およびプロジェクトの制限

新しいフィールドを追加し、選択リストを定義するか、継承されたフィールドの選択リストをカスタマイズできます。

Note

各組織またはコレクションでは、最大 2048 個の選択リストを定義できます。 各選択リストには、最大 2048 個のアイテムを含めることができます。 選択リスト項目は 256 文字以下にする必要があります。 依存する選択リストを追加する場合は、「 カスケード リスト」を参照してください。

1. まず、[ [新しいフィールド] を選択し、選択リストの種類 (整数または文字列) を指定してから、選択リストに表示する項目を追加します。 項目を追加し、 Enter キーを押して別の項目を追加できます。

   

   リスト内のアイテムを削除するには、アイテムを強調表示し、[削除] の [削除] アイコンをクリックします。

   継承されたフィールドの選択リストを変更するには、[ 編集 ] を選択してフィールドを編集します。 [ 定義 ] タブで、[ 値の追加] を選択できます。

   

2. (省略可能)[ オプション ] タブを選択して、必要に応じてフィールドを定義するか、既定値を指定するか、ユーザーが独自の値を入力できるようにします。

   

3. (省略可能)フォームにフィールドを表示する場所を指定するには、前の 手順 5 を参照してください ([レイアウト ] タブ)。

ID フィールドを追加する

[割り当て先] フィールドと同様のフィールドを追加するには、ID ベースのフィールドを使用します。 ID ベースのフィールドは、[割り当て先] フィールドと同じように機能し、検索および ID ピッカー関数を提供します。 組織が Azure Active Directory または Active Directory でユーザーを管理する場合、システムは ID ベースのフィールドを、これらのディレクトリで定義されている名前と同期します。

1. まず、[] を選択し、フィールド名、ID の種類、および必要に応じて説明を選択します。

   

2. (省略可能)フォームにフィールドを表示する場所を指定するには、前の 手順 5 を参照してください ([レイアウト] タブ)。

リッチ テキストの HTML フィールドを追加する

1. 前と同様に、フィールドを追加する WIT を選択し、[] を選択します。

2. 種類として [テキスト (複数行)] を選択します。 ここでは、フィールドに [顧客要求] というラベルを付けて、製品機能要求の顧客コメントをキャプチャします。

   

3. フィールドは、システム定義のすべてのリッチ テキスト フィールドの最初の列に追加されますが、ディスカッション コントロールの前に追加されます。

   

チェックボックス フィールドを追加する

1. 前と同様に、フィールドを追加する WIT を選択し、[ [新しいフィールド] を選択します。

2. 型として [ブール値] を選択し、ラベルを付けます。 ここでは、フィールドに Triaged というラベルを付けて、バグのトリアージの状態を追跡します。

   

3. (省略可能)[ オプション] タブを開き、フィールドを必須にするかどうかを指定します。

   

4. 既定では、フィールドは 2 番目の列で定義された最後のグループに追加されます。 [ レイアウト ] タブを開き、フィールドをフォーム上の別のグループにドラッグ アンド ドロップします。

   Note

   フィールドは、作業項目フォームのチェック ボックスとして表示されます。 True の値を示すチェック ボックスをオンにします。 かんばんまたはタスクボードにフィールドを表示すると、フィールドの値が True と False (チェック ボックスではなく) 表示されます。

既存のフィールドを別の WIT に追加する

既存のフィールドは、コレクション内で定義されている継承されたフィールドとユーザー設定フィールドに対応します。 ユーザー設定フィールドを 1 つの WIT に追加したら、フォーム メニューから他のユーザーに追加できます。 または、あるプロセスに対して定義されたフィールドを、別のプロセスの作業項目タイプに追加することもできます。 作業項目の種類を開き、既存のフィールドを選択します。

システム定義の作業項目フィールドの説明については、 作業項目フィールドのインデックスを参照してください。

ここでは、[ユーザー ストーリー] WIT に [顧客チケット] フィールドを追加します。

必要に応じて、フィールドのフォーム内の必須/既定値と配置を指定します。

フィールドのラベルを変更する

フィールドの名前を変更したり、フィールドの種類を変更したりすることはできません。 ただし、[ レイアウト ] タブでは、作業項目フォームに表示されるラベルを変更できます。 クエリでフィールドを選択する場合は、フィールド ラベルではなくフィールド名を選択する必要があります。

ここでは、[顧客チケット] フィールドにチケット番号のラベルを付け直します。

説明のヘルプ テキストを変更する

説明ヘルプ テキストは、ユーザーが作業項目フォームのフィールドにカーソルを合わせると表示されます。 作業項目の種類ごとに、同じフィールドに対して異なるヘルプ テキストを定義できます。 変更は、カスタム フィールドと継承されたフィールドの両方でサポートされています。 実装はフィールド型によって異なります。

• 継承されたフィールドの場合: 説明ヘルプ テキストは、作業項目の種類とプロセスごとに異なる方法で定義できます。
• ユーザー設定フィールドの場合: 説明ヘルプ テキストは、すべての作業項目の種類とすべてのプロセスでフィールドに対して同じように表示されます。

Note

特定の機能では、Azure DevOps Server 2020.1 更新プログラムをインストールする必要があります。 詳細については、「Azure DevOps Server 2020 Update 1 RC1 リリース ノート、ボード」を参照してください。

説明ヘルプ テキストは、ユーザーが作業項目フォームのフィールドにカーソルを合わせると表示されます。 ユーザー設定フィールドの説明ヘルプ テキストのみを変更できます。 これは、テキストがすべての作業項目の種類とすべてのプロセスに伝達するのに役立ちます。 ヘルプ テキストをプロセスまたは作業項目の種類別にカスタマイズすることはできません。

説明ヘルプ テキストを変更するには、変更する作業項目の種類を選択し、フィールドの [編集] を選択し、[定義] タブを選択します。変更された値は、プロセス内のフィールドと、その作業項目の種類にのみ影響します。

ここでは、ユーザー ストーリーの [ストーリー ポイント] フィールドを変更します。

ここでは、User Story のユーザー設定の [発行済み] フィールドを変更します。

フィールドの表示、非表示、または削除

フィールドまたはユーザー設定コントロールがフォームに表示されないように、表示または非表示を切り替えることができます。 後でフォームにフィールドを復元する場合は、非表示を解除できます。これらのアクションは、組織からフィールドを削除する [削除 ] オプションとは異なります。

継承されたフィールドまたはユーザー設定コントロールをフォームに表示したり非表示にしたりすることもできます。 ユーザー設定フィールドの場合は、フォームから削除できます。 [レイアウトに表示] を選択して復元する場合。 これらのアクションは、組織からフィールドを削除する [ 削除 ] オプションとは異なります。

Note

継承されたフィールドに対して定義されたデータは、非表示にした場合でも、データ ストアと作業項目履歴に保持されます。 作業項目の [履歴] タブを表示すると、そのレコードを表示できます。

レイアウトからユーザー設定フィールドを削除すると、データ ストアに保持されますが、履歴から削除されます。 クエリ結果から表示できます。 フィールドをフォームに追加し直すと、そのフィールドの履歴が復元されます。プロジェクト コレクションからユーザー設定フィールドを削除するには、「 フィールドを削除する」を参照してください。

フィールドまたはユーザー設定コントロールを非表示にする

継承されたフィールドまたはユーザー設定コントロールを非表示にする

1. フィールドまたはコントロールのコンテキスト メニューを開き、[ レイアウトから非表示] を選択します。

   

2. 非表示のフィールドまたはコントロールをフォームに追加するには、[ レイアウトに表示] を選択します。

フォームからユーザー設定フィールドを削除する

1. 削除するフィールドのコンテキスト メニューから [削除] を選択します。

   

2. フィールドを削除することを確認します。

   

3. 削除されたユーザー設定フィールドを追加するには、[ 新しいフィールド ] を選択し、[ 既存のフィールドを使用する] を選択します。

フィールドを既定の既定値に戻す

継承されたフィールドに加えた変更は破棄できます。 変更した作業項目の種類の [レイアウト ] ページで、フィールドの [元に戻す ] オプションを選択します。

ユーザー設定フィールドを削除する

継承プロセス モデルでは、ユーザー設定フィールドのみを削除できます。 システムの既定のプロセスに対して定義されているフィールドを削除することはできません。

フィールドを削除すると、履歴値を含め、そのフィールドに関連付けられているすべてのデータが削除されます。 一度削除すると、フィールドを復元し、 Fields - Update REST API を使用してデータを回復できます。

Note

使用されていないフィールドのみを削除することをお勧めします。 witadmin listfields コマンドを実行することで、使用されていないフィールドを特定できます。 方法については、「 作業項目フィールドの管理 (witadmin)」を参照してください。
または、組織またはコレクションに対して Analytics が有効になっている場合は、次の構文を使用して、ユーザー設定フィールドが使用されている場所について Analytics に対してクエリを実行できます。

https://analytics.dev.azure.com/{OrganizationName}/_odata/v4.0-preview/WorkItemTypeFields?$filter=FieldReferenceName eq {CustomFieldReferenceName}&$select=WorkItemType

1. [すべてのプロセス> フィールド] ページからフィールドを削除します。

   

   フィールドを削除するには、Project Collection Administrators グループのメンバーであるか、 アカウントから [削除] フィールドに対する明示的なアクセス許可が付与されている必要があります。

2. 削除操作を完了するには、次のようにフィールドの名前を入力する必要があります。

   

関連記事

Note

継承されたプロセスに加えられた変更は、監査ログを通じて確認できます。 詳細については、「 監査ログへのアクセス、エクスポート、フィルター処理」を参照してください。

• 作業項目のフィールドと属性を表示する
• カスタム作業項目の種類を追加または変更する
• Web レイアウトをカスタマイズする
• 継承されたプロセスを使用してプロジェクトをカスタマイズする
• ボード上のカードをカスタマイズする
• バックログとボードにバグを表示する
• 作業の追跡、処理、およびプロジェクトの制限

テスト 計画またはテスト ケースを使用している場合は、次の記事を参照してください。

• テスト計画の作成
• 手動テスト ケースの作成