RunVisualStudioTestsusingTestAgent@1 - Executar a tarefa de testes funcionais v1

RunVisualStudioTestsusingTestAgent@1 e a respetiva tarefa complementar (Implementação do Agente de Teste do Visual Studio) são preteridas. Em alternativa, utilize a tarefa de Teste do Visual Studio. A tarefa VSTest pode executar unidades, bem como testes funcionais. Execute testes num ou mais agentes com a definição de tarefa multi-agente. Utilize a tarefa Plataforma de Teste do Visual Studio para executar testes sem precisar do Visual Studio no agente. A tarefa VSTest também traz novas capacidades, como executar automaticamente testes com falhas.

Syntax

# Run functional tests v1
# Deprecated: This task and it’s companion task (Visual Studio Test Agent Deployment) are deprecated. Use the 'Visual Studio Test' task instead. The VSTest task can run unit as well as functional tests. Run tests on one or more agents using the multi-agent job setting. Use the 'Visual Studio Test Platform' task to run tests without needing Visual Studio on the agent. VSTest task also brings new capabilities such as automatically rerunning failed tests.
- task: RunVisualStudioTestsusingTestAgent@1
  inputs:
  # Setup Options
    testMachineGroup: # string. Required. Machines. 
    dropLocation: # string. Required. Test Drop Location. 
  # Execution Options
    testSelection: 'testAssembly' # 'testAssembly' | 'testPlan'. Required. Test Selection. Default: testAssembly.
    #testPlan: # string. Required when testSelection = testPlan. Test Plan. 
    #testSuite: # string. Required when testSelection = testPlan. Test Suite. 
    #testConfiguration: # string. Required when testSelection = testPlan. Test Configuration. 
    sourcefilters: '**\*test*.dll' # string. Required when testSelection = testAssembly. Test Assembly. Default: **\*test*.dll.
    #testFilterCriteria: # string. Optional. Use when testSelection = testAssembly. Test Filter criteria. 
    #runSettingsFile: # string. Run Settings File. 
    #overrideRunParams: # string. Override Test Run Parameters. 
    #codeCoverageEnabled: false # boolean. Code Coverage Enabled. Default: false.
    #customSlicingEnabled: false # boolean. Distribute tests by number of machines. Default: false.
  # Reporting Options
    #testRunTitle: # string. Test Run Title. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #testConfigurations: # string. Test Configurations. 
    #autMachineGroup: # string. Application Under Test Machines.

Entradas

testMachineGroup - Computadores
string. Obrigatório.

Uma lista separada por vírgulas de FQDNs ou endereços IP do computador, que podem incluir o número da porta. O máximo é de 32 computadores ou 32 agentes. Os itens da lista podem ser:

• O nome de um Grupo de Recursos do Azure.
• Uma lista delimitada por vírgulas de nomes de máquinas. Exemplo: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
• Uma variável de saída de uma tarefa anterior.

dropLocation - Localização da Remoção de Testes
string. Obrigatório.

Especifica a localização nos computadores de teste onde os binários de teste foram copiados por uma Cópia de Ficheiro do Windows Machine ou uma tarefa de Cópia de Ficheiros do Azure . As variáveis de fase de sistema dos computadores do agente de teste podem ser utilizadas para especificar a localização de remoção. Exemplos: c:\tests e %systemdrive%\Tests.

testSelection - Testar Seleção
string. Obrigatório. Valores permitidos: testAssembly (Assemblagem de Teste), testPlan (Plano de Teste). Valor predefinido: testAssembly.

Especifica a forma como os testes são executados: com assemblagens de teste ou Plano de Teste.

testPlan - Plano de Teste
string. Necessário quando testSelection = testPlan.

Especifica um plano de teste que já está configurado para esta organização.

testSuite - Test Suite
string. Necessário quando testSelection = testPlan.

Especifica um conjunto de testes do plano de teste selecionado.

testConfiguration - Configuração do Teste
string. Necessário quando testSelection = testPlan.

Especifica uma configuração de teste do plano de teste selecionado.

sourcefilters - Assemblagem de Teste
string. Necessário quando testSelection = testAssembly. Valor predefinido: **\*test*.dll.

Especifica os binários de teste em que os testes são executados. Podem ser utilizados carateres universais. Por exemplo, **\*test*.dll; para todos os .dll ficheiros que test contêm o nome do ficheiro.

testFilterCriteria - Critérios de Filtro de Teste
string. Opcional. Utilize quando testSelection = testAssembly.

O filtro que especifica os testes a executar nos ficheiros de assemblagem de teste. Funciona da mesma forma que a opção /TestCaseFilter em vstest.console.exe. Exemplo: Owner=james&Priority=1.

runSettingsFile - Executar Ficheiro de Definições
string.

Especifica o caminho de ficheiro para o runsettings ficheiro ou testsettings a utilizar com os testes.

overrideRunParams - Substituir Parâmetros de Execução de Teste
string.

Especifica os parâmetros de substituição definidos na TestRunParameters secção do runsettings ficheiro ou na Properties secção do testsettings ficheiro. Exemplo: AppURL=$(DeployURL);Port=8080.

Nota

As propriedades especificadas no ficheiro podem ser acedidas através TestContext da testsettings Atualização 4 ou superior do Test Agent 2017.

codeCoverageEnabled - Cobertura do Código Ativada
boolean. Valor predefinido: false.

Especifica se a Cobertura de Código está ativada para a tarefa.

customSlicingEnabled - Distribuir testes por número de máquinas
boolean. Valor predefinido: false.

Quando o valor deste valor booleano está definido como true, os testes são distribuídos com base no número de máquinas fornecidas em vez do número de contentores de teste.

Nota

Os testes num .dll também podem ser distribuídos por várias máquinas.

testRunTitle - Título da Execução de Teste
string.

Especifica um nome para a execução de teste.

platform - Plataforma
string.

Especifica a plataforma na qual os testes devem ser comunicados. Se tiver definido uma variável para platform na sua tarefa de compilação, utilize a variável como o valor.

configuration - Configuração
string.

Especifica a configuração na qual os testes devem ser comunicados. Se tiver definido uma variável para configuration na sua tarefa de compilação, utilize a variável como o valor.

testConfigurations - Configurações de Teste
string.

Opcional. Associa um filtro de caso de teste a um ID de configuração de teste. Sintaxe: <Filter1>:<Id1>;DefaultTestConfiguration:<Id3>. Exemplo: FullyQualifiedName~Chrome:12.

autMachineGroup - Aplicação Em Máquinas de Teste
string.

Uma lista separada por vírgulas de máquinas, variáveis de saída ou nomes de grupos de máquinas nos quais os processos do servidor, como W3WP.exe, estão em execução.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agente
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de definição	Qualquer
Versão do agente	1.104.0 ou superior
Categoria da tarefa	Teste