REST Resource: projects.histories.executions.environments

Recurso: Medio Ambiente

Un entorno representa el conjunto de ejecuciones de prueba (pasos) de la ejecución principal que están configuradas con el mismo conjunto de dimensiones (modelo, versión, configuración regional y orientación). Múltiples ejecuciones de este tipo ocurren particularmente debido a características como fragmentación (dividir un conjunto de pruebas para ejecutarlo en paralelo en todos los dispositivos) y reejecuciones (ejecutar una prueba varias veces para verificar diferentes resultados).

Representación 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)
  }
}
Campos
projectId

string

Sólo salida. Una identificación del proyecto.

historyId

string

Sólo salida. Una identificación histórica.

executionId

string

Sólo salida. Una identificación de ejecución.

environmentId

string

Sólo salida. Una identificación del entorno.

dimensionValue

map (key: string, value: string)

Valores de dimensión que describen el entorno. Los valores de dimensión siempre constan de "Modelo", "Versión", "Escala" y "Orientación".

  • En respuesta: siempre configurado
  • En solicitud de creación: siempre configurado
  • En solicitud de actualización: nunca establecido

Un objeto que contiene una lista de pares "key": value . Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

displayName

string

Un nombre breve legible por humanos para mostrar en la interfaz de usuario. Máximo de 100 caracteres. Por ejemplo: Nexus 5, API 27.

creationTime

object ( Timestamp )

Sólo salida. La época en la que se creó el Medio Ambiente.

completionTime

object ( Timestamp )

Sólo salida. La hora a la que se configuró que se completara el estado del entorno.

Este valor se establecerá automáticamente cuando el estado pase a COMPLETO.

shardSummaries[]

object ( ShardSummary )

Sólo salida. Resúmenes de fragmentos.

Solo se presentará un fragmento a menos que la función de fragmentación esté habilitada en TestExecutionService.

environmentResult

object ( MergedResult )

Resultado fusionado del medio ambiente.

resultsStorage

object ( ResultsStorage )

La ubicación donde se almacenan los archivos de salida en el depósito de usuario.

FragmentoResumen

Resumen de resultados para un fragmento en un entorno.

Representación JSON
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
Campos
runs[]

object ( StepSummary )

Resúmenes de los pasos pertenecientes al fragmento.

Con flaky_test_attempts habilitado desde TestExecutionService, se puede presentar más de una ejecución (paso). Y las ejecuciones se ordenarán por número de varios pasos.

shardResult

object ( MergedResult )

Resultado fusionado del fragmento.

Resumen de pasos

Este tipo no tiene campos.

Resumen ligero de un paso dentro de esta ejecución.

Resultado fusionado

Resultado de prueba combinado para el medio ambiente.

Si el entorno tiene solo un paso (sin repeticiones ni fragmentos), entonces el resultado combinado es el mismo que el resultado del paso. Si el entorno tiene varios fragmentos y/o reejecuciones, los resultados de los fragmentos y las reejecuciones que pertenecen al mismo entorno se fusionan en un resultado de entorno.

Representación JSON
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
Campos
state

enum ( State )

Estado del recurso

outcome

object ( Outcome )

Resultado del recurso

testSuiteOverviews[]

object ( TestSuiteOverview )

El resultado combinado y acumulado de cada conjunto de pruebas que se ejecutó como parte de este entorno.

Combinación: cuando los casos de prueba de una suite se ejecutan en diferentes pasos (fragmentación), los resultados se vuelven a sumar en una descripción general. (por ejemplo, si el fragmento 1 tiene 2 fallas y el fragmento 2 tiene 1 falla, la descripción general de fallas = 3).

Resumen: cuando los casos de prueba del mismo conjunto se ejecutan varias veces (inconsistentes), los resultados se combinan (por ejemplo, si testcase1.run1 falla, testcase1.run2 pasa y tanto testcase2.run1 como testcase2.run2 fallan, entonces la descripción general flakyCount = 1 y número de fallos = 1).

Almacenamiento de resultados

El almacenamiento de los resultados de las pruebas.

Representación JSON
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
Campos
resultsStoragePath

object ( FileReference )

El directorio raíz de los resultados de las pruebas.

xunitXmlFile

object ( FileReference )

La ruta al archivo XML de Xunit.

Métodos

get

 Obtiene un entorno.

list

 Enumera los entornos para una ejecución determinada.
