Results - Update

Service:

Test

API Version:

7.1-preview.6

Atualizar os resultados do teste em uma execução de teste.

PATCH https://dev.azure.com/{organization}/{project}/_apis/test/Runs/{runId}/results?api-version=7.1-preview.6

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
organization	path	True	string	O nome da organização do Azure DevOps.
project	path	True	string	ID do projeto ou nome do projeto
runId	path	True	integer int32	ID de execução de teste cujos resultados de teste serão atualizados.
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.1-preview.6' para usar essa versão da API.

Corpo da solicitação

Nome	Tipo	Description
body	TestCaseResult[]	Lista de resultados de teste a serem atualizados.

Respostas

Nome	Tipo	Description
200 OK	TestCaseResult[]	operação bem-sucedida

Segurança

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Nome	Description
vso.test_write	Concede a capacidade de ler, criar e atualizar planos de teste, casos, resultados e outros artefatos relacionados ao gerenciamento de testes.

Exemplos

Sample Request

HTTP

PATCH https://dev.azure.com/fabrikam/Fabrikam-Fiber-TFVC/_apis/test/Runs/26/results?api-version=7.1-preview.6

[
  {
    "id": 100000,
    "state": "Completed",
    "comment": "Website theme is looking good",
    "associatedBugs": [
      {
        "id": 30
      }
    ]
  },
  {
    "id": 100001,
    "state": "Completed",
    "comment": "Website links are failing because of incorrect container id",
    "failureType": "Known Issue"
  }
]

Sample Response

Status code:

200

{
  "count": 2,
  "value": [
    {
      "id": 100000,
      "project": {},
      "testRun": {},
      "lastUpdatedBy": {
        "id": null
      },
      "url": ""
    },
    {
      "id": 100001,
      "project": {},
      "testRun": {},
      "lastUpdatedBy": {
        "id": null
      },
      "url": ""
    }
  ]
}

Definições

Nome	Description
BuildReference	Referência a um build.
CustomTestField	Informações de campo personalizadas. Chave Permitida: pares de valor – ( AttemptId: int value, IsTestResultFlaky: bool)
FailingSince	Falha desde informações de um resultado de teste.
IdentityRef
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
ReleaseReference	Referência a uma versão.
ResultGroupType
ShallowReference	Uma referência abstraida a algum outro recurso. Essa classe é usada para fornecer os contratos de dados de build com uma maneira uniforme de referenciar outros recursos de uma maneira que fornece fácil passagem por meio de links.
SharedStepModel	Referência ao workitem de etapa compartilhada.
TestActionResultModel	Representa um resultado da etapa de teste.
TestCaseResult	Representa um resultado de teste.
TestCaseResultAttachmentModel	Testar informações de anexo em uma iteração de teste.
TestCaseResultIdentifier	Referência a um resultado de teste.
TestIterationDetailsModel	Representa um resultado de iteração de teste.
TestResultParameterModel	Testar informações de parâmetro em uma iteração de teste.
TestSubResult	Representa um sub resulto de um resultado de teste.

BuildReference

Referência a um build.

Nome	Tipo	Description
branchName	string	Nome do branch.
buildSystem	string	Criar sistema.
definitionId	integer	ID de definição de build.
id	integer	ID de build.
number	string	Número de build.
repositoryId	string	ID do repositório.
uri	string	Compilar URI.

CustomTestField

Informações de campo personalizadas. Chave Permitida: pares de valor – ( AttemptId: int value, IsTestResultFlaky: bool)

Nome	Tipo	Description
fieldName	string	Nome do campo.
value	object	Valor do campo.

FailingSince

Falha desde informações de um resultado de teste.

Nome	Tipo	Description
build	BuildReference	Referência de build desde a falha.
date	string	Tempo desde a falha (UTC).
release	ReleaseReference	Referência de versão desde a falha.

IdentityRef

