作業項目のフィールドと属性を一覧表示する

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

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

Prerequisites

フィールドを一覧表示または確認する

フィールドを一覧表示または確認するには、プロセス モデル—継承、 ホストされた XML、または オンプレミス XML に基づいて、次のいずれかのツールを使用します。 既定のプロセス内で定義されているフィールドのインデックスについては、「作業項目フィールド インデックス」を参照してください。

フィールド データの型と名称

各作業項目の種類は、その種類の作業項目に含まれるフィールドを指定します。 各フィールドには複数の属性があり、その多くはシステム定義で不変です。

次の 3 つの属性でフィールドを定義します。

• データ型: ブール値、倍精度浮動小数点型、整数型、HTML 型、文字列型など、フィールドに入力できるデータの種類を示します。 各データ型の詳細については、「クエリ フィールド、演算子、マクロ」を参照してください。
• 表示名: クエリ句で フィールド を選択するときに使用する、フィールドに割り当てられたわかりやすい名前。 この名前は、作業項目フォームに表示される名前とは異なる場合があります。
• 参照名: WIQL クエリ、improvised 作業項目テンプレート、REST API コマンドの実行、または XML 作業項目の種類の定義を作成するときに使用される識別子。 参照名は永続的であり、一度設定すると変更できません。

各フィールド属性の詳細な説明と、フィールド属性の一覧表示方法については、この記事で後述する「フィールド属性の」および「フィールド属性を一覧表示する」を参照してください。 作業項目の種類 (WIT) と作業項目の概要については、「ユーザー ストーリー、問題、バグ、機能、エピックの追跡」を参照してください。

フィールドとは? フィールド名のしくみ

各 作業項目の種類 には、31 個のシステム フィールドと複数の種類固有のフィールドが含まれています。 作業項目は、プロジェクトの計画と追跡に役立ちます。

各フィールドは、実行する作業に関する特定の情報をキャプチャします。 これらのフィールドに割り当てる値は、作業追跡データ ストアに格納されるため、状態と傾向を決定するクエリを作成できます。

コア システム プロセス—Agile、Basic、Scrum、CMMI—に定義されている各フィールドの説明と使用方法については、「作業項目フィールドのインデックス」を参照してください。

フィールド名

作業項目のフィールド名は、各作業項目フィールドを一意に識別します。 フィールド名が次のガイドラインに従っていることを確認します。

• 一意性: フィールド名は、アカウントまたはプロジェクト コレクション内で一意である必要があります。
• 長さ: フィールド名には、128 文字以下の Unicode 文字を含める必要があります。
• 間隔: フィールド名に先頭または末尾のスペースを含めたり、2 つ以上の連続するスペースを含めることはできません。
• 構成: フィールド名には、少なくとも 1 つの英字を含める必要があります。
• 禁止文字: フィールド名に次の文字を含めることはできません: .,;':~/*|?&"%$!+=()[]'{}<>。

カスタム フィールドは組織レベルまたはコレクション レベルで定義されているため、同じ名前のユーザー設定フィールドを複数のプロセスに追加することはできません。

詳細については、「名前付けの制限と規則」を参照してください。

システム フィールドと定義済みフィールド

作業項目フィールド名は、Azure DevOps 内の各フィールドを一意に識別します。 フィールド名が次のガイドラインに従っていることを確認します。

• 一意性: フィールド名は、アカウントまたはプロジェクト コレクション内で一意である必要があります。
• 長さ: フィールド名には、128 文字以下の Unicode 文字である必要があります。
• 間隔: フィールド名に先頭または末尾のスペースを含めたり、複数の連続するスペースを含めることはできません。
• 構成: フィールド名には、少なくとも 1 つの英字を含める必要があります。
• 禁止文字: フィールド名に次の文字を含めることはできません: .,;':~/*|?&"%$!+=()[]'{}<>。

カスタム フィールドは組織レベルまたはコレクション レベルで定義されているため、同じ名前のユーザー設定フィールドを複数のプロセスに追加することはできません。

