REST Resource: projects.histories.executions.environments

リソース: 環境

環境は、同じディメンションのセット (モデル、バージョン、ロケール、方向) で構成された親実行からのテスト実行のセット (ステップ) を表します。このような複数の実行は、特にシャーディング (デバイス間で並行して実行するためにテスト スイートを分割する) や再実行 (異なる結果を確認するためにテストを複数回実行する) などの機能が原因で発生します。

JSON表現
{
  "projectId": string,
  "historyId": string,
  "executionId": string,
  "environmentId": string,
  "dimensionValue": {
    string: string,
    ...
  },
  "displayName": string,
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "shardSummaries": [
    {
      object (ShardSummary)
    }
  ],
  "environmentResult": {
    object (MergedResult)
  },
  "resultsStorage": {
    object (ResultsStorage)
  }
}
田畑
projectId

string

出力のみ。プロジェクト ID。

historyId

string

出力のみ。履歴ID。

executionId

string

出力のみ。実行ID。

environmentId

string

出力のみ。環境 ID。

dimensionValue

map (key: string, value: string)

環境を説明するディメンション値。ディメンション値は常に「モデル」、「バージョン」、「ロケール」、および「方向」で構成されます。

  • 応答: 常に設定
  • 作成リクエストでは: 常に設定されます
  • 更新リクエスト時: 設定しない

"key": valueペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" } 。

displayName

string

UI に表示される人間が判読できる短い名前。最大 100 文字。例: Nexus 5、API 27。

creationTime

object ( Timestamp )

出力のみ。環境が作成された時刻。

completionTime

object ( Timestamp )

出力のみ。環境ステータスが完了に設定された時刻。

この値は、状態が COMPLETE に移行すると自動的に設定されます。

shardSummaries[]

object ( ShardSummary )

出力のみ。シャードの概要。

TestExecutionService でシャーディング機能が有効になっていない限り、シャードは 1 つだけ存在します。

environmentResult

object ( MergedResult )

環境のマージ結果。

resultsStorage

object ( ResultsStorage )

ユーザーバケット内の出力ファイルが保存される場所。

シャード概要

環境内のシャードの結果の概要。

JSON表現
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
田畑
runs[]

object ( StepSummary )

シャードに属するステップの概要。

TestExecutionService から flaky_test_attempts を有効にすると、複数の実行 (ステップ) が存在する可能性があります。そして、実行は multistepNumber によって並べ替えられます。

shardResult

object ( MergedResult )

シャードのマージ結果。

ステップの概要

このタイプにはフィールドがありません。

この実行内のステップの簡単な概要。

マージ結果

環境のテスト結果を統合しました。

環境にステップが 1 つしかない場合 (再実行やシャードがない場合)、マージされた結果はステップの結果と同じになります。環境に複数のシャードや再実行がある場合、同じ環境に属するシャードと再実行の結果は 1 つの環境結果にマージされます。

JSON表現
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
田畑
state

enum ( State )

リソースの状態

outcome

object ( Outcome )

リソースの成果

testSuiteOverviews[]

object ( TestSuiteOverview )

この環境の一部として実行された各テスト スイートの結合およびロールアップされた結果。

結合: スイートからのテスト ケースが異なるステップ (シャーディング) で実行されると、結果が 1 つの概要に再び追加されます。 (たとえば、shard1 に 2 つの障害があり、shard2 に 1 つの障害がある場合、概要よりも FailureCount = 3)。

ロールアップ: 同じスイートのテスト ケースが複数回 (不安定な) 実行されると、結果が結合されます (たとえば、testcase1.run1 が失敗し、testcase1.run2 が成功し、testcase2.run1 と testcase2.run2 の両方が失敗した場合、概要は flakyCount = 1 および FailureCount = 1)。

結果ストレージ

テスト結果のストレージ。

JSON表現
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
田畑
resultsStoragePath

object ( FileReference )

テスト結果のルート ディレクトリ。

xunitXmlFile

object ( FileReference )

Xunit XML ファイルへのパス。

メソッド

get

環境を取得します。

list

