REST Resource: projects.histories.executions.environments

Ressource: Umwelt

Eine Umgebung stellt den Satz von Testläufen (Schritten) der übergeordneten Ausführung dar, die mit denselben Dimensionen (Modell, Version, Gebietsschema und Ausrichtung) konfiguriert sind. Mehrere solcher Ausführungen treten insbesondere aufgrund von Funktionen wie Sharding (Aufteilen einer Testsuite zur parallelen Ausführung auf mehreren Geräten) und Wiederholungen (mehrmaliges Ausführen eines Tests zur Überprüfung auf unterschiedliche Ergebnisse) auf.

JSON-Darstellung
{
  "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)
  }
}
Felder
projectId

string

Nur Ausgabe. Eine Projekt-ID.

historyId

string

Nur Ausgabe. Eine Verlaufs-ID.

executionId

string

Nur Ausgabe. Eine Ausführungs-ID.

environmentId

string

Nur Ausgabe. Eine Umgebungs-ID.

dimensionValue

map (key: string, value: string)

Dimensionswerte, die die Umgebung beschreiben. Dimensionswerte bestehen immer aus „Modell“, „Version“, „Gebietsschema“ und „Ausrichtung“.

  • Als Antwort: immer gesetzt
  • In Anforderung erstellen: immer festlegen
  • In Update-Anfrage: nie gesetzt

Ein Objekt, das eine Liste von "key": value Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

displayName

string

Ein kurzer, für Menschen lesbarer Name, der in der Benutzeroberfläche angezeigt wird. Maximal 100 Zeichen. Beispiel: Nexus 5, API 27.

creationTime

object ( Timestamp )

Nur Ausgabe. Der Zeitpunkt, zu dem die Umgebung erstellt wurde.

completionTime

object ( Timestamp )

Nur Ausgabe. Der Zeitpunkt, zu dem der Umgebungsstatus auf „Abgeschlossen“ gesetzt wurde.

Dieser Wert wird automatisch festgelegt, wenn der Status in COMPLETE übergeht.

shardSummaries[]

object ( ShardSummary )

Nur Ausgabe. Zusammenfassungen von Shards.

Es wird nur ein Shard angezeigt, es sei denn, die Sharding-Funktion ist in TestExecutionService aktiviert.

environmentResult

object ( MergedResult )

Zusammengeführtes Ergebnis der Umgebung.

resultsStorage

object ( ResultsStorage )

Der Speicherort, an dem Ausgabedateien im Benutzer-Bucket gespeichert werden.

ShardSummary

Ergebniszusammenfassung für einen Shard in einer Umgebung.

JSON-Darstellung
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
Felder
runs[]

object ( StepSummary )

Zusammenfassungen der zum Shard gehörenden Schritte.

Wenn flaky_test_attempts über TestExecutionService aktiviert ist, kann mehr als ein Lauf (Schritt) vorhanden sein. Und die Läufe werden nach multistepNumber sortiert.

shardResult

object ( MergedResult )

Zusammengeführtes Ergebnis des Shards.

SchrittZusammenfassung

Dieser Typ hat keine Felder.

Einfache Zusammenfassung eines Schritts innerhalb dieser Ausführung.

MergedResult

Zusammengeführtes Testergebnis für die Umgebung.

Wenn die Umgebung nur einen Schritt hat (keine Wiederholungen oder Shards), ist das zusammengeführte Ergebnis dasselbe wie das Schrittergebnis. Wenn die Umgebung über mehrere Shards und/oder Wiederholungen verfügt, werden die Ergebnisse von Shards und Wiederholungen, die zur gleichen Umgebung gehören, in einem Umgebungsergebnis zusammengeführt.

JSON-Darstellung
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
Felder
state

enum ( State )

Status der Ressource

outcome

object ( Outcome )

Ergebnis der Ressource

testSuiteOverviews[]

object ( TestSuiteOverview )

Das kombinierte und zusammengefasste Ergebnis jeder Testsuite, die als Teil dieser Umgebung ausgeführt wurde.

Kombinieren: Wenn die Testfälle einer Suite in verschiedenen Schritten ausgeführt werden (Sharding), werden die Ergebnisse in einer Übersicht wieder zusammengefügt. (z. B. wenn Shard1 2 Fehler hat und Shard2 1 Fehler hat, ist die Übersichtsfehleranzahl = 3).

Rollup: Wenn Testfälle aus derselben Suite mehrmals ausgeführt werden (flaky), werden die Ergebnisse kombiniert (z. B. wenn testcase1.run1 fehlschlägt, testcase1.run2 erfolgreich ist und sowohl testcase2.run1 als auch testcase2.run2 fehlschlagen, dann ist die Übersicht flakyCount = 1 und failCount = 1).

Ergebnisspeicher

Der Speicher für Testergebnisse.

JSON-Darstellung
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
Felder
resultsStoragePath

object ( FileReference )

Das Stammverzeichnis für Testergebnisse.

xunitXmlFile

object ( FileReference )

Der Pfad zur Xunit-XML-Datei.

Methoden

get

 Ruft eine Umgebung ab.

list

 Listet Umgebungen für eine bestimmte Ausführung auf.