詳細については、「名前付けの制限と規則」を参照してください。

カスタム フィールド

カスタム フィールドは組織レベルまたはプロジェクト コレクション レベルで定義されているため、同じ名前のユーザー設定フィールドを複数のプロセスに追加することはできません。

カスタム フィールドを追加するときは、次の制限に注意してください。

• 作業項目の種類あたりの最大フィールド数 (WIT): 64
• プロセスあたりの最大フィールド数: 512

フィールド データ型によって、フィールドに格納できるデータの種類とサイズが決まります。 各フィールドには、プロジェクト コレクション内で定義できる型は 1 つだけであり、異なるプロジェクトと作業項目の種類に共通フィールドを使用できます。

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

詳細については、「名前付けの制限と規則」を参照してください。

フィールドのデータ型を確認する方法

フィールド リストの確認

組織またはコレクションに定義されているフィールドの一覧を確認するには、次の手順に従います。

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

   

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

   

3. フィールドを選択します。

   一覧表示されるフィールドは、組織またはコレクションに対して定義されているすべてのフィールドに対応します。これには、すべてのユーザー設定フィールドとシステム プロセス用に定義されたフィールドが含まれます。

   

   Note

   [フィールド] が表示されない場合は、コレクションでオンプレミス XML プロセスが使われています。 [フィールド] ページは、そのプロセスでサポートされていません。

   各フィールドの説明、使用法、および参照名については、「作業項目フィールドのインデックス」を参照してください。 さらに、「作業項目の種類フィールド - REST APIの一覧表示」を使用してフィールド参照名を取得できます。

作業項目フィールド エクスプローラー

作業項目フィールド エクスプローラー ツールを使って、フィールド属性の割り当てを調べることができます。

作業項目フィールド エクスプローラーにアクセスするには、プロセス エディター ツールをインストールします。 インストールされているバージョンの Visual Studio に基づいて、次のいずれかの拡張機能からプロセス エディター ツールを取得します。

• Visual Studio 2019 & 2022: 現時点では、特定のプロセス テンプレート エディター拡張機能は使用できません。 ただし、任意のテキスト エディターや XML エディターなどの他のツールを使用して、プロセス テンプレートをカスタマイズすることもできます。 また、特定のカスタマイズ (特に継承されたプロセスの場合) には、Azure DevOps Web ポータルを使用することもできます。
• Visual Studio 2017: TFS プロセス テンプレート エディター。 このバージョンのプロセス エディターを使って、古いスタイルの作業項目フォームも変更できます。 これを使って、新しい Web フォームに関連付けられているフォームを編集することはできません。
• Visual Studio 2015: TFS Power Tools。

フィールド属性

作業項目フィールドごとに、変更できない属性と非表示の属性が多数存在します。 次の表は、各属性を示しています。 属性の名前は、フィールド - REST API の取得 を使用して取得するか、作業項目フィールド エクスプローラー (WIFE) ツールで表示するかによって異なります。

フィールドに割り当てられる属性は、使用するプラットフォームとバージョンによって異なります。 たとえば、一部の属性は継承プロセスではサポートされていません。 フィールドの参照名を検索するには、作業項目フィールドのインデックスを確認してください。

フィールド属性の一覧を表示する

https://dev.azure.com/OrganizationName/_apis/wit/fields/FieldReferenceName

https://dev.azure.com/fabrikam/_apis/wit/fields/System.IterationPath

{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://dev.azure.com/mseng/_apis/wit/fields/System.IterationPath"
}

https://{ServerName:Port}/tfs/{Collection}/_apis/wit/fields/FieldReferenceName?api-version={version}

https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1

{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1"
}

witadmin listfields /collection:http://fabrikam:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue  

Field: Microsoft.VSTS.Common.Issue  
Name: Issue  
Type: String  
Reportable As: dimension  
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)  
Indexed: False  

フィールドを追加および変更する

関連コンテンツ