UIP TM の結果

uip tm result では、実行成果物が構造化された CI に適した形式でダウンロードされます。現在では、JUnit XMLファイル(ほとんどのCIテスト・ダッシュボード(Azure DevOps、Jenkins、GitLab、CircleCI)で消費される共通語)を書き込む動詞が1つある。

概要

uip tm result download --execution-id <uuid> (--project-key <key> | --test-set-key <key>) [--result-path <path>]

すべての動詞は、 グローバルオプション と標準 終了コードを尊重します。すべての動詞は -t, --tenant <name> と --log-level <level> を受け入れます(デフォルト Information)。

uip tm の結果のダウンロード

単一のテスト実行の結果をJUnit XMLレポートとしてダウンロードします。このコマンドは、以下のとおりです。

1. 実行の統計情報、テスト セット名、テスト セット ID を取得します。
2. 実行に添付されたすべてのテスト ケース ログをページングする
3. ログごとに、アサーションごとの成果物を並列にフェッチします (アサーションの検索の失敗はログに記録されてスキップされ、致命的ではありません)。
4. テスト セットのパッケージ リストを取得します (ベストエフォート — 不足しているパッケージは警告なしに省略されます)。
5. すべてをJUnit XMLとして直列化し、 --result-pathに書き込みます。

XML 内の [リンク] フィールドと [Web-URL] フィールドは、現在のセッションの組織スラグとテナント名を使用して Test Manager Web UI に戻ります。

引数

設定はありません。

オプション

• --execution-id <uuid> (必須) — ダウンロードする実行。
• --project-key <key> — 所有プロジェクト。これまたは --test-set-key が必要です。
• --test-set-key <key> — テスト セット キー (例:DEMO:42);プロジェクト キーはプレフィックスから派生します。
• --result-path <path> — 出力場所。ファイル (./junit.xml) またはディレクトリ (ファイル名はテスト セットにちなんで付けられます) を指定できます。デフォルトは、現在の作業ディレクトリです。

例

uip tm result download \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO \
  --result-path ./junit.xml

データシェイプ

{
  "Code": "ResultDownload",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Format": "junit",
    "OutputPath": "./junit.xml",
    "TotalTests": 10,
    "Passed": 8,
    "Failed": 2,
    "Cancelled": 0
  }
}

実際のJUnit XMLは OutputPathに書き込まれます。JSON エンベロープでは、成功とサマリー数のみが報告されます。

注:

出力形式は、現在 JUnit XML に固定されています。Format はエンベロープに含まれているため、将来のバージョンでは、形状を破壊的に変更することなく、より多くの形式 (NUnit や TRX など) を追加できます。

CI で出力を使用する

CI が提供する test-reporter タスクを含む XML ファイルを公開します。典型的なパターン:

# Azure DevOps
- task: PublishTestResults@2
  inputs:
    testResultsFormat: JUnit
    testResultsFiles: junit.xml

# GitHub Actions (via a community action)
- uses: dorny/test-reporter@v1
  with:
    name: Test Manager
    path: junit.xml
    reporter: java-junit

関連

• testsets run — ここで消費される ExecutionId を生成します。
• 待機 — 実行が終了ステートになるまでブロックしてから結果をダウンロードします。
• report - JUnit XMLが不要な場合は、人間が読める要約(同じデータ、異なる形状)。
• 添付ファイル — スクリーンショット、ログ、およびテスト ケース ログで生成されたファイルをダウンロードします。

参照

• Test Manager の概要
• スクリプト パターン