,

Ressource: Umwelt

Eine Umgebung stellt den Satz von Testläufen (Schritten) der übergeordneten Ausführung dar, die mit denselben Dimensionen (Modell, Version, Gebietsschema und Ausrichtung) konfiguriert sind. Mehrere solcher Ausführungen treten insbesondere aufgrund von Funktionen wie Sharding (Aufteilen einer Testsuite zur parallelen Ausführung auf mehreren Geräten) und Wiederholungen (mehrmaliges Ausführen eines Tests zur Überprüfung auf unterschiedliche Ergebnisse) auf.

JSON-Darstellung
{
  "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)
  }
}
Felder
projectId

string

Nur Ausgabe. Eine Projekt-ID.

historyId

string

Nur Ausgabe. Eine Verlaufs-ID.

executionId

string

Nur Ausgabe. Eine Ausführungs-ID.

environmentId

string

Nur Ausgabe. Eine Umgebungs-ID.

dimensionValue

map (key: string, value: string)

Dimensionswerte, die die Umgebung beschreiben. Dimensionswerte bestehen immer aus „Modell“, „Version“, „Gebietsschema“ und „Ausrichtung“.

  • Als Antwort: immer gesetzt
  • In Anforderung erstellen: immer festlegen
  • In Update-Anfrage: nie gesetzt

Ein Objekt, das eine Liste von "key": value Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

displayName

string

Ein kurzer, für Menschen lesbarer Name, der in der Benutzeroberfläche angezeigt wird. Maximal 100 Zeichen. Beispiel: Nexus 5, API 27.

creationTime

object ( Timestamp )

Nur Ausgabe. Der Zeitpunkt, zu dem die Umgebung erstellt wurde.

completionTime

object ( Timestamp )

Nur Ausgabe. Der Zeitpunkt, zu dem der Umgebungsstatus auf „Abgeschlossen“ gesetzt wurde.

Dieser Wert wird automatisch festgelegt, wenn der Status in COMPLETE übergeht.

shardSummaries[]

object ( ShardSummary )

Nur Ausgabe. Zusammenfassungen von Shards.

Es wird nur ein Shard angezeigt, es sei denn, die Sharding-Funktion ist in TestExecutionService aktiviert.

environmentResult

object ( MergedResult )

Zusammengeführtes Ergebnis der Umgebung.

resultsStorage

object ( ResultsStorage )

Der Speicherort, an dem Ausgabedateien im Benutzer-Bucket gespeichert werden.

ShardSummary

Ergebniszusammenfassung für einen Shard in einer Umgebung.

JSON-Darstellung
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
Felder
runs[]

object ( StepSummary )

Zusammenfassungen der zum Shard gehörenden Schritte.

Wenn flaky_test_attempts über TestExecutionService aktiviert ist, kann mehr als ein Lauf (Schritt) vorhanden sein. Und die Läufe werden nach multistepNumber sortiert.

shardResult

object ( MergedResult )

Zusammengeführtes Ergebnis des Shards.

SchrittZusammenfassung

Dieser Typ hat keine Felder.

Einfache Zusammenfassung eines Schritts innerhalb dieser Ausführung.

MergedResult

Zusammengeführtes Testergebnis für die Umgebung.

Wenn die Umgebung nur einen Schritt hat (keine Wiederholungen oder Shards), ist das zusammengeführte Ergebnis dasselbe wie das Schrittergebnis. Wenn die Umgebung über mehrere Shards und/oder Wiederholungen verfügt, werden die Ergebnisse von Shards und Wiederholungen, die zur gleichen Umgebung gehören, in einem Umgebungsergebnis zusammengeführt.

JSON-Darstellung
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
Felder
state

enum ( State )

Status der Ressource

outcome

object ( Outcome )

Ergebnis der Ressource

testSuiteOverviews[]

object ( TestSuiteOverview )

Das kombinierte und zusammengefasste Ergebnis jeder Testsuite, die als Teil dieser Umgebung ausgeführt wurde.

Kombinieren: Wenn die Testfälle einer Suite in verschiedenen Schritten ausgeführt werden (Sharding), werden die Ergebnisse in einer Übersicht wieder zusammengefügt. (z. B. wenn Shard1 2 Fehler hat und Shard2 1 Fehler hat, ist die Übersichtsfehleranzahl = 3).

Rollup: Wenn Testfälle aus derselben Suite mehrmals ausgeführt werden (flaky), werden die Ergebnisse kombiniert (z. B. wenn testcase1.run1 fehlschlägt, testcase1.run2 erfolgreich ist und sowohl testcase2.run1 als auch testcase2.run2 fehlschlagen, dann ist die Übersicht flakyCount = 1 und failCount = 1).

Ergebnisspeicher

Der Speicher für Testergebnisse.

JSON-Darstellung
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
Felder
resultsStoragePath

object ( FileReference )

Das Stammverzeichnis für Testergebnisse.

xunitXmlFile

object ( FileReference )

Der Pfad zur Xunit-XML-Datei.

Methoden

get

 Ruft eine Umgebung ab.

list

 Listet Umgebungen für eine bestimmte Ausführung auf.