RunVisualStudioTestsusingTestAgent@1 - Exécuter des tests fonctionnels v1

RunVisualStudioTestsusingTestAgent@1 et sa tâche complémentaire (déploiement de l’agent de test Visual Studio) sont déconseillés. Utilisez plutôt la tâche de test Visual Studio. La tâche VSTest peut exécuter des tests unitaires et fonctionnels. Exécutez des tests sur un ou plusieurs agents à l’aide du paramètre de travail multi-agents. Utilisez la tâche Visual Studio Test Platform pour exécuter des tests sans avoir besoin de Visual Studio sur l’agent. La tâche VSTest apporte également de nouvelles fonctionnalités, telles que la réexécution automatique des tests ayant échoué.

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.

Entrées

testMachineGroup - Machines
string. Obligatoire.

Liste séparée par des virgules des noms de domaine complets ou des adresses IP de l’ordinateur, qui peut inclure le numéro de port. Le maximum est de 32 machines ou 32 agents. Les éléments de liste peuvent être :

• Nom d’un groupe de ressources Azure.
• Liste de noms d’ordinateurs délimités par des virgules. Exemple : dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
• Variable de sortie d’une tâche précédente.

dropLocation - Emplacement de la chute de test
string. Obligatoire.

Spécifie l’emplacement sur les ordinateurs de test où les fichiers binaires de test ont été copiés par une copie de fichier machine Windows ou une tâche de copie de fichiers Azure . Les variables d’index de système provenant des machines de l’agent de test peuvent être utilisées pour spécifier l’emplacement de dépôt. Exemples : c:\tests et %systemdrive%\Tests.

testSelection - Sélection des tests
string. Obligatoire. Valeurs autorisées : testAssembly (Assembly de test), testPlan (Plan de test). Valeur par défaut : testAssembly.

Spécifie comment les tests sont exécutés : à l’aide d’assemblys de test ou d’un plan de test.

testPlan - Test Plan
string. Nécessaire lorsque testSelection = testPlan.

Spécifie un plan de test déjà configuré pour cette organization.

testSuite - Suite de tests
string. Nécessaire lorsque testSelection = testPlan.

Spécifie une suite de tests à partir du plan de test sélectionné.

testConfiguration - Test Configuration
string. Nécessaire lorsque testSelection = testPlan.

Spécifie une configuration de test à partir du plan de test sélectionné.

sourcefilters - Tester l’assembly
string. Nécessaire lorsque testSelection = testAssembly. Valeur par défaut : **\*test*.dll.

Spécifie les fichiers binaires de test sur 2000 sur 1000. Des caractères génériques peuvent être utilisés. Par exemple, **\*test*.dll; pour tous les .dll fichiers contenant test dans le nom de fichier.

testFilterCriteria - Critères de filtre de test
string. facultatif. Utilisez quand testSelection = testAssembly.

Filtre qui specfifie les tests à exécuter dans les fichiers d’assembly de test. Fonctionne de la même façon que l’option /TestCaseFilter dans vstest.console.exe. Exemple : Owner=james&Priority=1.

runSettingsFile - Fichier de paramètres d’exécution
string.

Spécifie le chemin d’accès au runsettings fichier ou testsettings à utiliser avec les tests.

overrideRunParams - Remplacer les paramètres de la série de tests
string.

Spécifie les paramètres de remplacement définis dans la TestRunParameters section du runsettings fichier ou dans la Properties section du testsettings fichier. Exemple : AppURL=$(DeployURL);Port=8080.

Notes

Les propriétés spécifiées dans le testsettings fichier sont accessibles via TestContext l’agent de test 2017 Update 4 ou version ultérieure.

codeCoverageEnabled - Couverture du code activée
boolean. Valeur par défaut : false.

Spécifie si la couverture du code est activée pour la tâche.

customSlicingEnabled - Distribuer les tests par nombre de machines
boolean. Valeur par défaut : false.

Lorsque la valeur de cette valeur booléenne est définie sur true, les tests sont distribués en fonction du nombre de machines fournies au lieu du nombre de conteneurs de test.

Notes

Les tests au sein d’un .dll peuvent également être distribués à plusieurs ordinateurs.

testRunTitle - Titre de la série de tests
string.

Spécifie un nom pour la série de tests.

platform - Plate-forme
string.

Spécifie la plateforme sur laquelle les tests doivent être signalés. Si vous avez défini une variable pour platform dans votre tâche de génération, utilisez la variable comme valeur.

configuration - Configuration
string.

Spécifie la configuration par rapport à laquelle les tests doivent être signalés. Si vous avez défini une variable pour configuration dans votre tâche de génération, utilisez la variable comme valeur.

testConfigurations - Test Configurations
string.

facultatif. Associe un filtre de cas de test à un ID de configuration de test. Syntaxe : <Filter1>:<Id1>;DefaultTestConfiguration:<Id3>. Exemple : FullyQualifiedName~Chrome:12.

autMachineGroup - Application sous machines de test
string.

Liste séparée par des virgules des machines, des variables de sortie ou des noms de groupes de machines sur lesquels les processus serveur, tels que W3WP.exe, sont en cours d’exécution.

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent
Demandes	None
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes	Quelconque
Variables settables	Quelconque
Version de l’agent	1.104.0 ou version ultérieure
Catégorie de la tâche	Test