Nome	Tipo	Description
_links	ReferenceLinks	Esse campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.
descriptor	string	O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto de grafo entre contas e organizações.
directoryAlias	string	Preterido – pode ser recuperado consultando o usuário do Graph referenciado na entrada "self" do dicionário IdentityRef "_links"
displayName	string	Esse é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.
id	string
imageUrl	string	Preterido – Disponível na entrada "avatar" do dicionário IdentityRef "_links"
inactive	boolean	Preterido – pode ser recuperado consultando o estado de associação do Graph referenciado na entrada "membershipState" do dicionário "_links" do GraphUser
isAadIdentity	boolean	Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Preterido – não em uso na maioria das implementações preexistir de ToIdentityRef
uniqueName	string	Preterido – use Domain+PrincipalName em vez disso
url	string	Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

Nome	Tipo	Description
links	object	A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

ReleaseReference

Referência a uma versão.

Nome	Tipo	Description
attempt	integer	Número de tentativas de versão.
creationDate	string	Data de Criação da Versão (UTC).
definitionId	integer	ID da definição de versão.
environmentCreationDate	string	Data de criação do ambiente (UTC).
environmentDefinitionId	integer	ID de definição do ambiente de versão.
environmentDefinitionName	string	Nome da definição do ambiente de versão.
environmentId	integer	ID do ambiente de versão.
environmentName	string	Nome do ambiente de versão.
id	integer	ID da versão.
name	string	Nome da versão.

ResultGroupType

Nome	Tipo	Description
dataDriven	string	Tipo de hierarquia do resultado do teste.
generic	string	Tipo de hierarquia desconhecido.
none	string	Nó folha do resultado do teste.
orderedTest	string	Tipo de hierarquia do resultado do teste.
rerun	string	Tipo de hierarquia do resultado do teste.

ShallowReference

Uma referência abstraida a algum outro recurso. Essa classe é usada para fornecer os contratos de dados de build com uma maneira uniforme de referenciar outros recursos de uma maneira que fornece fácil passagem por meio de links.

Nome	Tipo	Description
id	string	ID do recurso
name	string	Nome do recurso vinculado (nome da definição, nome do controlador etc.)
url	string	Link http completo para o recurso

SharedStepModel

Referência ao workitem de etapa compartilhada.

Nome	Tipo	Description
id	integer	ID da etapa compartilhada WorkItem.
revision	integer	Revisão de workitem de etapa compartilhada.

TestActionResultModel

Representa um resultado da etapa de teste.

Nome	Tipo	Description
actionPath	string	Identificador de caminho para a etapa de teste no workitem do caso de teste. Observação: 1) Ele é representado no formato hexadecimal com 8 dígitos para uma etapa. 2) Internamente, o valor da ID da etapa para a primeira etapa começa com 2, portanto, actionPath = 00000002 etapa 9, terá uma ID = 10 e actionPath = 0000000a etapa 15, terá uma ID =16 e actionPath = 00000010 3) actionPath da etapa compartilhada é concatenada com a etapa pai do caso de teste. Por exemplo, seria algo do tipo - 0000000300000001 em que 00000003 denota o caminho de ação da etapa de teste e 00000001 denota o caminho de ação para a etapa compartilhada
comment	string	Comentário no resultado.
completedDate	string	Hora em que a execução foi concluída (UTC).
durationInMs	number	Duração da execução.
errorMessage	string	Mensagem de erro no resultado.
iterationId	integer	ID de iteração do resultado da ação de teste.
outcome	string	Resultado do teste do resultado.
sharedStepModel	SharedStepModel	Referência ao workitem de etapa compartilhada.
startedDate	string	Hora em que a execução foi iniciada (UTC).
stepIdentifier	string	Esta é a ID da etapa do caso de teste. Para a etapa compartilhada, é a ID da etapa compartilhada no local de trabalho do caso de teste; ID da etapa na etapa compartilhada. Exemplo: o workitem TestCase tem duas etapas: 1) Etapa normal com ID = 1 2) Etapa Compartilhada com ID = 2. Dentro da etapa compartilhada: a) Etapa Normal com Id = 1 Valor para StepIdentifier para a Primeira etapa: "1" Segunda etapa: "2;1"
url	string	URL do resultado da ação de teste. Preterido no ambiente hospedado.

