REST Resource: projects.histories.executions.steps

{
  "stepId": string,
  "creationTime": {
    object (Timestamp)
  },
  "completionTime": {
    object (Timestamp)
  },
  "name": string,
  "description": string,
  "state": enum (State),
  "outcome": {
    object (Outcome)
  },
  "hasImages": boolean,
  "labels": {
    string: string,
    ...
  },
  "dimensionValue": {
    string: string,
    ...
  },
  "runDuration": {
    object (Duration)
  },
  "deviceUsageDuration": {
    object (Duration)
  },
  "multiStep": {
    object (MultiStep)
  },

  // Union field step can be only one of the following:
  "testExecutionStep": {
    object (TestExecutionStep)
  },
  "toolExecutionStep": {
    object (ToolExecutionStep)
  }
  // End of list of possible types for union field step.
}

string

Um identificador exclusivo em uma execução para esta etapa.

Retorna INVALID_ARGUMENT se este campo for definido ou substituído pelo chamador.

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

object ( Timestamp )

A hora em que a etapa foi criada.

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

object ( Timestamp )

A hora em que o status da etapa foi definido como concluído.

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

• Em resposta: defina se o estado de execução for COMPLETO.
• Na solicitação de criação/atualização: nunca definir

string

Um nome curto legível por humanos para exibir na IU. Máximo de 100 caracteres. Por exemplo: compilação limpa

Um PRECONDITION_FAILED será retornado ao criar uma nova etapa se ela compartilhar seu nome e dimensionValue com uma etapa existente. Se duas etapas representam uma ação semelhante, mas possuem valores de dimensão diferentes, elas devem compartilhar o mesmo nome. Por exemplo, se o mesmo conjunto de testes for executado em duas plataformas diferentes, as duas etapas devem ter o mesmo nome.

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

string

Uma descrição desta ferramenta Por exemplo: mvn clean package -D skipTests=true

• Em resposta: presente se definido pela solicitação de criação/atualização
• Na solicitação de criação/atualização: opcional

enum ( State )

O estado inicial é IN_PROGRESS. As únicas transições de estado legais são * IN_PROGRESS -> COMPLETE

Um PRECONDITION_FAILED será retornado se uma transição inválida for solicitada.

É válido criar a Etapa com o estado definido como COMPLETO. O estado só pode ser definido como COMPLETE uma vez. Um PRECONDITION_FAILED será retornado se o estado for definido como COMPLETE várias vezes.

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

object ( Outcome )

Classificação do resultado, por exemplo em SUCESSO ou FALHA

• Em resposta: presente se definido pela solicitação de criação/atualização
• Na solicitação de criação/atualização: opcional

boolean

Se alguma das saídas desta etapa são imagens cujas miniaturas podem ser obtidas com thumbnails.list.

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

map (key: string, value: string)

Pares arbitrários de chave/valor fornecidos pelo usuário associados à etapa.

Os usuários são responsáveis ​​por gerenciar o namespace da chave de modo que as chaves não colidam acidentalmente.

Um INVALID_ARGUMENT será retornado se o número de rótulos exceder 100 ou se o comprimento de qualquer uma das chaves ou valores exceder 100 caracteres.

• Em resposta: sempre definido
• Na solicitação de criação: opcional
• No pedido de atualização: opcional; qualquer novo par chave/valor será adicionado ao mapa, e qualquer novo valor para uma chave existente atualizará o valor dessa chave

Um objeto contendo uma lista de "key": value . Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

map (key: string, value: string)

Se a execução que contém esta etapa tiver qualquer conjunto dimension_definition, esse campo permitirá que o filho especifique os valores das dimensões.

As chaves devem corresponder exatamente à dimension_definition da execução.

Por exemplo, se a execução tiver dimension_definition = ['attempt', 'device'] então uma etapa deve definir valores para essas dimensões, por exemplo. dimensionValue = ['attempt': '1', 'device': 'Nexus 6']

Se uma etapa não participa de uma dimensão da matriz, o valor dessa dimensão deve ser uma string vazia. Por exemplo, se um dos testes for executado por um executor que não suporta novas tentativas, a etapa pode ter dimensionValue = ['attempt': '', 'device': 'Nexus 6']

Se a etapa não participar de nenhuma dimensão da matriz, ela pode deixar dimensionValue sem definição.

Um PRECONDITION_FAILED será retornado se alguma das chaves não existir na dimension_definition da execução.

Um PRECONDITION_FAILED será retornado se outra etapa nesta execução já tiver o mesmo nome e dimensionValue, mas diferir em outros campos de dados, por exemplo, o campo da etapa é diferente.

Um PRECONDITION_FAILED será retornado se dimensionValue for definido e houver uma dimension_definition na execução que não seja especificada como uma das chaves.

