Partilhar via


TestRestClient class

Classe base que deve ser usada (derivada de) para fazer solicitações para APIs REST do VSS

Extends

Construtores

TestRestClient(IVssRestClientOptions)

Propriedades

RESOURCE_AREA_ID

Métodos

addCustomFields(CustomTestFieldDefinition[], string)
addTestCasesToSuite(string, number, number, string)

Adicione casos de teste ao pacote.

addTestResultsToTestRun(TestCaseResult[], string, number)

Adicione resultados de teste a uma execução de teste.

addWorkItemToTestLinks(WorkItemToTestLinks, string)
createTestIterationResultAttachment(TestAttachmentRequestModel, string, number, number, number, string)

Anexar um arquivo ao resultado da etapa de teste

createTestResultAttachment(TestAttachmentRequestModel, string, number, number)

Anexe um arquivo a um resultado de teste.

createTestRun(RunCreateModel, string)

Crie uma nova execução de teste.

createTestRunAttachment(TestAttachmentRequestModel, string, number)

Anexe um arquivo a uma execução de teste.

createTestSession(TestSession, TeamContext)

Criar uma sessão de teste

createTestSettings(TestSettings, string)
createTestSubResultAttachment(TestAttachmentRequestModel, string, number, number, number)

Anexar um ficheiro a um resultado de teste

deleteSharedParameter(string, number)
deleteSharedStep(string, number)
deleteTestCase(string, number)

Exclua um caso de teste.

deleteTestMethodToWorkItemLink(string, string, number)
deleteTestRun(string, number)

Exclua um teste executado por sua ID.

deleteTestSettings(string, number)
getBugsLinkedToTestResult(string, number, number)
getBuildCodeCoverage(string, number, number)

Obtenha dados de cobertura de código para uma compilação.

getCodeCoverageSummary(string, number, number)

Obtenha o resumo da cobertura de código para compilação.

getLinkedWorkItemsByQuery(LinkedWorkItemsQuery, string)
getPoint(string, number, number, number, string)

Obtenha um ponto de teste.

getPoints(string, number, number, string, string, string, string, boolean, number, number)

Obtenha uma lista de pontos de teste.

getPointsByQuery(TestPointsQuery, string, number, number)

Obtenha pontos de teste usando consulta.

getResultGroupsByBuild(string, number, string, string[], string)
getResultGroupsByRelease(string, number, string, number, string[], string)
getResultRetentionSettings(string)

Obter configurações de retenção de resultados de teste

getTestCaseById(string, number, number, number)

Obtenha um caso de teste específico em um conjunto de testes com ID de caso de teste.

getTestCases(string, number, number)

Obtenha todos os casos de teste em um pacote.

getTestIteration(string, number, number, number, boolean)

Obter iteração para um resultado

getTestIterations(string, number, number, boolean)

Obter iterações para um resultado

getTestResultAttachmentContent(string, number, number, number)

Faça o download de um anexo de resultado de teste pelo seu ID.

getTestResultAttachments(string, number, number)

Obter lista de referência de anexos de resultados de teste.

getTestResultAttachmentZip(string, number, number, number)

Faça o download de um anexo de resultado de teste pelo seu ID.

getTestResultById(string, number, number, ResultDetails)

Obtenha um resultado de teste para uma execução de teste.

getTestResultDetailsForBuild(string, number, string, string, string, string, boolean, boolean)
getTestResultDetailsForRelease(string, number, number, string, string, string, string, boolean, boolean)
getTestResults(string, number, ResultDetails, number, number, TestOutcome[])

Obtenha resultados de teste para uma execução de teste.

getTestResultsByBuild(string, number, string, TestOutcome[], number, string)
getTestResultsByQuery(TestResultsQuery, string)

Essa API retornará resultados por Ids com campos especificados/tendência para determinado método de teste automatizado. Ainda estamos a melhorar esta API e ainda não finalizámos a assinatura e o contrato adequados.

getTestResultsByRelease(string, number, number, string, TestOutcome[], number, string)
getTestRunAttachmentContent(string, number, number)

Baixe um anexo de execução de teste por seu ID.

getTestRunAttachments(string, number)

Obtenha a lista de referência de anexos de execução de teste.

getTestRunAttachmentZip(string, number, number)

Baixe um anexo de execução de teste por seu ID.

getTestRunById(string, number, boolean)

Obtenha um teste executado pelo seu ID.

getTestRunCodeCoverage(string, number, number)

Obter dados de cobertura de código para uma execução de teste

getTestRunLogs(string, number)

Obter logs de mensagens de execução de teste

getTestRuns(string, string, string, string, number, boolean, boolean, number, number)

Obtenha uma lista de execuções de teste.

getTestRunStatistics(string, number)

Obtenha estatísticas de execução de teste , usadas quando queremos obter um resumo de uma execução por resultado.

getTestSessions(TeamContext, number, boolean, boolean, TestSessionSource, boolean)

Obter uma lista de sessões de teste

getTestSettingsById(string, number)
getTestSubResultAttachmentContent(string, number, number, number, number)

Baixar um anexo de subresultado de teste

getTestSubResultAttachments(string, number, number, number)

Obter lista de anexos de subresultados de teste

getTestSubResultAttachmentZip(string, number, number, number, number)

Baixar um anexo de subresultado de teste

processSuitesForStaging(StagedSuitesRequestModel, string, number)

Processa uma coleção de conjuntos de testes e retorna um modelo de resposta contendo detalhes do conjunto e do caso de teste.

publishTestResultDocument(TestResultDocument, string, number)
queryCustomFields(string, CustomTestFieldScope)
queryResultTrendForBuild(TestResultTrendFilter, string)
queryResultTrendForRelease(TestResultTrendFilter, string)
queryTestHistory(TestHistoryQuery, string)

