次の方法で共有


標準的なテスト メタデータ

次のテスト "マークアップ" メタデータは、TAEF テストに適用できる標準的なメタデータです。

暗黙的なメタデータ

メタデータの特定の要素は、テストのマークアップから自動的に推論されます。

  • "Name" - テストの完全修飾名。
  • "Architecture" - DLL のプロセッサ アーキテクチャ。 この値は、'x86'、'x64'、'arm' のいずれかになります。
  • "TestFile" - テストが記述された DLL ファイル。

選択メタデータ

選択メタデータは、あくまで "推奨される" メタデータの一部です。複数のチームが特定の基準を共有して、互いにテストを効果的に利用できるようになります。 必須のメタデータなどというものはありません。メタデータを必須にすると自動化の追加コストが増大します。すべてのメタデータは省略可能とするか、"オプトイン" 動作を有効にしてください。

メタデータ値に複数の値を指定できる場合があります。その場合は、セミコロンで区切られたリストを使用し、"contains" スタイル選択クエリを使用してテストする必要があります。 たとえば、"Owner" メタデータに 2 つの値が必要な場合は、"Someone;SomeoneElse" に設定する必要があります。 Someone が所有するテストのみを選択するクエリは次のようになります。

te Wex.Common.Tests.dll /select:@Owner='Someone'

一方、次のクエリでは、Someone が所有または共同所有しているテストが選択されます。

te Wex.Common.Tests.dll /select:@Owner='*Someone*'

社内で使用する独自のメタデータを定義できます。 以下の提案は推奨事項です。 .

"高推奨度" のメタデータ

これらのメタデータ プロパティは推奨事項であり、明確な意味を持ちます。 必要に応じて使用してください。

"ActivationContext"
システム内のさまざまなサイド バイ サイド アセンブリからのバイナリの特定のバージョンを指定します。 詳細については、「アクティブ化コンテキスト」を参照してください。

"BinaryUnderTest"
特定のテストが "単体" テストで検証されるバイナリ。 これにより、開発者は特定の DLL を検証するすべての単体テストをすばやく実行できます。

"DefaultTestResult"
指定されたテストの "Passed" の既定のテスト結果をオーバーライドします。 テストに合格した場合、ログに記録された結果が既定のテスト結果になります。 指定できる値は、"Passed"、"Failed"、"NotRun"、"Blocked"、"Skipped" です。

"DeploymentItem"
ファイルやフォルダーをテストの依存関係として識別します。

"Description"
テストの内容についての簡単な説明。

"DpiAware"
"true" に設定すると、DPI 対応としてマークされたプロセスでテストが実行されます。「高 DPI」を参照してください。

"ExecutionGroup"
クラス内の一連の連続するテスト。順番に実行する必要があり、実行グループ内の先行するテストが実行されていないか失敗した場合はブロックされます。 詳細については、「実行グループ」を参照してください。

"Ignore"
"Ignore" メタデータが "true" に設定されているテスト クラスまたはテスト メソッドは、TAEF による実行中または一覧表示中にスキップされます。 この動作をオーバーライドし、"Ignore" メタデータが設定されているテストも含め、すべてのテストを実行または一覧表示するには、コマンド ライン引数として /runIgnoredTests を指定します。

"IsolationLevel"
TAEF テストの実行時に使用する分離の最小レベルを指定します。 詳細については、「テストの分離」を参照してください。

"Parallel"
複数のプロセッサ間でテストを並列で実行します。 詳細については、「並列」を参照してください。

"Priority"
テストの優先度。整数で表され、小さいほど優先度が高くなります。

"RebootPossible"
true に設定すると、再起動 API を使用して TAEF にコンピューターの再起動を要求したり、テストによって開始される再起動が差し迫っていることを TAEF に通知したりできるようになります。

"RunAs"
問題のあるテストを実行するコンテキストを指定します。 詳細については、「RunAs 実行」を参照してください。

"RunFixtureAs"
問題のあるテスト フィクスチャを実行するコンテキストを指定します。 詳細については、「RunFixtureAs」を参照してください。