• Em resposta: presente se definido por criar
• Na solicitação de criação: opcional
• Na solicitação de atualização: nunca definido

Um objeto contendo uma lista de "key": value . Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

object ( Duration )

Quanto tempo levou para esta etapa ser executada.

Se não for definido, será definido como a diferença entre CreationTime e CompletionTime quando a etapa for definida como o estado COMPLETE. Em alguns casos, é apropriado definir este valor separadamente: Por exemplo, se uma etapa é criada, mas a operação que ela representa fica na fila por alguns minutos antes de ser executada, seria apropriado não incluir o tempo gasto na fila em sua runDuration.

PRECONDITION_FAILED será retornado se alguém tentar definir um runDuration em uma etapa que já tenha esse campo definido.

• Em resposta: presente se previamente definido; sempre presente na etapa COMPLETE
• Na solicitação de criação: opcional
• Na solicitação de atualização: opcional

object ( Duration )

Quanto o recurso do dispositivo é usado para realizar o teste.

Este é o uso do dispositivo usado para fins de cobrança, que é diferente do runDuration, por exemplo, falha de infraestrutura não será cobrado pelo uso do dispositivo.

PRECONDITION_FAILED será retornado se alguém tentar definir um device_usage em uma etapa que já tenha esse campo definido.

• Em resposta: presente se previamente definido.
• Na solicitação de criação: opcional
• Na solicitação de atualização: opcional

object ( MultiStep )

Detalhes quando várias etapas são executadas com a mesma configuração de um grupo. Esses detalhes podem ser usados ​​para identificar a qual grupo essa etapa faz parte. Ele também identifica a 'etapa primária' dos grupos, que indexa todos os membros do grupo.

• Em resposta: presente se previamente definido.
• Em criar solicitação: opcional, defina se esta etapa foi executada mais de uma vez.
• Na solicitação de atualização: opcional

object ( TestExecutionStep )

Uma execução de um executor de teste.

object ( ToolExecutionStep )

Uma execução de uma ferramenta (usada para etapas não compatíveis explicitamente).

{
  "testSuiteOverviews": [
    {
      object (TestSuiteOverview)
    }
  ],
  "toolExecution": {
    object (ToolExecution)
  },
  "testIssues": [
    {
      object (TestIssue)
    }
  ],
  "testTiming": {
    object (TestTiming)
  }
}

object ( TestSuiteOverview )

Lista de conteúdos de visão geral do conjunto de testes. Isso pode ser analisado do log xUnit XML pelo servidor ou carregado diretamente pelo usuário. Essas referências só devem ser chamadas quando os conjuntos de teste forem totalmente analisados ​​ou carregados.

O número máximo permitido de visões gerais do conjunto de testes por etapa é 1.000.

• Em resposta: sempre definido
• Na solicitação de criação: opcional
• Na solicitação de atualização: nunca (em vez disso, use o método personalizado publishXunitXmlFiles)

object ( ToolExecution )

Representa a execução do executor de teste.

O código de saída desta ferramenta será usado para determinar se o teste passou.

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

object ( TestIssue )

Problemas observados durante a execução do teste.

Por exemplo, se o aplicativo móvel em teste travar durante o teste, a mensagem de erro e o conteúdo do rastreamento de pilha podem ser registrados aqui para auxiliar na depuração.

• Em resposta: presente se definido por criar ou atualizar
• Na solicitação de criação/atualização: opcional

object ( TestTiming )

A interrupção do tempo da execução do teste.

• Em resposta: presente se definido por criar ou atualizar
• Na solicitação de criação/atualização: opcional

{
  "commandLineArguments": [
    string
  ],
  "toolLogs": [
    {
      object (FileReference)
    }
  ],
  "exitCode": {
    object (ToolExitCode)
  },
  "toolOutputs": [
    {
      object (ToolOutputReference)
    }
  ]
}

string

A linha de comando tokenizada completa, incluindo o nome do programa (equivalente a argv em um programa C).

• Em resposta: presente se definido por solicitação de criação
• Na solicitação de criação: opcional
• Na solicitação de atualização: nunca definido

object ( FileReference )

Referências a quaisquer logs de texto simples geram a execução da ferramenta.

Este campo pode ser definido antes da saída da ferramenta para poder ter acesso a uma visualização ao vivo dos logs enquanto a ferramenta está em execução.

O número máximo permitido de registros de ferramenta por etapa é 1000.

• Em resposta: presente se definido pela solicitação de criação/atualização
• Na solicitação de criação: opcional
• Na solicitação de atualização: opcional, qualquer valor fornecido será anexado à lista existente

object ( ToolExitCode )

Código de saída de execução da ferramenta. Este campo será definido assim que a ferramenta sair.