TestCaseResult

Representa um resultado de teste.

Nome	Tipo	Description
afnStripId	integer	Testar a ID do anexo da gravação de ação.
area	ShallowReference	Referência ao caminho de área de teste.
associatedBugs	ShallowReference[]	Referência a bugs vinculados ao resultado do teste.
automatedTestId	string	ID que representa o método de teste em uma dll.
automatedTestName	string	Nome totalmente qualificado do teste executado.
automatedTestStorage	string	Contêiner ao qual o teste pertence.
automatedTestType	string	Tipo de teste automatizado.
automatedTestTypeId	string	TypeId de teste automatizado.
build	ShallowReference	Referência superficial para compilação associada ao resultado do teste.
buildReference	BuildReference	Referência ao build associado ao resultado do teste.
comment	string	Comente em um resultado de teste com maxSize= 1000 caracteres.
completedDate	string	Hora em que a execução do teste foi concluída (UTC). A data concluída deve ser maior que StartedDate.
computerName	string	Nome do computador em que o teste foi executado.
configuration	ShallowReference	Referência à configuração de teste. Digite ShallowReference.
createdDate	string	Carimbo de data/hora quando o resultado do teste foi criado (UTC).
customFields	CustomTestField[]	Propriedades adicionais do resultado do teste.
durationInMs	number	Duração da execução do teste em milissegundos. Se não for fornecido, o valor será definido como CompletedDate – StartedDate
errorMessage	string	Mensagem de erro na execução do teste.
failingSince	FailingSince	Informações quando os resultados do teste começaram a falhar.
failureType	string	Tipo de falha do resultado do teste. Valor válido= (problema conhecido, novo problema, regressão, desconhecido, nenhum)
id	integer	ID de um resultado de teste.
iterationDetails	TestIterationDetailsModel[]	Teste os detalhes do resultado das iterações de teste usadas apenas para o Teste Manual.
lastUpdatedBy	IdentityRef	Referência ao último resultado do teste atualizado pela identidade.
lastUpdatedDate	string	Data e hora da última atualização do resultado do teste (UTC).
outcome	string	Resultado do teste do resultado do teste. Valores válidos = (Unspecified, None, Passed, Failed, Inconclusive, Timeout, Aborted, Blocked, NotExecuted, Warning, Error, NotApplicable, Paused, InProgress, NotImpacted)
owner	IdentityRef	Referência ao proprietário do teste.
priority	integer	Prioridade do teste executado.
project	ShallowReference	Referência ao projeto de equipe.
release	ShallowReference	Referência superficial para liberação associada ao resultado do teste.
releaseReference	ReleaseReference	Referência à versão associada ao resultado do teste.
resetCount	integer	ResetCount.
resolutionState	string	Estado de resolução do resultado do teste.
resolutionStateId	integer	ID do estado de resolução.
resultGroupType	ResultGroupType	Tipo de hierarquia do resultado, valor padrão de Nenhum significa seu nó folha.
revision	integer	Número de revisão do resultado do teste.
runBy	IdentityRef	A referência à identidade executou o teste.
stackTrace	string	Stacktrace com maxSize= 1000 caracteres.
startedDate	string	Hora em que a execução do teste foi iniciada (UTC).
state	string	Estado do resultado do teste. Digite TestRunState.
subResults	TestSubResult[]	Lista de sub-resultados dentro de um resultado de teste, se ResultGroupType não for Nenhum, ele conterá sub-resultados de tipo correspondentes.
testCase	ShallowReference	Referência ao teste executado.
testCaseReferenceId	integer	ID de referência do teste usado pelo resultado do teste. Tipo TestResultMetaData
testCaseRevision	integer	Número de TestCaseRevision.
testCaseTitle	string	Nome do teste.
testPlan	ShallowReference	A referência ao workitem de caso de teste do plano de teste faz parte.
testPoint	ShallowReference	Referência ao ponto de teste executado.
testRun	ShallowReference	Referência à execução de teste.
testSuite	ShallowReference	A referência ao workitem de caso de teste do conjunto de testes faz parte.
url	string	URL do resultado do teste.

