REST Resource: projects.histories.executions.environments

Ressource : Environnement

Un environnement représente l'ensemble des exécutions de tests (étapes) de l'exécution parent qui sont configurées avec le même ensemble de dimensions (modèle, version, paramètres régionaux et orientation). De telles exécutions se produisent en particulier en raison de fonctionnalités telles que le partitionnement (diviser une suite de tests pour l'exécuter en parallèle sur plusieurs appareils) et les réexécutions (exécuter un test plusieurs fois pour vérifier différents résultats).

Représentation 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)
  }
}
Des champs
projectId

string

Sortie uniquement. Un identifiant de projet.

historyId

string

Sortie uniquement. Un identifiant d'historique.

executionId

string

Sortie uniquement. Un identifiant d’exécution.

environmentId

string

Sortie uniquement. Un identifiant d’environnement.

dimensionValue

map (key: string, value: string)

Valeurs dimensionnelles décrivant l’environnement. Les valeurs de dimension sont toujours constituées de « Modèle », « Version », « Paramètres régionaux » et « Orientation ».

  • En réponse : toujours défini
  • Dans la demande de création : toujours défini
  • Dans la demande de mise à jour : jamais défini

Un objet contenant une liste de paires "key": value . Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" } .

displayName

string

Un nom court et lisible par l'homme à afficher dans l'interface utilisateur. Maximum de 100 caractères. Par exemple : Nexus 5, API 27.

creationTime

object ( Timestamp )

Sortie uniquement. L'époque à laquelle l'Environnement a été créé.

completionTime

object ( Timestamp )

Sortie uniquement. Heure à laquelle l'état de l'environnement a été défini pour se terminer.

Cette valeur sera définie automatiquement lorsque l’état passe à COMPLETE.

shardSummaries[]

object ( ShardSummary )

Sortie uniquement. Résumés des fragments.

Un seul fragment sera présenté à moins que la fonctionnalité de partitionnement ne soit activée dans TestExecutionService.

environmentResult

object ( MergedResult )

Résultat fusionné de l'environnement.

resultsStorage

object ( ResultsStorage )

Emplacement où les fichiers de sortie sont stockés dans le compartiment utilisateur.

Résumé du fragment

Résumé des résultats pour une partition dans un environnement.

Représentation JSON
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
Des champs
runs[]

object ( StepSummary )

Résumés des étapes appartenant au fragment.

Avec flaky_test_attempts activé depuis TestExecutionService, plusieurs exécutions (étapes) peuvent être présentées. Et les exécutions seront triées par multistepNumber.

shardResult

object ( MergedResult )

Résultat fusionné du fragment.

Résumé de l'étape

Ce type n'a pas de champs.

Résumé léger d'une étape de cette exécution.

Résultat fusionné

Résultat du test fusionné pour l'environnement.

Si l'environnement ne comporte qu'une seule étape (pas de réexécutions ni de fragments), le résultat fusionné est le même que le résultat de l'étape. Si l'environnement comporte plusieurs fragments et/ou réexécutions, les résultats des fragments et des réexécutions appartenant au même environnement sont fusionnés en un seul résultat d'environnement.

Représentation JSON
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
Des champs
state

enum ( State )

État de la ressource

outcome

object ( Outcome )

Résultat de la ressource

testSuiteOverviews[]

object ( TestSuiteOverview )

Résultat combiné et cumulé de chaque suite de tests exécutée dans le cadre de cet environnement.

Combinaison : lorsque les cas de test d'une suite sont exécutés en différentes étapes (sharding), les résultats sont additionnés dans un seul aperçu. (par exemple, si shard1 a 2 échecs et shard2 a 1 échec, alors l'aperçu FailureCount = 3).

Cumul : lorsque les cas de test de la même suite sont exécutés plusieurs fois (flaky), les résultats sont combinés (par exemple, si testcase1.run1 échoue, testcase1.run2 réussit et que testcase2.run1 et testcase2.run2 échouent, alors l'aperçu flakyCount = 1 et FailureCount = 1).

RésultatsStockage

Le stockage des résultats des tests.

Représentation JSON
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
Des champs
resultsStoragePath

object ( FileReference )

Le répertoire racine des résultats des tests.

xunitXmlFile

object ( FileReference )

Le chemin d'accès au fichier XML Xunit.

Méthodes

get

 Obtient un environnement.

list

 Répertorie les environnements pour une exécution donnée.
,

Ressource : Environnement

Un environnement représente l'ensemble des exécutions de tests (étapes) de l'exécution parent qui sont configurées avec le même ensemble de dimensions (modèle, version, paramètres régionaux et orientation). De telles exécutions se produisent en particulier en raison de fonctionnalités telles que le partitionnement (diviser une suite de tests pour l'exécuter en parallèle sur plusieurs appareils) et les réexécutions (exécuter un test plusieurs fois pour vérifier différents résultats).

Représentation 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)
  }
}
Des champs
projectId