• Em resposta: presente se definido pela solicitação de criação/atualização
• Na solicitação de criação: opcional
• Na solicitação de atualização: opcional, um erro FAILED_PRECONDITION será retornado se um exitCode já estiver definido.

object ( ToolOutputReference )

Referências a arquivos opacos de qualquer formato gerados pela execução da ferramenta.

O número máximo permitido de saídas de ferramenta por etapa é 1000.

• Em resposta: presente se definido pela solicitação de criação/atualização
• Na solicitação de criação: opcional
• Na solicitação de atualização: opcional, qualquer valor fornecido será anexado à lista existente

{
  "number": integer
}

integer

Código de saída de execução da ferramenta. Um valor de 0 significa que a execução foi bem-sucedida.

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

{
  "errorMessage": string,
  "stackTrace": {
    object (StackTrace)
  },
  "warning": {
    object (Any)
  },
  "severity": enum (Severity),
  "type": enum (Type),
  "category": enum (Category)
}

string

Uma breve mensagem legível por humanos descrevendo o problema. Obrigatório.

object ( StackTrace )

Obsoleto em favor de campos de rastreamento de pilha dentro de avisos específicos.

object ( Any )

Mensagem de aviso com detalhes adicionais sobre o problema. Deve ser sempre uma mensagem de com.google.devtools.toolresults.v1.warnings

enum ( Severity )

Gravidade do problema. Obrigatório.

enum ( Type )

Tipo de problema. Obrigatório.

enum ( Category )

Categoria do problema. Obrigatório.

{
  "typeUrl": string,
  "value": string
}

string

Um nome de URL/recurso que identifica exclusivamente o tipo de mensagem de buffer de protocolo serializado. Esta string deve conter pelo menos um caractere "/". O último segmento do caminho do URL deve representar o nome totalmente qualificado do tipo (como em path/google.protobuf.Duration ). O nome deve estar na forma canônica (por exemplo, "." inicial não é aceito).

Na prática, as equipes geralmente pré-compilam no binário todos os tipos que esperam que ele use no contexto de Any. No entanto, para URLs que usam o esquema http , https ou nenhum esquema, pode-se opcionalmente configurar um servidor de tipo que mapeia URLs de tipo para definições de mensagem da seguinte forma:

• Se nenhum esquema for fornecido, https será assumido.
• Um HTTP GET no URL deve gerar um valor google.protobuf.Type em formato binário ou produzir um erro.
• Os aplicativos podem armazenar em cache os resultados da pesquisa com base na URL ou precompilá-los em um binário para evitar qualquer pesquisa. Portanto, a compatibilidade binária precisa ser preservada nas alterações de tipos. (Use nomes de tipo com versão para gerenciar alterações recentes.)

Observação: essa funcionalidade não está disponível atualmente na versão oficial do protobuf e não é usada para URLs de tipo que começam com type.googleapis.com.

Esquemas diferentes de http , https (ou o esquema vazio) podem ser usados ​​com semântica específica de implementação.

string ( bytes format)

Deve ser um buffer de protocolo serializado válido do tipo especificado acima.

Uma string codificada em base64.

{
  "testProcessDuration": {
    object (Duration)
  }
}

object ( Duration )

Quanto tempo levou para executar o processo de teste.

• Em resposta: presente se previamente definido.
• Na solicitação de criação/atualização: opcional

{
  "toolExecution": {
    object (ToolExecution)
  }
}

object ( ToolExecution )

Uma execução da ferramenta.

• Em resposta: presente se definido pela solicitação de criação/atualização
• Na solicitação de criação/atualização: opcional

{
  "primaryStepId": string,
  "multistepNumber": integer,
  "primaryStep": {
    object (PrimaryStep)
  }
}

string

Id da etapa principal (original), que pode ser esta etapa.

integer

Int exclusivo dado a cada etapa. Varia de 0(inclusive) ao número total de passos(exclusivo). O passo primário é 0.

object ( PrimaryStep )

Presente se for uma etapa primária (original).

{
  "rollUp": enum (OutcomeSummary),
  "individualOutcome": [
    {
      object (IndividualOutcome)
    }
  ]
}

enum ( OutcomeSummary )

Status de teste cumulativo de várias etapas que foram executadas com a mesma configuração de um grupo.

object ( IndividualOutcome )

Id da etapa e resultado de cada etapa individual.

{
  "stepId": string,
  "outcomeSummary": enum (OutcomeSummary),
  "multistepNumber": integer,
  "runDuration": {
    object (Duration)
  }
}

string

enum ( OutcomeSummary )

integer

Int exclusivo dado a cada etapa. Varia de 0(inclusive) ao número total de passos(exclusivo). O passo primário é 0.

object ( Duration )

Quanto tempo levou para esta etapa ser executada.