"TestClassification:Scope"
テスト分類の "Scope" は、Windows で発生する "エンジニアリング プロセス イベント" の検証に使用されるテスト資料を識別します。

"TestClassification:Type"
テスト分類の "Type" は、区別する必要があるテストの種類を識別します。

"TestClassification"
Windows 単体テスト ガイドライン (WUTG) に準拠する単体テストを示すには、プロパティ値 "Unit:WUTG" を使用します。 プロパティ値 "Unit:WUTG:ChexGate" を使用して、Windows 単体テスト ガイドライン (WUTG) に準拠し、Chex シナリオのゲート フェーズ (失敗ブロック送信) 中に実行する必要がある単体テストを示します。

"TestTimeout"
特定のテストまたはセットアップ/クリーンアップ メソッドが実行できる最大時間を指定します。 詳細については、タイムアウトに関するページをご覧ください。

"ThreadingModel"
テストで使用される事前構成済みの COM スレッド モデル。 詳細については、「スレッド モデルの構成」を参照してください。

データドリブン テスト関連:

"DataSource"
データドリブン テストに使用するデータのメイン ソースを指定します。

"TableId"
テーブルベースのデータ ドリブン テストの場合に、"DataSource" とは別にテーブルの名前または ID を指定します。

"Pict:Timeout" (および非推奨の "PictTimeout")
PICT ベースのデータドリブン テストの場合に、ユーザー指定のモデル ファイルを処理する時間として PICT.exe に許容された既定のタイムアウトである 5 分をオーバーライドします。

"Pict:SeedingFile" (および非推奨の "Seed")
PICT ベースのデータ ドリブン テストの場合に、シード ファイルの相対位置を "DataSource" とは別に指定します。

"Pict:Order"
PICT ベースのデータ ドリブン テストで呼び出されたときの PICT.exe の /o パラメーターの値を指定します。

"Pict:ValueSeparator"
PICT ベースのデータ ドリブン テストで呼び出されたときの PICT.exe の /d パラメーターの値を指定します。

"Pict:AliasSeparator"
PICT ベースのデータ ドリブン テストで呼び出されたときの PICT.exe の /a パラメーターの値を指定します。

"Pict:NegativeValuePrefix"
PICT ベースのデータ ドリブン テストで呼び出されたときの PICT.exe の /n パラメーターの値を指定します。

"Pict:Random"
PICT ベースのデータ ドリブン テストで PICT.exe を呼び出すときにランダム性を使用するかどうかを指定します。 これが true の場合、使用されたランダム シードが TAEF によってログに記録されます。

"Pict:RandomSeed"
PICT ベースのデータ ドリブン テストで呼び出されたときの PICT.exe の /r パラメーターの値を指定します。 これを設定すると、"Pict:Random" の既定値が false から true に変更されます。

"Pict:CaseSensitive"
PICT ベースのデータ ドリブン テストで呼び出されたときに PICT.exe の /c パラメーターを使用するかどうかを指定します。

デバイス関連のサポート:

"TestResourceDependent"
現在のスコープ内のテストが TestResource に依存し、BuildResourceList(...) によって収集されたリソースで機能することを指定します。詳細については、「デバイスのサポート」を参照してください。

"ResourceSelection"
BuildResourceList(...) によって収集された TestResource のうち、対象のテストに関連するものと一致するクエリを指定します。 詳細については、「デバイスのサポート」を参照してください。

"低推奨度" のメタデータ

これらのメタデータ プロパティは使用できますが、その解釈は保証されません。チームは、必要に応じてそれらを使用できます。

"Owner"
テストの所有者のエイリアス。

"ProcessUnderTest"
ランタイム分析に役立ちます。 たとえば、テストで "Explorer.exe" をテストしている場合は、プロセスに対して Radar (ランタイム分析ツール) を実行します。

"Feature"
テストを特定の機能またはテクノロジに分類する識別子。 これは "Cookie" 識別子として扱われる必要があり、その解釈はそれを定義するチームに委ねられます。

"予約済み" のメタデータ

次のメタデータは、今後使用される可能性があるため、使用しないでください。

  • User
  • IntegrityLevel
  • Timeout
  • HostType