特定の実行の環境をリストします。
、

リソース: 環境

環境は、同じディメンションのセット (モデル、バージョン、ロケール、方向) で構成された親実行からのテスト実行のセット (ステップ) を表します。このような複数の実行は、特にシャーディング (デバイス間で並行して実行するためにテスト スイートを分割する) や再実行 (異なる結果を確認するためにテストを複数回実行する) などの機能が原因で発生します。

JSON表現
{
  "projectId": string,
  "historyId": string,
  "executionId": string,
  "environmentId": string,
  "dimensionValue": {
    string: string,
    ...
  },
  "displayName": string,
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "shardSummaries": [
    {
      object (ShardSummary)
    }
  ],
  "environmentResult": {
    object (MergedResult)
  },
  "resultsStorage": {
    object (ResultsStorage)
  }
}
田畑
projectId

string

出力のみ。プロジェクト ID。

historyId

string

出力のみ。履歴ID。

executionId

string

出力のみ。実行ID。

environmentId

string

出力のみ。環境 ID。

dimensionValue

map (key: string, value: string)

環境を説明するディメンション値。ディメンション値は常に「モデル」、「バージョン」、「ロケール」、および「方向」で構成されます。

  • 応答: 常に設定
  • 作成リクエストでは: 常に設定されます
  • 更新リクエスト時: 設定しない

"key": valueペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" } 。

displayName

string

UI に表示される人間が判読できる短い名前。最大 100 文字。例: Nexus 5、API 27。

creationTime

object ( Timestamp )

出力のみ。環境が作成された時刻。

completionTime

object ( Timestamp )

出力のみ。環境ステータスが完了に設定された時刻。

この値は、状態が COMPLETE に移行すると自動的に設定されます。

shardSummaries[]

object ( ShardSummary )

出力のみ。シャードの概要。

TestExecutionService でシャーディング機能が有効になっていない限り、シャードは 1 つだけ存在します。

environmentResult

object ( MergedResult )

環境のマージ結果。

resultsStorage

object ( ResultsStorage )

ユーザーバケット内の出力ファイルが保存される場所。

シャード概要

環境内のシャードの結果の概要。

JSON表現
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
田畑
runs[]

object ( StepSummary )

シャードに属するステップの概要。

TestExecutionService から flaky_test_attempts を有効にすると、複数の実行 (ステップ) が存在する可能性があります。そして、実行は multistepNumber によって並べ替えられます。

shardResult

object ( MergedResult )

シャードのマージ結果。

ステップの概要

このタイプにはフィールドがありません。

この実行内のステップの簡単な概要。

マージ結果

環境のテスト結果を統合しました。

環境にステップが 1 つしかない場合 (再実行やシャードがない場合)、マージされた結果はステップの結果と同じになります。環境に複数のシャードや再実行がある場合、同じ環境に属するシャードと再実行の結果は 1 つの環境結果にマージされます。

JSON表現
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
田畑
state

enum ( State )

リソースの状態

outcome

object ( Outcome )

リソースの成果

testSuiteOverviews[]

object ( TestSuiteOverview )

この環境の一部として実行された各テスト スイートの結合およびロールアップされた結果。

結合: スイートからのテスト ケースが異なるステップ (シャーディング) で実行されると、結果が 1 つの概要に再び追加されます。 (たとえば、shard1 に 2 つの障害があり、shard2 に 1 つの障害がある場合、概要よりも FailureCount = 3)。

ロールアップ: 同じスイートのテスト ケースが複数回 (不安定な) 実行されると、結果が結合されます (たとえば、testcase1.run1 が失敗し、testcase1.run2 が成功し、testcase2.run1 と testcase2.run2 の両方が失敗した場合、概要は flakyCount = 1 および FailureCount = 1)。

結果ストレージ

テスト結果のストレージ。

JSON表現
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
田畑
resultsStoragePath

object ( FileReference )

テスト結果のルート ディレクトリ。

xunitXmlFile

object ( FileReference )

Xunit XML ファイルへのパス。

メソッド

get

環境を取得します。

list

特定の実行の環境をリストします。