動的なメタデータの使用

テスト ケースに関するメタデータをソース コードに追加できます。

Micro Focus Unit Testing Framework には、mfunit.cpy コピーブック内に、テスト ケースにメタデータを追加するのに使用できる COBOL フィールドがいくつか用意されています。

特定のテスト ケースに関連するメタデータについては、MFU-TC-METADATA-SETUP-PREFIX & test-case-name エントリ ポイント内で COBOL フィールドを設定します (レベル 78 定数を使用できない場合は、代わりに "MFUM_test-case-name" というエントリ ポイント名を使用します)。このエントリ ポイントは、テスト ケースの準備段階で呼び出されます。

テスト スイート内のすべてのテスト ケースに関連するメタデータについては、MFU-GLOBAL-METADATA-PREFIX & program-name エントリ ポイント内で COBOL フィールドを設定します (レベル 78 定数を使用できない場合は、代わりに "MFUGM_program-name" というエントリ ポイント名を使用します)。このエントリ ポイントは、どのテスト ケースよりも先に呼び出されます。

テスト スイートからテスト フィクスチャ ファイル (.mfu ファイル) を生成すると、テスト ケース内および [global] セクションでメタデータを参照できます。

テスト ケース固有メタデータおよびグローバル メタデータのエントリ ポイントを設定するには、次の COBOL フィールドを使用します。

COBOL フィールド 説明 テスト フィクスチャ (.mfu) ファイルのタグ
MFU-MD-TESTCASE-DESCRIPTION テスト ケースの説明 description
MFU-MD-TIMEOUT-IN-MS
テスト ケースを実行する期限 (ミリ秒)。期限が来たら、0 以外の戻りコードが返されます。期限は、3 秒以上に設定する必要があります。
注: テストでタイムアウトを使用する場合は、UNIX プラットフォームでいずれかのスレッド テスト ランナー (cobmfurun32_t または cobmfurun64_t) を使用して実行する必要があります。
timeout
MFU-MD-TRAITS テスト ケースのトレイト。トレイトに基づいてテスト ケースを実行できます。指定したトレイトが割り当てられていないテストは実行時にスキップされます。
ヒント: 必要に応じて、複数のトレイトをカンマで区切って追加できます。
traits
MFU-MD-SKIP-TESTCASE テスト ケースをスキップします。 skipped
MFU-MD-TESTCASE-PRIORITY テスト ケースの優先度を指定します。指定できる値は次のとおりです。
  • MFU-MD-TESTCASE-PRIORITY-HIGH
  • MFU-MD-TESTCASE-PRIORITY-MEDIUM
  • MFU-MD-TESTCASE-PRIORITY-LOW
注: 優先度が指定されていないテスト ケースは、優先度が指定されたすべてのテスト ケースが実行された後に実行されます。
priority
MFU-GLOBAL-COMMANDLINE-ARG テスト実行にテスト ランナーの引数を適用します。このフィールドは、MFU-GLOBAL-COMMANDLINE-PREFIX エントリ ポイントで使用します。
注: このフィールドの長さは 128 文字に制限されます。
various