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

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

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

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

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

前提条件

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

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

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

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

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

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

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

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

   

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

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

   

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

   Note

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

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

   

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

   

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

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

   

   Note

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

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

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

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

   

候補リストを追加する

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

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

   

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

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

   

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

   

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

ID フィールドを追加する

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

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

   

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

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

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

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

   

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

   

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

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

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

   

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

   

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

   Note

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

   

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

   

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

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

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

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

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

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

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

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

   

   フィールドを削除するには、プロジェクト コレクション管理者グループのメンバーであるか、アカウントから [削除] フィールドに対する明示的なアクセス許可が付与されている必要があります。

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

   

関連記事

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

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

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