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

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

カスタム フィールドを追加するか、 継承フィールドの特定の属性を変更することで、作業追跡システムをカスタマイズできます。 たとえば、ユーザー設定フィールドを追加して他のデータをキャプチャしたり、継承されたフィールドの作業項目フォームに表示されるラベルを変更したりできます。

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

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

前提条件

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

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

カスタム フィールド名

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

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

フィールドを追加し、表示するグループとページを指定できます。 フィールドを追加した後、フィールドをページ内にドラッグ アンド ドロップして、フォーム上の配置を調整できます。 カスタム ページまたはグループに複数のフィールドを追加する場合は、フィールドを追加する前に 、まずそれらのページまたはグループを作成 します。

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

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

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

   

   [新しい] フィールドやその他のオプションが無効になっている場合、プロセスを編集するために必要なアクセス許可はありません。

2. WIT を選択して、[新しいフィールド] を選択します。

   

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

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

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

   

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

   

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

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

   

   注

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

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

7. 変更が完了したら、カスタマイズした種類の作業項目を開いて更新プログラムを確認します。

   次の例は、[顧客チケット] フィールドが [状態] グループに正常に追加されたことを示しています。 変更がすぐに表示されない場合は、ブラウザーを更新して、更新プログラムが正しく表示されるようにします。 この手順により、新しいフィールドが作業項目フォームに適切に統合され、使用できる状態になります。

   

候補リストを追加する

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

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

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

   

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

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

   

2. (省略可能) 必須または既定値 を指定し、 フィールドがフォームに表示される場所を選択します。

   

ID フィールドを追加する

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

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

(省略可能) 必須または既定値 を指定し、 フィールドがフォームに表示される場所を選択します。

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

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

2. 種類として [テキスト (複数行)] を選択します。 ここでは、このフィールドに「Customer request」とラベルを付け、製品機能リクエストに関する顧客コメントを取り込みます。

   

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

   

4. (省略可能) 必須または既定値 を指定し、 フィールドがフォームに表示される場所を選択します。

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

1. WIT を選択して、フィールドを追加し、新しいフィールドを選びます。

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

   

3. (省略可能) [オプション] を選択し、フィールドが必要かどうかを指定します。

   

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

   注

   このフィールドは、作業項目フォームのチェック ボックスとして表示されます。 チェックボックスをオンにすると真の値が示されます。 フィールドがボードまたはタスクボードに表示される場合、 True と False の値はチェック ボックスではなくテキストとして表示されます。

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

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

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

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

(省略可能) 必須または既定値 を指定し、 フィールドがフォームに表示される場所を選択します。

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

フィールドの名前変更や型の変更はサポートされていません。 ただし、[ レイアウト ] タブから作業項目フォームに表示されるラベルを変更できます。クエリを作成するときは、ラベルではなくフィールド名を使用します。

次の例では、[ 顧客チケット ] フィールドに チケット番号のラベルを変更します。

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

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

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

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

   

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

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

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

   

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

   

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

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

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

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

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

フィールドを削除すると、履歴値を含め、関連付けられているすべてのデータが削除されます。 データ消去ジョブが開始されるまでに、少し時間がかかる場合があります。 この間、フィールドの復元と、フィールド の更新 REST API を使用してそのデータの回復を試みることができます。 残りのデータによっては、復旧が完全、部分的、または失敗する可能性があります。 回復が常に可能または完了するとは限らないので、フィールドを削除する場合は注意が必要です。

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

ユーザー設定フィールドを削除するには、次の手順を実行します。

1. 組織設定>プロセス>フィールド>その他の操作>削除 を選択します。

   

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

2. 次の例に示すようにフィールドの名前を入力し、[ 作業項目の削除] フィールドを選択して確認します。

   

関連コンテンツ

• 作業項目のフィールドと属性
• 「作業項目の種類の追加または変更」を参照してください。
• Web レイアウトをカスタマイズする
• 作業の追跡、処理、およびプロジェクトの制限