TestCaseResultAttachmentModel

Testar informações de anexo em uma iteração de teste.

Nome	Tipo	Description
actionPath	string	Etapa de teste do identificador de caminho no workitem do caso de teste.
id	integer	ID do anexo.
iterationId	integer	ID da iteração.
name	string	Nome do anexo.
size	integer	Tamanho do anexo.
url	string	URL para anexo.

TestCaseResultIdentifier

Referência a um resultado de teste.

Nome	Tipo	Description
testResultId	integer	ID do resultado do teste.
testRunId	integer	ID de execução de teste.

TestIterationDetailsModel

Representa um resultado de iteração de teste.

Nome	Tipo	Description
actionResults	TestActionResultModel[]	A etapa de teste resulta em uma iteração.
attachments	TestCaseResultAttachmentModel[]	Referência a anexos no resultado da iteração de teste.
comment	string	Comente no resultado da iteração do teste.
completedDate	string	Hora em que a execução foi concluída (UTC).
durationInMs	number	Duração da execução.
errorMessage	string	Mensagem de erro na execução do resultado da iteração de teste.
id	integer	ID do resultado da iteração do teste.
outcome	string	Resultado do teste se o resultado da iteração do teste.
parameters	TestResultParameterModel[]	Testar parâmetros em uma iteração.
startedDate	string	Hora em que a execução foi iniciada (UTC).
url	string	Url para testar o resultado da iteração.

TestResultParameterModel

Testar informações de parâmetro em uma iteração de teste.

Nome	Tipo	Description
actionPath	string	Caminho da etapa de teste em que o parâmetro é referenciado.
iterationId	integer	ID da iteração.
parameterName	string	Nome do parâmetro.
stepIdentifier	string	Esta é a ID da etapa do caso de teste. Para a etapa compartilhada, é a ID da etapa compartilhada no local de trabalho do caso de teste; ID da etapa na etapa compartilhada. Exemplo: o workitem TestCase tem duas etapas: 1) Etapa normal com ID = 1 2) Etapa Compartilhada com ID = 2. Dentro da etapa compartilhada: a) Etapa Normal com Id = 1 Valor para StepIdentifier para a Primeira etapa: "1" Segunda etapa: "2;1"
url	string	URL do parâmetro de teste. Preterido no ambiente hospedado.
value	string	Valor do parâmetro.

TestSubResult

Representa um sub resulto de um resultado de teste.

Nome	Tipo	Description
comment	string	Comente em sub-resultado.
completedDate	string	Hora em que a execução do teste foi concluída (UTC).
computerName	string	Computador em que o teste foi executado.
configuration	ShallowReference	Referência à configuração de teste.
customFields	CustomTestField[]	Propriedades adicionais de sub-resultado.
displayName	string	Nome do sub-resultado.
durationInMs	integer	Duração da execução do teste.
errorMessage	string	Mensagem de erro em sub-resultado.
id	integer	ID de sub-resultado.
lastUpdatedDate	string	Hora em que o resultado foi atualizado pela última vez (UTC).
outcome	string	Resultado do sub-resultado.
parentId	integer	ID pai imediata de sub resulto.
resultGroupType	ResultGroupType	Tipo de hierarquia do resultado, valor padrão de Nenhum significa seu nó folha.
sequenceId	integer	Número de índice de sub-resultado.
stackTrace	string	Stacktrace.
startedDate	string	Hora em que a execução do teste foi iniciada (UTC).
subResults	TestSubResult[]	Lista de sub-resultados dentro de um sub-resultado, se ResultGroupType não for Nenhum, ela conterá os sub-resultados de tipo correspondentes.
testResult	TestCaseResultIdentifier	Referência ao resultado do teste.
url	string	URL de sub-resultado.