REST Resource: projects.histories.executions.environments

Recurso: Meio Ambiente

Um Ambiente representa o conjunto de execuções de teste (Etapas) da Execução pai que são configuradas com o mesmo conjunto de dimensões (Modelo, Versão, Localidade e Orientação). Várias dessas execuções ocorrem principalmente por causa de recursos como fragmentação (dividir um conjunto de testes para ser executado em paralelo entre dispositivos) e reexecuções (executar um teste várias vezes para verificar resultados diferentes).

Representação 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

Somente saída. Um ID do projeto.

historyId

string

Somente saída. Uma identificação de histórico.

executionId

string

Somente saída. Um ID de execução.

environmentId

string

Somente saída. Um ID de ambiente.

dimensionValue

map (key: string, value: string)

Valores de dimensão que descrevem o ambiente. Os valores de dimensão sempre consistem em "Modelo", "Versão", "Localidade" e "Orientação".

  • Em resposta: sempre definido
  • Na solicitação de criação: sempre definido
  • Na solicitação de atualização: nunca definido

Um objeto que contém uma lista de pares "key": value . Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

displayName

string

Um nome curto e legível para ser exibido na IU. Máximo de 100 caracteres. Por exemplo: Nexus 5, API 27.

creationTime

object ( Timestamp )

Somente saída. A época em que o Meio Ambiente foi criado.

completionTime

object ( Timestamp )

Somente saída. A hora em que o status do ambiente foi definido para ser concluído.

Este valor será definido automaticamente quando o estado passar para COMPLETE.

shardSummaries[]

object ( ShardSummary )

Somente saída. Resumos de fragmentos.

Apenas um fragmento será apresentado, a menos que o recurso de fragmentação esteja habilitado em TestExecutionService.

environmentResult

object ( MergedResult )

Resultado mesclado do ambiente.

resultsStorage

object ( ResultsStorage )

O local onde os arquivos de saída são armazenados no bucket do usuário.

Resumo do fragmento

Resumo dos resultados de um fragmento em um ambiente.

Representação JSON
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
Campos
runs[]

object ( StepSummary )

Resumos das etapas pertencentes ao fragmento.

Com flaky_test_attempts habilitado em TestExecutionService, mais de uma execução (etapa) pode ser apresentada. E as execuções serão classificadas por multistepNumber.

shardResult

object ( MergedResult )

Resultado mesclado do fragmento.

Resumo da etapa

Este tipo não possui campos.

Resumo leve de uma etapa desta execução.

Resultado Mesclado

Resultado do teste mesclado para ambiente.

Se o ambiente tiver apenas uma etapa (sem repetições ou fragmentos), o resultado mesclado será igual ao resultado da etapa. Se o ambiente tiver vários fragmentos e/ou novas execuções, os resultados dos fragmentos e das novas execuções que pertencem ao mesmo ambiente serão mesclados em um resultado de ambiente.

Representação JSON
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
Campos
state

enum ( State )

Estado do recurso

outcome

object ( Outcome )

Resultado do recurso

testSuiteOverviews[]

object ( TestSuiteOverview )

O resultado combinado e acumulado de cada conjunto de testes executado como parte deste ambiente.

Combinação: quando os casos de teste de um conjunto são executados em etapas diferentes (fragmentação), os resultados são somados novamente em uma visão geral. (por exemplo, se o shard1 tiver 2 falhas e o shard2 tiver 1 falha, então a visão geral failedCount = 3).

Rollup: quando os casos de teste do mesmo conjunto são executados várias vezes (instável), os resultados são combinados (por exemplo, se testcase1.run1 falhar, testcase1.run2 for aprovado e ambos testcase2.run1 e testcase2.run2 falharem, a visão geral flakyCount = 1 e falhaCount = 1).

Armazenamento de resultados

O armazenamento para resultados de testes.

Representação JSON
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
Campos
resultsStoragePath

object ( FileReference )

O diretório raiz para resultados de teste.

xunitXmlFile

object ( FileReference )

O caminho para o arquivo XML do Xunit.

Métodos

get

Obtém um ambiente.

list

