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

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

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

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

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

前提条件

特定のビジネス要件に合わせて Azure Boards を調整する方法については、「 Azure Boards の構成とカスタマイズについてを参照してください。

• 組織の要件: Azure DevOps に組織化があることを確認します。

• アクセス許可:

  • Project コレクション管理者グループのメンバーになります。
  • Create process、Delete process Edit process、Delete a field from organization Allow などのコレクション レベルのアクセス許可を持ちます。
  • これらのアクセス許可を使用すると、組織内のプロセスとフィールドを変更できます。

組織プロセスの設定を開く

1. 組織にサインインします (https://dev.azure.com/{yourorganization})。

2. [組織の設定] を選択します。

   

3. プロセスを選択します。

   

Note

継承されたプロセスをカスタマイズすると、そのプロセスを使用するすべてのプロジェクトにそのカスタマイズが自動的に反映されます。 スムーズな移行を確実に行うために、組織全体でカスタマイズを実装する前にテスト プロセスとプロジェクトを作成することをお勧めします。 詳細については、「 継承されたプロセスの作成と管理を参照してください。

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

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

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

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

Note

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

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

   ここでは、バグ WIT を選択します。 階層リンクをメモします。このリンクを使用すると、 すべてのプロセス と MyAgile プロセス ページに戻ることができます。

   

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

2. WIT が選択されたら、 New フィールドを選択します。

   

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

   Note

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

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

   

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

   

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

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

   

   Note

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

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

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

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

   

候補リストを追加する

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

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

Note

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

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

   

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

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

   

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

   

3. (省略可能)前の 手順 5 を参照して、フォームにフィールドを表示する場所を指定します (Layout タブ)。

ID フィールドを追加する

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

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

   

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

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

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

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

   

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

   

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

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

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

   

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

   

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

   Note

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Note

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

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

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

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

   

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

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

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

   

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

   

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

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

継承されたフィールドに加えた変更は破棄できます。 変更した作業項目の種類の Layout ページで、フィールドの Revert オプションを選択します。

カスタム フィールドを削除する

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

フィールドを削除すると、履歴値を含め、そのフィールドに関連付けられているすべてのデータが削除されます。 一度削除すると、 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. すべてのプロセス>Fields ページからフィールドを削除します。

   

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

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

   

関連記事

Note

監査ログを使用して、継承されたプロセスに加えられた変更を確認します。 詳細については、「 アクセス、エクスポート、およびフィルター監査ログを参照してください。

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

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

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