Obter histórico de um método de teste usando TestHistoryQuery

queryTestMethodLinkedWorkItems(string, string)
queryTestResultHistory(ResultsFilter, string)
queryTestResultsMetaData(string[], string)

Obter lista de detalhes de metadados do resultado do teste para testcasereferenceId correspondente

queryTestResultsReportForBuild(string, number, string, boolean, BuildReference)
queryTestResultsReportForRelease(string, number, number, string, boolean, ReleaseReference)
queryTestResultsSummaryForReleases(ReleaseReference[], string)
queryTestResultWorkItems(string, string, string, number, Date, number, number)
queryTestRuns(string, Date, Date, TestRunState, number[], boolean, TestRunPublishContext, number[], number[], string, number[], number[], number[], number[], string, number, string)

O teste de consulta é executado com base em filtros. Os campos obrigatórios são minLastUpdatedDate e maxLastUpdatedDate.

queryTestSummaryByRequirement(TestResultsContext, string, number[])
removeTestCasesFromSuiteUrl(string, number, number, string)

Os pontos de teste associados aos casos de teste são removidos do conjunto de testes. O item de trabalho do caso de teste não é excluído do sistema. Consulte o recurso de casos de teste para excluir um caso de teste permanentemente.

updateCodeCoverageSummary(CodeCoverageData, string, number)

http://(tfsserver):8080/tfs/DefaultCollection/_apis/test/CodeCoverage?buildId=10 Solicitação: Json do resumo da cobertura do código

updateResultRetentionSettings(ResultRetentionSettings, string)

Atualizar as configurações de retenção de resultados de teste

updateSuiteTestCases(SuiteTestCaseUpdateModel, string, number, number, string)

Atualiza as propriedades da associação de caso de teste em um pacote.

updateTestPoints(PointUpdateModel, string, number, number, string)

Atualize os pontos de teste.

updateTestResults(TestCaseResult[], string, number)

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

updateTestRun(RunUpdateModel, string, number)

Teste de atualização executado por seu ID.

updateTestSession(TestSession, TeamContext)

Atualizar uma sessão de teste

Detalhes do Construtor

TestRestClient(IVssRestClientOptions)

new TestRestClient(options: IVssRestClientOptions)

Parâmetros

Detalhes de Propriedade

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: string

Valor de Propriedade

string

Detalhes de Método

addCustomFields(CustomTestFieldDefinition[], string)