Lista ambientes para uma determinada execução.
,

Recurso: Meio Ambiente

Um Ambiente representa o conjunto de execuções de teste (Etapas) da Execução pai que são configuradas com o mesmo conjunto de dimensões (Modelo, Versão, Localidade e Orientação). Várias dessas execuções ocorrem principalmente por causa de recursos como fragmentação (dividir um conjunto de testes para ser executado em paralelo entre dispositivos) e reexecuções (executar um teste várias vezes para verificar resultados diferentes).

Representação 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

Somente saída. Um ID do projeto.

historyId

string

Somente saída. Uma identificação de histórico.

executionId

string

Somente saída. Um ID de execução.

environmentId

string

Somente saída. Um ID de ambiente.

dimensionValue

map (key: string, value: string)

Valores de dimensão que descrevem o ambiente. Os valores de dimensão sempre consistem em "Modelo", "Versão", "Localidade" e "Orientação".

  • Em resposta: sempre definido
  • Na solicitação de criação: sempre definido
  • Na solicitação de atualização: nunca definido

Um objeto que contém uma lista de pares "key": value . Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

displayName

string

Um nome curto e legível para ser exibido na IU. Máximo de 100 caracteres. Por exemplo: Nexus 5, API 27.

creationTime

object ( Timestamp )

Somente saída. A época em que o Meio Ambiente foi criado.

completionTime

object ( Timestamp )

Somente saída. A hora em que o status do ambiente foi definido para ser concluído.

Este valor será definido automaticamente quando o estado passar para COMPLETE.

shardSummaries[]

object ( ShardSummary )

Somente saída. Resumos de fragmentos.

Apenas um fragmento será apresentado, a menos que o recurso de fragmentação esteja habilitado em TestExecutionService.

environmentResult

object ( MergedResult )

Resultado mesclado do ambiente.

resultsStorage

object ( ResultsStorage )

O local onde os arquivos de saída são armazenados no bucket do usuário.

Resumo do fragmento

Resumo dos resultados de um fragmento em um ambiente.

Representação JSON
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
Campos
runs[]

object ( StepSummary )

Resumos das etapas pertencentes ao fragmento.

Com flaky_test_attempts habilitado em TestExecutionService, mais de uma execução (etapa) pode ser apresentada. E as execuções serão classificadas por multistepNumber.

shardResult

object ( MergedResult )

Resultado mesclado do fragmento.

Resumo da etapa

Este tipo não possui campos.

Resumo leve de uma etapa desta execução.

Resultado Mesclado

Resultado do teste mesclado para ambiente.

Se o ambiente tiver apenas uma etapa (sem repetições ou fragmentos), o resultado mesclado será igual ao resultado da etapa. Se o ambiente tiver vários fragmentos e/ou novas execuções, os resultados dos fragmentos e das novas execuções que pertencem ao mesmo ambiente serão mesclados em um resultado de ambiente.

Representação JSON
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
Campos
state

enum ( State )

Estado do recurso

outcome

object ( Outcome )

Resultado do recurso

testSuiteOverviews[]

object ( TestSuiteOverview )

O resultado combinado e acumulado de cada conjunto de testes executado como parte deste ambiente.

Combinação: quando os casos de teste de um conjunto são executados em etapas diferentes (fragmentação), os resultados são somados novamente em uma visão geral. (por exemplo, se o shard1 tiver 2 falhas e o shard2 tiver 1 falha, então a visão geral failedCount = 3).

Rollup: quando os casos de teste do mesmo conjunto são executados várias vezes (instável), os resultados são combinados (por exemplo, se testcase1.run1 falhar, testcase1.run2 for aprovado e ambos testcase2.run1 e testcase2.run2 falharem, a visão geral flakyCount = 1 e falhaCount = 1).

Armazenamento de resultados

O armazenamento para resultados de testes.

Representação JSON
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
Campos
resultsStoragePath

object ( FileReference )

O diretório raiz para resultados de teste.

xunitXmlFile

object ( FileReference )

O caminho para o arquivo XML do Xunit.

Métodos

get

Obtém um ambiente.

list

Lista ambientes para uma determinada execução.