string

Sortie uniquement. Un identifiant de projet.

historyId

string

Sortie uniquement. Un identifiant d'historique.

executionId

string

Sortie uniquement. Un identifiant d’exécution.

environmentId

string

Sortie uniquement. Un identifiant d’environnement.

dimensionValue

map (key: string, value: string)

Valeurs dimensionnelles décrivant l’environnement. Les valeurs de dimension sont toujours constituées de « Modèle », « Version », « Paramètres régionaux » et « Orientation ».

  • En réponse : toujours défini
  • Dans la demande de création : toujours défini
  • Dans la demande de mise à jour : jamais défini

Un objet contenant une liste de paires "key": value . Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" } .

displayName

string

Un nom court et lisible par l'homme à afficher dans l'interface utilisateur. Maximum de 100 caractères. Par exemple : Nexus 5, API 27.

creationTime

object ( Timestamp )

Sortie uniquement. L'époque à laquelle l'Environnement a été créé.

completionTime

object ( Timestamp )

Sortie uniquement. Heure à laquelle l'état de l'environnement a été défini pour se terminer.

Cette valeur sera définie automatiquement lorsque l’état passe à COMPLETE.

shardSummaries[]

object ( ShardSummary )

Sortie uniquement. Résumés des fragments.

Un seul fragment sera présenté à moins que la fonctionnalité de partitionnement ne soit activée dans TestExecutionService.

environmentResult

object ( MergedResult )

Résultat fusionné de l'environnement.

resultsStorage

object ( ResultsStorage )

Emplacement où les fichiers de sortie sont stockés dans le compartiment utilisateur.

Résumé du fragment

Résumé des résultats pour une partition dans un environnement.

Représentation JSON
{
  "runs": [
    {
      object (StepSummary)
    }
  ],
  "shardResult": {
    object (MergedResult)
  }
}
Des champs
runs[]

object ( StepSummary )

Résumés des étapes appartenant au fragment.

Avec flaky_test_attempts activé depuis TestExecutionService, plusieurs exécutions (étapes) peuvent être présentées. Et les exécutions seront triées par multistepNumber.

shardResult

object ( MergedResult )

Résultat fusionné du fragment.

Résumé de l'étape

Ce type n'a pas de champs.

Résumé léger d'une étape de cette exécution.

Résultat fusionné

Résultat du test fusionné pour l'environnement.

Si l'environnement ne comporte qu'une seule étape (pas de réexécutions ni de fragments), le résultat fusionné est le même que le résultat de l'étape. Si l'environnement comporte plusieurs fragments et/ou réexécutions, les résultats des fragments et des réexécutions appartenant au même environnement sont fusionnés en un seul résultat d'environnement.

Représentation JSON
{
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ]
}
Des champs
state

enum ( State )

État de la ressource

outcome

object ( Outcome )

Résultat de la ressource

testSuiteOverviews[]

object ( TestSuiteOverview )

Résultat combiné et cumulé de chaque suite de tests exécutée dans le cadre de cet environnement.

Combinaison : lorsque les cas de test d'une suite sont exécutés en différentes étapes (sharding), les résultats sont additionnés dans un seul aperçu. (par exemple, si shard1 a 2 échecs et shard2 a 1 échec, alors l'aperçu FailureCount = 3).

Cumul : lorsque les cas de test de la même suite sont exécutés plusieurs fois (flaky), les résultats sont combinés (par exemple, si testcase1.run1 échoue, testcase1.run2 réussit et que testcase2.run1 et testcase2.run2 échouent, alors l'aperçu flakyCount = 1 et FailureCount = 1).

RésultatsStockage

Le stockage des résultats des tests.

Représentation JSON
{
  "resultsStoragePath": {
    object (FileReference)
  },
  "xunitXmlFile": {
    object (FileReference)
  }
}
Des champs
resultsStoragePath

object ( FileReference )

Le répertoire racine des résultats des tests.

xunitXmlFile

object ( FileReference )

Le chemin d'accès au fichier XML Xunit.

Méthodes

get

 Obtient un environnement.

list

 Répertorie les environnements pour une exécution donnée.