親および関連エンティティ
Targetprocess内のエンティティは、複数の親エンティティおよび関連付けられたエンティティを持つことができます。 カスタム数式では、これらのエンティティとそのプロパティへの参照をサポートしています。 ドットを使用してネストされたプロパティにアクセスします。
EntityState.Name
Project.ID最も一般的なエンティティタイプはユーザーストーリーです。 ここでは、ユーザーストーリーレベルのカスタムフィールドで使用されるカスタム数式メトリクスにおいて、親エンティティおよびリンクされたエンティティを参照する方法について説明します。
ユーザーストーリーレベルで親エンティティおよび関連エンティティの基本プロパティにアクセスする方法は以下の通りです。 一部の式は、バグやタスクなどの他のエンティティタイプにも有効です。
| エンティティタイプ | カスタム式 | 結果の種類 | 結果 |
|---|---|---|---|
| ユーザーストーリーのバグ | Feature.Name Feature.ID | テキスト番号 | 親フィーチャーのフィールド |
| ユーザーストーリーのバグ | Feature.Epic.Name Feature.Epic.ID | テキスト番号 | 親エピックのフィールド |
| 割り当て可能なエンティティ Project.Name Project.ID | テキスト番号 | 親プロジェクトのフィールド | |
| 割り当て可能なエンティティ | Project.Program.Name Project.Program.ID | テキスト番号 | 親プログラムのフィールド |
| ユーザーストーリー バグ 機能 エピック Release.Name Release.ID | テキスト番号 | 親リリースのフィールド | |
| ユーザーストーリー バグ タスク | Iteration.Name Iteration.ID | テキスト番号 | 親スプリント（反復）のフィールド |
| ユーザーストーリー バグ タスク | TeamIteration.名前 TeamIteration.ID | テキスト番号 | 親フィールド チーム 反復 |
| 割り当て可能なエンティティ | LinkedTestPlan.名前 LinkedTestPlan.ID | テキスト番号 | リンクされたテスト計画のフィールド |
以下の式を使用して、親エンティティ（機能とエピック）から最も一般的に使用される値とプロパティを継承します。
| エンティティタイプ | カスタム式 | 結果の種類 | 結果 |
|---|---|---|---|
| ユーザーストーリーのバグ | Feature.ID | 数字 (Number) | 親フィーチャーのID |
| ユーザーストーリーのバグ | Feature.Name | テキスト | 親機能名 |
| ユーザーストーリーのバグ | Feature.FieldName Feature.CustomValues.Text("フィールド名") | テキスト* | 親フィーチャーの「フィールド名」というテキストカスタムフィールドの値 |
| ユーザーストーリーのバグ | Feature.FieldName Feature.CustomValues.Number("フィールド名") | 番号* | 親フィーチャの数値カスタムフィールド「フィールド名」の値 |
| ユーザーストーリーのバグ | Feature.BusinessValue.名前 Feature.Priority.Name | テキスト | 親機能のビジネス価値 |
| ユーザーストーリーのバグ | Feature.BusinessValue 重要性 Feature.Priority.Importance | 数字 (Number) | 親機能のビジネス価値の数値的重要性 |
| ユーザーストーリーのバグ | Feature.Epic.ID | 数字 (Number) | 親エピックのID |
| ユーザーストーリーのバグ | Feature.Epic.Name | テキスト | 親エピックの名前 |
| ユーザーストーリーのバグ | Feature.Release.ID | 数字 (Number) | 親フィーチャーのリリースID |
警告： カスタムフィールド値へのアクセス方法は、メトリクスと計算済みカスタムフィールドで異なります。計算済みカスタムフィールドの式でカスタムフィールド「フィールド名」の値を取得するには： FieldName メトリクスの式でカスタムフィールド「フィールド名」の値を取得するには CustomValues ：.Text("フィールド名") CustomValues.Number("フィールド名") CustomValues.Date("フィールド名") CustomValues.Boolean("フィールド名")
階層構造の異なるレベルで親エンティティを参照する方法は以下の通りです：タスクからプログラムまで。
注記: 親エンティティのあらゆるフィールドとプロパティがサポートされています。以下の例では、最も頻繁に使用される.Name プロパティを使用しています。 その他のフィールド、プロパティ、コレクションも数式内で完全にサポートされています。
| エンティティタイプ | カスタム式 |
|---|---|
| ユーザーストーリーのバグ | Feature.Name |
| ユーザーストーリーのバグ | Feature.Epic.Name |
| タスクバグ | UserStory.名前 |
| タスクバグ | UserStory.Feature.Name |
| タスクバグ | UserStory.Feature.Epic.Name |
| 機能 | Epic.Name |
| ユーザーストーリー バグ タスク 機能 エピック リクエスト | Project.Name |
| ユーザーストーリー バグ タスク 機能 エピック リクエスト | Project.Program.Name |