,

Recurso: Medio Ambiente

Un entorno representa el conjunto de ejecuciones de prueba (pasos) de la ejecución principal que están configuradas con el mismo conjunto de dimensiones (modelo, versión, configuración regional y orientación). Múltiples ejecuciones de este tipo ocurren particularmente debido a características como fragmentación (dividir un conjunto de pruebas para ejecutarlo en paralelo en todos los dispositivos) y reejecuciones (ejecutar una prueba varias veces para verificar diferentes resultados).

Representación 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)
  }
}
Campos
projectId

string

Sólo salida. Una identificación del proyecto.

historyId

string

Sólo salida. Una identificación histórica.

executionId

string

Sólo salida. Una identificación de ejecución.

environmentId

string

Sólo salida. Una identificación del entorno.

dimensionValue

map (key: string, value: string)

Valores de dimensión que describen el entorno. Los valores de dimensión siempre constan de "Modelo", "Versión", "Escala" y "Orientación".

  • En respuesta: siempre configurado
  • En solicitud de creación: siempre configurado
  • En solicitud de actualización: nunca establecido

Un objeto que contiene una lista de pares "key": value . Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

displayName

string

Un nombre breve legible por humanos para mostrar en la interfaz de usuario. Máximo de 100 caracteres. Por ejemplo: Nexus 5, API 27.

creationTime

object ( Timestamp )

Sólo salida. La época en la que se creó el Medio Ambiente.

completionTime

object ( Timestamp )

Sólo salida. La hora a la que se configuró que se completara el estado del entorno.

Este valor se establecerá automáticamente cuando el estado pase a COMPLETO.

shardSummaries[]

object ( ShardSummary )

Sólo salida. Resúmenes de fragmentos.

Solo se presentará un fragmento a menos que la función de fragmentación esté habilitada en TestExecutionService.

environmentResult

object ( MergedResult )

Resultado fusionado del medio ambiente.

resultsStorage

object ( ResultsStorage )

La ubicación donde se almacenan los archivos de salida en el depósito de usuario.

FragmentoResumen

Resumen de resultados para un fragmento en un entorno.

Representación JSON
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
Campos
runs[]

object ( StepSummary )

Resúmenes de los pasos pertenecientes al fragmento.

Con flaky_test_attempts habilitado desde TestExecutionService, se puede presentar más de una ejecución (paso). Y las ejecuciones se ordenarán por número de varios pasos.

shardResult

object ( MergedResult )

Resultado fusionado del fragmento.

Resumen de pasos

Este tipo no tiene campos.

Resumen ligero de un paso dentro de esta ejecución.

Resultado fusionado

Resultado de prueba combinado para el medio ambiente.

Si el entorno tiene solo un paso (sin repeticiones ni fragmentos), entonces el resultado combinado es el mismo que el resultado del paso. Si el entorno tiene varios fragmentos y/o reejecuciones, los resultados de los fragmentos y las reejecuciones que pertenecen al mismo entorno se fusionan en un resultado de entorno.

Representación JSON
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
Campos
state

enum ( State )

Estado del recurso

outcome

object ( Outcome )

Resultado del recurso

testSuiteOverviews[]

object ( TestSuiteOverview )

El resultado combinado y acumulado de cada conjunto de pruebas que se ejecutó como parte de este entorno.

Combinación: cuando los casos de prueba de una suite se ejecutan en diferentes pasos (fragmentación), los resultados se vuelven a sumar en una descripción general. (por ejemplo, si el fragmento 1 tiene 2 fallas y el fragmento 2 tiene 1 falla, la descripción general de fallas = 3).

Resumen: cuando los casos de prueba del mismo conjunto se ejecutan varias veces (inconsistentes), los resultados se combinan (por ejemplo, si testcase1.run1 falla, testcase1.run2 pasa y tanto testcase2.run1 como testcase2.run2 fallan, entonces la descripción general flakyCount = 1 y número de fallos = 1).

Almacenamiento de resultados

El almacenamiento de los resultados de las pruebas.

Representación JSON
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
Campos
resultsStoragePath

object ( FileReference )

El directorio raíz de los resultados de las pruebas.

xunitXmlFile

object ( FileReference )

La ruta al archivo XML de Xunit.

Métodos

get

 Obtiene un entorno.

list

 Enumera los entornos para una ejecución determinada.