function addCustomFields(newFields: CustomTestFieldDefinition[], project: string): Promise<CustomTestFieldDefinition[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

Devoluções

addTestCasesToSuite(string, number, number, string)

Adicione casos de teste ao pacote.

function addTestCasesToSuite(project: string, planId: number, suiteId: number, testCaseIds: string): Promise<SuiteTestCase[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

planId

number

ID do plano de teste que contém o conjunto.

suiteId

number

ID do conjunto de testes ao qual os casos de teste devem ser adicionados.

testCaseIds

string

IDs dos casos de teste para adicionar ao pacote. As ids são especificadas em formato separado por vírgula.

Devoluções

Promise<SuiteTestCase[]>

addTestResultsToTestRun(TestCaseResult[], string, number)

Adicione resultados de teste a uma execução de teste.

function addTestResultsToTestRun(results: TestCaseResult[], project: string, runId: number): Promise<TestCaseResult[]>

Parâmetros

results

TestCaseResult[]

Lista de resultados de testes a adicionar.

project

string

ID do projeto ou nome do projeto

runId

number

ID de execução de teste em que os resultados do teste devem ser adicionados.

Devoluções

Promise<TestCaseResult[]>

function addWorkItemToTestLinks(workItemToTestLinks: WorkItemToTestLinks, project: string): Promise<WorkItemToTestLinks>

Parâmetros

workItemToTestLinks
WorkItemToTestLinks
project

string

ID do projeto ou nome do projeto

Devoluções

createTestIterationResultAttachment(TestAttachmentRequestModel, string, number, number, number, string)

Anexar um arquivo ao resultado da etapa de teste

function createTestIterationResultAttachment(attachmentRequestModel: TestAttachmentRequestModel, project: string, runId: number, testCaseResultId: number, iterationId: number, actionPath?: string): Promise<TestAttachmentReference>

Parâmetros

attachmentRequestModel
TestAttachmentRequestModel

Detalhes do anexo TestAttachmentRequestModel

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução de teste que contém o resultado.

testCaseResultId

number

ID do resultado do teste que contém a iteração

iterationId

number

ID da iteração do resultado do teste.

actionPath

string

Valor hexadecimal do caminho de ação do resultado do teste.

Devoluções

createTestResultAttachment(TestAttachmentRequestModel, string, number, number)

Anexe um arquivo a um resultado de teste.

function createTestResultAttachment(attachmentRequestModel: TestAttachmentRequestModel, project: string, runId: number, testCaseResultId: number): Promise<TestAttachmentReference>

Parâmetros

attachmentRequestModel
TestAttachmentRequestModel

Detalhes do anexo TestAttachmentRequestModel

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução de teste que contém o resultado.

testCaseResultId

number

ID do resultado do teste em relação ao qual o anexo tem de ser carregado.

Devoluções

createTestRun(RunCreateModel, string)

Crie uma nova execução de teste.

function createTestRun(testRun: RunCreateModel, project: string): Promise<TestRun>

Parâmetros

testRun
RunCreateModel

Detalhes da execução: RunCreateModel

project

string

ID do projeto ou nome do projeto

Devoluções

Promise<TestRun>

createTestRunAttachment(TestAttachmentRequestModel, string, number)

Anexe um arquivo a uma execução de teste.

function createTestRunAttachment(attachmentRequestModel: TestAttachmentRequestModel, project: string, runId: number): Promise<TestAttachmentReference>

Parâmetros

attachmentRequestModel
TestAttachmentRequestModel

Detalhes do anexo TestAttachmentRequestModel

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução do teste em relação à qual o anexo deve ser carregado.

Devoluções

createTestSession(TestSession, TeamContext)

Criar uma sessão de teste

function createTestSession(testSession: TestSession, teamContext: TeamContext): Promise<TestSession>

Parâmetros

testSession
TestSession

Detalhes da sessão de teste para criação

teamContext
TeamContext

O contexto da equipe para a operação

Devoluções

Promise<TestSession>

createTestSettings(TestSettings, string)

function createTestSettings(testSettings: TestSettings, project: string): Promise<number>

Parâmetros

testSettings
TestSettings
project

string

ID do projeto ou nome do projeto

Devoluções

Promise<number>

createTestSubResultAttachment(TestAttachmentRequestModel, string, number, number, number)

Anexar um ficheiro a um resultado de teste

function createTestSubResultAttachment(attachmentRequestModel: TestAttachmentRequestModel, project: string, runId: number, testCaseResultId: number, testSubResultId: number): Promise<TestAttachmentReference>

Parâmetros

attachmentRequestModel
TestAttachmentRequestModel

Modelo de solicitação de anexo.

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução de teste que contém o resultado.

testCaseResultId

number

ID dos resultados do teste que contém o subresultado.

testSubResultId

number

ID dos subresultados do teste em relação aos quais o anexo tem de ser carregado.

Devoluções

deleteSharedParameter(string, number)

function deleteSharedParameter(project: string, sharedParameterId: number): Promise<void>

Parâmetros

project

string

ID do projeto ou nome do projeto

sharedParameterId

number

Devoluções

Promise<void>

deleteSharedStep(string, number)

function deleteSharedStep(project: string, sharedStepId: number): Promise<void>

Parâmetros

project

string

ID do projeto ou nome do projeto

sharedStepId

number

Devoluções

Promise<void>

deleteTestCase(string, number)

Exclua um caso de teste.

function deleteTestCase(project: string, testCaseId: number): Promise<void>

Parâmetros

project

string

ID do projeto ou nome do projeto

testCaseId

number

Id do caso de teste a ser excluído.

Devoluções

Promise<void>

function deleteTestMethodToWorkItemLink(project: string, testName: string, workItemId: number): Promise<boolean>

Parâmetros

project

string

ID do projeto ou nome do projeto

testName

string

workItemId

number

Devoluções

Promise<boolean>

deleteTestRun(string, number)

Exclua um teste executado por sua ID.

function deleteTestRun(project: string, runId: number): Promise<void>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução a ser excluída.

Devoluções

Promise<void>

deleteTestSettings(string, number)

function deleteTestSettings(project: string, testSettingsId: number): Promise<void>

Parâmetros

project

string

ID do projeto ou nome do projeto

testSettingsId

number

Devoluções

Promise<void>

getBugsLinkedToTestResult(string, number, number)

function getBugsLinkedToTestResult(project: string, runId: number, testCaseResultId: number): Promise<WorkItemReference[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

testCaseResultId

number

Devoluções

Promise<WorkItemReference[]>

getBuildCodeCoverage(string, number, number)

Obtenha dados de cobertura de código para uma compilação.

function getBuildCodeCoverage(project: string, buildId: number, flags: number): Promise<BuildCoverage[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

buildId

number

ID da compilação para a qual os dados de cobertura de código precisam ser buscados.

flags

number

O valor dos sinalizadores determina o nível de detalhes de cobertura do código a ser buscado. As bandeiras são aditivas. Os valores esperados são 1 para módulos, 2 para funções, 4 para BlockData.

Devoluções

Promise<BuildCoverage[]>

getCodeCoverageSummary(string, number, number)

Obtenha o resumo da cobertura de código para compilação.

function getCodeCoverageSummary(project: string, buildId: number, deltaBuildId?: number): Promise<CodeCoverageSummary>

Parâmetros

project

string

ID do projeto ou nome do projeto

buildId

number

ID da compilação para a qual os dados de cobertura de código precisam ser buscados.

deltaBuildId

number

ID de compilação delta (opcional)

Devoluções

getLinkedWorkItemsByQuery(LinkedWorkItemsQuery, string)

function getLinkedWorkItemsByQuery(workItemQuery: LinkedWorkItemsQuery, project: string): Promise<LinkedWorkItemsQueryResult[]>

Parâmetros

workItemQuery
LinkedWorkItemsQuery
project

string

ID do projeto ou nome do projeto

Devoluções

getPoint(string, number, number, number, string)

Obtenha um ponto de teste.

function getPoint(project: string, planId: number, suiteId: number, pointIds: number, witFields?: string): Promise<TestPoint>

Parâmetros

project

string

ID do projeto ou nome do projeto

planId

number

ID do plano de teste.

suiteId

number

ID do pacote que contém o ponto.

pointIds

number

ID do ponto de teste a obter.

witFields

string

Lista separada por vírgulas de nomes de campos de item de trabalho.

Devoluções

Promise<TestPoint>

getPoints(string, number, number, string, string, string, string, boolean, number, number)

Obtenha uma lista de pontos de teste.

function getPoints(project: string, planId: number, suiteId: number, witFields?: string, configurationId?: string, testCaseId?: string, testPointIds?: string, includePointDetails?: boolean, skip?: number, top?: number): Promise<TestPoint[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

planId

number

ID do plano de teste.

suiteId

number

ID da suíte que contém os pontos.

witFields

string

Lista separada por vírgulas de nomes de campos de item de trabalho.

configurationId

string

Obtenha pontos de teste para configurações específicas.

testCaseId

string

Obtenha pontos de teste para um caso de teste específico, válido quando configurationId não estiver definido.

testPointIds

string

Obtenha pontos de teste para uma lista separada por vírgulas de IDs de ponto de teste, válida somente quando configurationId e testCaseId não estiverem definidos.

includePointDetails

boolean

Inclua todas as propriedades para o ponto de teste.

skip

number

Número de pontos de ensaio a ignorar.

top

number

Número de pontos de teste a retornar.

Devoluções

Promise<TestPoint[]>

getPointsByQuery(TestPointsQuery, string, number, number)

Obtenha pontos de teste usando consulta.

function getPointsByQuery(query: TestPointsQuery, project: string, skip?: number, top?: number): Promise<TestPointsQuery>

Parâmetros

query
TestPointsQuery

TestPointsQuery para obter pontos de teste.

project

string

ID do projeto ou nome do projeto

skip

number

Número de pontos de ensaio a ignorar.

top

number

Número de pontos de teste a retornar.

Devoluções

Promise<TestPointsQuery>

getResultGroupsByBuild(string, number, string, string[], string)

function getResultGroupsByBuild(project: string, buildId: number, publishContext: string, fields?: string[], continuationToken?: string): Promise<PagedList<FieldDetailsForTestResults>>

Parâmetros

project

string

ID do projeto ou nome do projeto

buildId

number

publishContext

string

fields

string[]

continuationToken

string

Devoluções

getResultGroupsByRelease(string, number, string, number, string[], string)

function getResultGroupsByRelease(project: string, releaseId: number, publishContext: string, releaseEnvId?: number, fields?: string[], continuationToken?: string): Promise<PagedList<FieldDetailsForTestResults>>

Parâmetros

project

string

ID do projeto ou nome do projeto

releaseId

number

publishContext

string

releaseEnvId

number

fields

string[]

continuationToken

string

Devoluções

getResultRetentionSettings(string)

Obter configurações de retenção de resultados de teste

function getResultRetentionSettings(project: string): Promise<ResultRetentionSettings>

Parâmetros

project

string

ID do projeto ou nome do projeto

Devoluções

getTestCaseById(string, number, number, number)

Obtenha um caso de teste específico em um conjunto de testes com ID de caso de teste.

function getTestCaseById(project: string, planId: number, suiteId: number, testCaseIds: number): Promise<SuiteTestCase>

Parâmetros

project

string

ID do projeto ou nome do projeto

planId

number

ID do plano de teste que contém os pacotes.

suiteId

number

ID do conjunto que contém o caso de teste.

testCaseIds

number

ID do caso de teste a obter.

Devoluções

Promise<SuiteTestCase>

getTestCases(string, number, number)

Obtenha todos os casos de teste em um pacote.

function getTestCases(project: string, planId: number, suiteId: number): Promise<SuiteTestCase[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

planId

number

ID do plano de teste que contém os pacotes.

suiteId

number

ID da suíte a ser obtida.

Devoluções

Promise<SuiteTestCase[]>

getTestIteration(string, number, number, number, boolean)

Obter iteração para um resultado

function getTestIteration(project: string, runId: number, testCaseResultId: number, iterationId: number, includeActionResults?: boolean): Promise<TestIterationDetailsModel>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução de teste que contém o resultado.

testCaseResultId

number

ID do resultado do teste que contém as iterações.

iterationId

number

Id da iteração dos resultados do teste.

includeActionResults

boolean

Inclua detalhes do resultado para cada ação executada na iteração de teste. ActionResults refere-se ao resultado (aprovação/reprovação) de etapas de teste que são executadas como parte de uma execução de um teste manual. Incluindo o sinalizador ActionResults obtém o resultado das etapas de teste na seção actionResults e os parâmetros de teste na seção de parâmetros para cada iteração de teste.

Devoluções

getTestIterations(string, number, number, boolean)

Obter iterações para um resultado

function getTestIterations(project: string, runId: number, testCaseResultId: number, includeActionResults?: boolean): Promise<TestIterationDetailsModel[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução de teste que contém o resultado.

testCaseResultId

number

ID do resultado do teste que contém as iterações.

includeActionResults

boolean

Inclua detalhes do resultado para cada ação executada na iteração de teste. ActionResults refere-se ao resultado (aprovação/reprovação) de etapas de teste que são executadas como parte de uma execução de um teste manual. Incluindo o sinalizador ActionResults obtém o resultado das etapas de teste na seção actionResults e os parâmetros de teste na seção de parâmetros para cada iteração de teste.

Devoluções

getTestResultAttachmentContent(string, number, number, number)

Faça o download de um anexo de resultado de teste pelo seu ID.

function getTestResultAttachmentContent(project: string, runId: number, testCaseResultId: number, attachmentId: number): Promise<ArrayBuffer>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução de teste que contém o testCaseResultId.

testCaseResultId

number

ID do resultado do teste cujo anexo tem de ser descarregado.

attachmentId

number

ID do anexo do resultado do teste a ser baixado.

Devoluções

Promise<ArrayBuffer>

getTestResultAttachments(string, number, number)

Obter lista de referência de anexos de resultados de teste.

function getTestResultAttachments(project: string, runId: number, testCaseResultId: number): Promise<TestAttachment[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução de teste que contém o resultado.

testCaseResultId

number

ID do resultado do teste.

Devoluções

Promise<TestAttachment[]>

getTestResultAttachmentZip(string, number, number, number)

Faça o download de um anexo de resultado de teste pelo seu ID.

function getTestResultAttachmentZip(project: string, runId: number, testCaseResultId: number, attachmentId: number): Promise<ArrayBuffer>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução de teste que contém o testCaseResultId.

testCaseResultId

number

ID do resultado do teste cujo anexo tem de ser descarregado.

attachmentId

number

ID do anexo do resultado do teste a ser baixado.

Devoluções

Promise<ArrayBuffer>

getTestResultById(string, number, number, ResultDetails)

Obtenha um resultado de teste para uma execução de teste.

function getTestResultById(project: string, runId: number, testCaseResultId: number, detailsToInclude?: ResultDetails): Promise<TestCaseResult>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID de execução de teste de um resultado de teste a ser buscado.

testCaseResultId

number

ID do resultado do teste.

detailsToInclude
ResultDetails

Detalhes a incluir nos resultados dos testes. O padrão é Nenhum. Outros valores são Iterations, WorkItems e SubResults.

Devoluções

Promise<TestCaseResult>

getTestResultDetailsForBuild(string, number, string, string, string, string, boolean, boolean)

function getTestResultDetailsForBuild(project: string, buildId: number, publishContext?: string, groupBy?: string, filter?: string, orderby?: string, shouldIncludeResults?: boolean, queryRunSummaryForInProgress?: boolean): Promise<TestResultsDetails>

Parâmetros

project

string

ID do projeto ou nome do projeto

buildId

number

publishContext

string

groupBy

string

filter

string

orderby

string

shouldIncludeResults

boolean

queryRunSummaryForInProgress

boolean

Devoluções

getTestResultDetailsForRelease(string, number, number, string, string, string, string, boolean, boolean)

function getTestResultDetailsForRelease(project: string, releaseId: number, releaseEnvId: number, publishContext?: string, groupBy?: string, filter?: string, orderby?: string, shouldIncludeResults?: boolean, queryRunSummaryForInProgress?: boolean): Promise<TestResultsDetails>

Parâmetros

project

string

ID do projeto ou nome do projeto

releaseId

number

releaseEnvId

number

publishContext

string

groupBy

string

filter

string

orderby

string

shouldIncludeResults

boolean

queryRunSummaryForInProgress

boolean

Devoluções

getTestResults(string, number, ResultDetails, number, number, TestOutcome[])

Obtenha resultados de teste para uma execução de teste.

function getTestResults(project: string, runId: number, detailsToInclude?: ResultDetails, skip?: number, top?: number, outcomes?: TestOutcome[]): Promise<TestCaseResult[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID de execução de teste dos resultados do teste a serem buscados.

detailsToInclude
ResultDetails

Detalhes a incluir nos resultados dos testes. O padrão é Nenhum. Outros valores são Iterations e WorkItems.

skip

number

Número de resultados do teste a serem ignorados desde o início.

top

number

Número de resultados de testes a devolver. O máximo é 1000 quando detailsToInclude é Nenhum e 200 caso contrário.

outcomes

TestOutcome[]

Lista separada por vírgulas dos resultados do teste para filtrar os resultados do teste.

Devoluções

Promise<TestCaseResult[]>

getTestResultsByBuild(string, number, string, TestOutcome[], number, string)

function getTestResultsByBuild(project: string, buildId: number, publishContext?: string, outcomes?: TestOutcome[], top?: number, continuationToken?: string): Promise<PagedList<ShallowTestCaseResult>>

Parâmetros

project

string

ID do projeto ou nome do projeto

buildId

number

publishContext

string

outcomes

TestOutcome[]

top

number

continuationToken

string

Devoluções

getTestResultsByQuery(TestResultsQuery, string)

Essa API retornará resultados por Ids com campos especificados/tendência para determinado método de teste automatizado. Ainda estamos a melhorar esta API e ainda não finalizámos a assinatura e o contrato adequados.

function getTestResultsByQuery(query: TestResultsQuery, project: string): Promise<TestResultsQuery>

Parâmetros

project

string

ID do projeto ou nome do projeto

Devoluções

Promise<TestResultsQuery>

getTestResultsByRelease(string, number, number, string, TestOutcome[], number, string)

function getTestResultsByRelease(project: string, releaseId: number, releaseEnvid?: number, publishContext?: string, outcomes?: TestOutcome[], top?: number, continuationToken?: string): Promise<PagedList<ShallowTestCaseResult>>

Parâmetros

project

string

ID do projeto ou nome do projeto

releaseId

number

releaseEnvid

number

publishContext

string

outcomes

TestOutcome[]

top

number

continuationToken

string

Devoluções

getTestRunAttachmentContent(string, number, number)

Baixe um anexo de execução de teste por seu ID.

function getTestRunAttachmentContent(project: string, runId: number, attachmentId: number): Promise<ArrayBuffer>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução de teste cujo anexo deve ser baixado.

attachmentId

number

ID do anexo de execução de teste a ser baixado.

Devoluções

Promise<ArrayBuffer>

getTestRunAttachments(string, number)

Obtenha a lista de referência de anexos de execução de teste.

function getTestRunAttachments(project: string, runId: number): Promise<TestAttachment[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução do teste.

Devoluções

Promise<TestAttachment[]>

getTestRunAttachmentZip(string, number, number)

Baixe um anexo de execução de teste por seu ID.

function getTestRunAttachmentZip(project: string, runId: number, attachmentId: number): Promise<ArrayBuffer>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução de teste cujo anexo deve ser baixado.

attachmentId

number

ID do anexo de execução de teste a ser baixado.

Devoluções

Promise<ArrayBuffer>

getTestRunById(string, number, boolean)

Obtenha um teste executado pelo seu ID.

function getTestRunById(project: string, runId: number, includeDetails?: boolean): Promise<TestRun>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da corrida a obter.

includeDetails

boolean

O valor padrão é true. Ele inclui detalhes como estatísticas de execução, lançamento, compilação, ambiente de teste, estado pós-processo e muito mais.

Devoluções

Promise<TestRun>

getTestRunCodeCoverage(string, number, number)

Obter dados de cobertura de código para uma execução de teste

function getTestRunCodeCoverage(project: string, runId: number, flags: number): Promise<TestRunCoverage[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução de teste para a qual os dados de cobertura de código precisam ser buscados.

flags

number

O valor dos sinalizadores determina o nível de detalhes de cobertura do código a ser buscado. As bandeiras são aditivas. Os valores esperados são 1 para módulos, 2 para funções, 4 para BlockData.

Devoluções

Promise<TestRunCoverage[]>

getTestRunLogs(string, number)

Obter logs de mensagens de execução de teste

function getTestRunLogs(project: string, runId: number): Promise<TestMessageLogDetails[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da corrida a obter.

Devoluções

getTestRuns(string, string, string, string, number, boolean, boolean, number, number)

Obtenha uma lista de execuções de teste.

function getTestRuns(project: string, buildUri?: string, owner?: string, tmiRunId?: string, planId?: number, includeRunDetails?: boolean, automated?: boolean, skip?: number, top?: number): Promise<TestRun[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

buildUri

string

URI da compilação que as execuções usaram.

owner

string

ID da fundação da equipe do proprietário das execuções.

tmiRunId

string

planId

number

ID do plano de teste do qual as execuções fazem parte.

includeRunDetails

boolean

Se verdadeiro, inclua todas as propriedades das execuções.

automated

boolean

Se verdadeiro, retorna apenas execuções automatizadas.

skip

number

Número de execuções de teste a serem ignoradas.

top

number

Número de execuções de teste a serem retornadas.

Devoluções

Promise<TestRun[]>

getTestRunStatistics(string, number)

Obtenha estatísticas de execução de teste , usadas quando queremos obter um resumo de uma execução por resultado.

function getTestRunStatistics(project: string, runId: number): Promise<TestRunStatistic>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da corrida a obter.

Devoluções

Promise<TestRunStatistic>

getTestSessions(TeamContext, number, boolean, boolean, TestSessionSource, boolean)

Obter uma lista de sessões de teste

function getTestSessions(teamContext: TeamContext, period?: number, allSessions?: boolean, includeAllProperties?: boolean, source?: TestSessionSource, includeOnlyCompletedSessions?: boolean): Promise<TestSession[]>

Parâmetros

teamContext
TeamContext

O contexto da equipe para a operação

period

number

Período em dias a partir de agora, para o qual as sessões de teste são buscadas.

allSessions

boolean

Se false, retorna sessões de teste para o usuário atual. Caso contrário, ele retorna sessões de teste para todos os usuários

includeAllProperties

boolean

Se verdadeiro, ele retorna todas as propriedades das sessões de teste. Caso contrário, ele retorna a versão skinny.

source
TestSessionSource

Origem da sessão de teste.

includeOnlyCompletedSessions

boolean

Se verdadeiro, ele retorna sessões de teste no estado concluído. Caso contrário, ele retorna sessões de teste para todos os estados

Devoluções

Promise<TestSession[]>

getTestSettingsById(string, number)

function getTestSettingsById(project: string, testSettingsId: number): Promise<TestSettings>

Parâmetros

project

string

ID do projeto ou nome do projeto

testSettingsId

number

Devoluções

Promise<TestSettings>

getTestSubResultAttachmentContent(string, number, number, number, number)

Baixar um anexo de subresultado de teste

function getTestSubResultAttachmentContent(project: string, runId: number, testCaseResultId: number, attachmentId: number, testSubResultId: number): Promise<ArrayBuffer>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução de teste que contém o resultado.

testCaseResultId

number

ID dos resultados do teste que contém o subresultado.

attachmentId

number

ID do anexo do resultado do teste a ser baixado

testSubResultId

number

ID do subresultado do teste cujo anexo tem de ser descarregado

Devoluções

Promise<ArrayBuffer>

getTestSubResultAttachments(string, number, number, number)

Obter lista de anexos de subresultados de teste

function getTestSubResultAttachments(project: string, runId: number, testCaseResultId: number, testSubResultId: number): Promise<TestAttachment[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução de teste que contém o resultado.

testCaseResultId

number

ID dos resultados do teste que contém o subresultado.

testSubResultId

number

ID do subresultado do teste cujo anexo tem de ser descarregado

Devoluções

Promise<TestAttachment[]>

getTestSubResultAttachmentZip(string, number, number, number, number)

Baixar um anexo de subresultado de teste

function getTestSubResultAttachmentZip(project: string, runId: number, testCaseResultId: number, attachmentId: number, testSubResultId: number): Promise<ArrayBuffer>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução de teste que contém o resultado.

testCaseResultId

number

ID dos resultados do teste que contém o subresultado.

attachmentId

number

ID do anexo do resultado do teste a ser baixado

testSubResultId

number

ID do subresultado do teste cujo anexo tem de ser descarregado

Devoluções

Promise<ArrayBuffer>

processSuitesForStaging(StagedSuitesRequestModel, string, number)

Processa uma coleção de conjuntos de testes e retorna um modelo de resposta contendo detalhes do conjunto e do caso de teste.

function processSuitesForStaging(request: StagedSuitesRequestModel, project: string, workItemId: number): Promise<StagedSuitesResponseModel>

Parâmetros

request
StagedSuitesRequestModel

O modelo de solicitação que contém os conjuntos de testes a serem processados. Não pode ser nulo.

project

string

ID do projeto ou nome do projeto

workItemId

number

Devoluções

publishTestResultDocument(TestResultDocument, string, number)

function publishTestResultDocument(document: TestResultDocument, project: string, runId: number): Promise<TestResultDocument>

Parâmetros

project

string

ID do projeto ou nome do projeto

runId

number

Devoluções

queryCustomFields(string, CustomTestFieldScope)

function queryCustomFields(project: string, scopeFilter: CustomTestFieldScope): Promise<CustomTestFieldDefinition[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

scopeFilter
CustomTestFieldScope

Devoluções

queryResultTrendForBuild(TestResultTrendFilter, string)

function queryResultTrendForBuild(filter: TestResultTrendFilter, project: string): Promise<AggregatedDataForResultTrend[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

Devoluções

queryResultTrendForRelease(TestResultTrendFilter, string)

function queryResultTrendForRelease(filter: TestResultTrendFilter, project: string): Promise<AggregatedDataForResultTrend[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

Devoluções

queryTestHistory(TestHistoryQuery, string)

Obter histórico de um método de teste usando TestHistoryQuery

function queryTestHistory(filter: TestHistoryQuery, project: string): Promise<TestHistoryQuery>

Parâmetros

filter
TestHistoryQuery

TestHistoryQuery para obter o histórico

project

string

ID do projeto ou nome do projeto

Devoluções

Promise<TestHistoryQuery>

queryTestMethodLinkedWorkItems(string, string)

function queryTestMethodLinkedWorkItems(project: string, testName: string): Promise<TestToWorkItemLinks>

Parâmetros

project

string

ID do projeto ou nome do projeto

testName

string

Devoluções

queryTestResultHistory(ResultsFilter, string)

function queryTestResultHistory(filter: ResultsFilter, project: string): Promise<TestResultHistory>

Parâmetros

filter
ResultsFilter
project

string

ID do projeto ou nome do projeto

Devoluções

queryTestResultsMetaData(string[], string)

Obter lista de detalhes de metadados do resultado do teste para testcasereferenceId correspondente

function queryTestResultsMetaData(testReferenceIds: string[], project: string): Promise<TestResultMetaData[]>

Parâmetros

testReferenceIds

string[]

TestCaseReference Ids do teste Resultado a ser consultado, lista separada por vírgulas de ids válidas (limite nº de ids 200).

project

string

ID do projeto ou nome do projeto

Devoluções

Promise<TestResultMetaData[]>

queryTestResultsReportForBuild(string, number, string, boolean, BuildReference)

function queryTestResultsReportForBuild(project: string, buildId: number, publishContext?: string, includeFailureDetails?: boolean, buildToCompare?: BuildReference): Promise<TestResultSummary>

Parâmetros

project

string

ID do projeto ou nome do projeto

buildId

number

publishContext

string

includeFailureDetails

boolean

buildToCompare
BuildReference

Devoluções

queryTestResultsReportForRelease(string, number, number, string, boolean, ReleaseReference)

function queryTestResultsReportForRelease(project: string, releaseId: number, releaseEnvId: number, publishContext?: string, includeFailureDetails?: boolean, releaseToCompare?: ReleaseReference): Promise<TestResultSummary>

Parâmetros

project

string

ID do projeto ou nome do projeto

releaseId

number

releaseEnvId

number

publishContext

string

includeFailureDetails

boolean

releaseToCompare
ReleaseReference

Devoluções

queryTestResultsSummaryForReleases(ReleaseReference[], string)

function queryTestResultsSummaryForReleases(releases: ReleaseReference[], project: string): Promise<TestResultSummary[]>

Parâmetros

releases

ReleaseReference[]

project

string

ID do projeto ou nome do projeto

Devoluções

Promise<TestResultSummary[]>

queryTestResultWorkItems(string, string, string, number, Date, number, number)

function queryTestResultWorkItems(project: string, workItemCategory: string, automatedTestName?: string, testCaseId?: number, maxCompleteDate?: Date, days?: number, workItemCount?: number): Promise<WorkItemReference[]>

Parâmetros

project

string

ID do projeto ou nome do projeto

workItemCategory

string

automatedTestName

string

testCaseId

number

maxCompleteDate

Date

days

number

workItemCount

number

Devoluções

Promise<WorkItemReference[]>

queryTestRuns(string, Date, Date, TestRunState, number[], boolean, TestRunPublishContext, number[], number[], string, number[], number[], number[], number[], string, number, string)

O teste de consulta é executado com base em filtros. Os campos obrigatórios são minLastUpdatedDate e maxLastUpdatedDate.

function queryTestRuns(project: string, minLastUpdatedDate: Date, maxLastUpdatedDate: Date, state?: TestRunState, planIds?: number[], isAutomated?: boolean, publishContext?: TestRunPublishContext, buildIds?: number[], buildDefIds?: number[], branchName?: string, releaseIds?: number[], releaseDefIds?: number[], releaseEnvIds?: number[], releaseEnvDefIds?: number[], runTitle?: string, top?: number, continuationToken?: string): Promise<PagedList<TestRun>>

Parâmetros

project

string

ID do projeto ou nome do projeto

minLastUpdatedDate

Date

Data mínima da última modificação de execução a ser consultada (Obrigatório).

maxLastUpdatedDate

Date

Data máxima da última modificação de execução a ser consultada (Obrigatório, a diferença entre a data mínima e máxima pode ser de no máximo 7 dias).

state
TestRunState

Estado atual das Execuções a consultar.

planIds

number[]

Plan Ids of the Runs a ser consultado, lista separada por vírgulas de ids válidas (número limite de ids 10).

isAutomated

boolean

Tipo de automação das Execuções a serem consultadas.

publishContext
TestRunPublishContext

PublishContext das execuções a serem consultadas.

buildIds

number[]

Construir Ids das Execuções a serem consultadas, lista separada por vírgulas de ids válidas (número limite de ids 10).

buildDefIds

number[]

Construir Ids de definição das execuções a serem consultadas, lista separada por vírgulas de ids válidas (número limite de ids 10).

branchName

string

Nome da ramificação de origem das execuções a serem consultadas.

releaseIds

number[]

Liberar Ids das Execuções a serem consultadas, lista separada por vírgulas de ids válidas (limite nº de ids 10).

releaseDefIds

number[]

Ids de definição de liberação das execuções a serem consultadas, lista separada por vírgulas de ids válidas (número limite de ids 10).

releaseEnvIds

number[]

Liberar Ids de ambiente das execuções a serem consultadas, lista separada por vírgulas de ids válidas (limite nº de ids 10).

releaseEnvDefIds

number[]

Ids de definição de ambiente de liberação das execuções a serem consultadas, lista separada por vírgulas de ids válidas (número limite de ids 10).

runTitle

string

Execute o Título das Execuções a serem consultadas.

top

number

Número de execuções a consultar. O limite é 100

continuationToken

string

continuationToken recebido do lote anterior ou null para o primeiro lote. Ele não deve ser criado (ou alterado, se recebido do último lote) pelo usuário.

Devoluções

Promise<PagedList<TestRun>>

queryTestSummaryByRequirement(TestResultsContext, string, number[])

function queryTestSummaryByRequirement(resultsContext: TestResultsContext, project: string, workItemIds?: number[]): Promise<TestSummaryForWorkItem[]>

Parâmetros

resultsContext
TestResultsContext
project

string

ID do projeto ou nome do projeto

workItemIds

number[]

Devoluções

removeTestCasesFromSuiteUrl(string, number, number, string)

Os pontos de teste associados aos casos de teste são removidos do conjunto de testes. O item de trabalho do caso de teste não é excluído do sistema. Consulte o recurso de casos de teste para excluir um caso de teste permanentemente.

function removeTestCasesFromSuiteUrl(project: string, planId: number, suiteId: number, testCaseIds: string): Promise<void>

Parâmetros

project

string

ID do projeto ou nome do projeto

planId

number

ID do plano de teste que contém o conjunto.

suiteId

number

ID da suíte a ser obtida.

testCaseIds

string

IDs dos casos de teste a serem removidos do pacote.

Devoluções

Promise<void>

updateCodeCoverageSummary(CodeCoverageData, string, number)

http://(tfsserver):8080/tfs/DefaultCollection/_apis/test/CodeCoverage?buildId=10 Solicitação: Json do resumo da cobertura do código

function updateCodeCoverageSummary(coverageData: CodeCoverageData, project: string, buildId: number): Promise<void>

Parâmetros

coverageData
CodeCoverageData
project

string

ID do projeto ou nome do projeto

buildId

number

Devoluções

Promise<void>

updateResultRetentionSettings(ResultRetentionSettings, string)

Atualizar as configurações de retenção de resultados de teste

function updateResultRetentionSettings(retentionSettings: ResultRetentionSettings, project: string): Promise<ResultRetentionSettings>

Parâmetros

retentionSettings
ResultRetentionSettings

Detalhes das configurações de retenção de resultados do teste a serem atualizados

project

string

ID do projeto ou nome do projeto

Devoluções

updateSuiteTestCases(SuiteTestCaseUpdateModel, string, number, number, string)

Atualiza as propriedades da associação de caso de teste em um pacote.

function updateSuiteTestCases(suiteTestCaseUpdateModel: SuiteTestCaseUpdateModel, project: string, planId: number, suiteId: number, testCaseIds: string): Promise<SuiteTestCase[]>

Parâmetros

suiteTestCaseUpdateModel
SuiteTestCaseUpdateModel

Modelo para atualização das propriedades da associação do conjunto de casos de teste.

project

string

ID do projeto ou nome do projeto

planId

number

ID do plano de teste que contém o conjunto.

suiteId

number

ID do conjunto de testes ao qual os casos de teste devem ser adicionados.

testCaseIds

string

IDs dos casos de teste para adicionar ao pacote. As ids são especificadas em formato separado por vírgula.

Devoluções

Promise<SuiteTestCase[]>

updateTestPoints(PointUpdateModel, string, number, number, string)

Atualize os pontos de teste.

function updateTestPoints(pointUpdateModel: PointUpdateModel, project: string, planId: number, suiteId: number, pointIds: string): Promise<TestPoint[]>

Parâmetros

pointUpdateModel
PointUpdateModel

Dados a atualizar.

project

string

ID do projeto ou nome do projeto

planId

number

ID do plano de teste.

suiteId

number

ID da suíte que contém os pontos.

pointIds

string

ID do ponto de teste a obter. Use uma lista separada por vírgulas de IDs para atualizar vários pontos de teste.

Devoluções

Promise<TestPoint[]>

updateTestResults(TestCaseResult[], string, number)

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

function updateTestResults(results: TestCaseResult[], project: string, runId: number): Promise<TestCaseResult[]>

Parâmetros

results

TestCaseResult[]

Lista de resultados de testes a atualizar.

project

string

ID do projeto ou nome do projeto

runId

number

ID de execução de teste cujos resultados de teste devem ser atualizados.

Devoluções

Promise<TestCaseResult[]>

updateTestRun(RunUpdateModel, string, number)

Teste de atualização executado por seu ID.

function updateTestRun(runUpdateModel: RunUpdateModel, project: string, runId: number): Promise<TestRun>

Parâmetros

runUpdateModel
RunUpdateModel

Detalhes da execução: RunUpdateModel

project

string

ID do projeto ou nome do projeto

runId

number

ID da execução a atualizar.

Devoluções

Promise<TestRun>

updateTestSession(TestSession, TeamContext)

Atualizar uma sessão de teste

function updateTestSession(testSession: TestSession, teamContext: TeamContext): Promise<TestSession>

Parâmetros

testSession
TestSession

Detalhes da sessão de teste para atualização

teamContext
TeamContext

O contexto da equipe para a operação

Devoluções

Promise<TestSession>