AzureTestPlan@0 - Azure Test Plan v0 taak

Voer handmatige en geautomatiseerde tests uit in het testplan in Java, JavaScript en Python.

Opmerking

Deze taak bevindt zich in openbare preview.

Syntaxis

# Azure Test Plan v0
# Run manual and automated tests points of test plan for different testing frameworks like Maven and Gradle for Java, PyTest for Python and Jest for JavaScript.
- task: AzureTestPlan@0
  inputs:
    testSelector: # 'manualTests' | 'automatedTests'. Required. Test cases to be executed. 
    testPlanOrRunSelector: 'testPlan' # 'testPlan' | 'testRun'. Required. Select tests using. Default: testPlan.
    #testRunId: '$(test.RunId)' # string. Required when testPlanOrRunSelector = testRun. Test Run. Default: $(test.RunId).
    testPlan: # string. Required when testPlanOrRunSelector = testPlan. Test plan. 
    testSuite: # string. Required when testPlanOrRunSelector = testPlan. Test suite. 
    testConfiguration: # string. Required. Test configuration. 
    #testLanguageInput: # 'JavaMaven' | 'JavaGradle' | 'Python' | 'JavaScriptJest'. Select Test framework language. 
    #pomFilePath: # string. Optional. Use when testLanguageInput = JavaMaven. Pom file path. 
    #gradleFilePath: # string. Optional. Use when testLanguageInput = JavaGradle. Gradle file path. 
    #failTaskOnFailedTests: true # boolean. Fail if there are test failures. Default: true.
    #failTaskOnFailureToPublishResults: false # boolean. Fail if there is failure in publishing test results. Default: false.
    #failTaskOnMissingResultsFile: false # boolean. Fail if no result files are found. Default: false.
  # advanced
    #publishRunAttachments: true # boolean. Upload test results files. Default: true.

Invoer

testSelector - Uit te voeren testcases
string. Verplicht. Toegestane waarden: manualTests (Handmatige tests), automatedTests (Geautomatiseerde tests).

• Handmatige tests: Gebruik deze optie om handmatige tests vanuit uw testplan te activeren.
• Geautomatiseerde tests: Gebruik deze optie om tests uit te voeren vanuit uw testplan waaraan een geautomatiseerde testmethode is gekoppeld.
.

testPlanOrRunSelector - Tests selecteren met behulp van
string. Verplicht. Toegestane waarden: testPlan (Testplan), testRun (Testrun). Standaardwaarde: testPlan.

• Test assemblage: Gebruik deze optie om een of meer testassemblages op te geven die uw tests bevatten. U kunt desgewenst een filtercriteria opgeven om alleen specifieke tests te selecteren.
• Testplan: Gebruik deze optie om tests uit te voeren vanuit uw testplan waaraan een geautomatiseerde testmethode is gekoppeld.
• Proefdraaien: Gebruik deze optie wanneer u een omgeving instelt om tests uit te voeren vanuit de testhub. Deze optie mag niet worden gebruikt bij het uitvoeren van tests in een pijplijn voor continue integratie / continue implementatie (CI/CD).
.

testRunId - testuitvoering
string. Vereist wanneer testPlanOrRunSelector = testRun. Standaardwaarde: $(test.RunId).

Selectie op basis van testruns wordt gebruikt bij het activeren van geautomatiseerde testruns vanuit de testhub, de waarde hiervoor moet worden behouden zoals deze is.

testPlan - Testplan
string. Vereist wanneer testPlanOrRunSelector = testPlan.

Typ of plak de testplan-ID met testsuites met testcases.

testSuite - testpakket
string. Vereist wanneer testPlanOrRunSelector = testPlan.

Selecteer een of meer testsuites met testcases.

testConfiguration - configuratie testen
string. Verplicht.

Selecteer Testconfiguratie.

testLanguageInput - Selecteer de taal van het toetsframework
string. Toegestane waarden: JavaMaven (Java - Maven), JavaGradle (Java - Gradle), Python (Python - PyTest), JavaScriptJest (JavaScript - Jest).

Testkader Taal van geautomatiseerde tests in testplan.

pomFilePath - Pad voor POM-bestand
string. Facultatief. Gebruiken wanneer testLanguageInput = JavaMaven.

Relatief pad van de hoofdmap van de repository naar het Maven POM-bestand.

gradleFilePath - Gradle bestandspad
string. Facultatief. Gebruiken wanneer testLanguageInput = JavaGradle.

Relatief pad van de hoofdmap van de repository naar het build.gradle-bestand.

publishRunAttachments - Upload bestanden met testresultaten
boolean. Standaardwaarde: true.

Upload logboeken en andere bestanden met diagnostische informatie die is verzameld tijdens het uitvoeren van de tests.

failTaskOnFailedTests - Mislukt als er testfouten zijn
boolean. Standaardwaarde: true.

Mislukt de taak als er testfouten zijn. Schakel deze optie in om de taak te laten mislukken als er testfouten worden gedetecteerd in de resultatenbestanden.

failTaskOnFailureToPublishResults - Mislukt als er een fout optreedt bij het publiceren van testresultaten
boolean. Standaardwaarde: false.

Mislukt als er een fout optreedt bij het publiceren van testresultaten. Schakel deze optie in om de taak te laten mislukken als het publiceren van testresultaten gedeeltelijk is mislukt.

failTaskOnMissingResultsFile - Mislukt als er geen resultaatbestanden worden gevonden
boolean. Standaardwaarde: false.

Mislukt de taak als er geen resultaatbestanden worden gevonden.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Integreer uw geautomatiseerde tests met een testplan

Volg de onderstaande stappen om uw geautomatiseerde tests te integreren met handmatige testcases en deze uit te voeren vanuit testplannen of via de Azure-testplantaak in uw build-pijplijnen:

1. Zorg ervoor dat uw project zich in Azure DevOps Repos (of GitHub Repos) bevindt.

2. Maak een pijplijn waarmee de tests worden uitgevoerd met behulp van taken zoals Gradle of Maven. Als uw tests al zijn uitgevoerd als onderdeel van een bestaande pijplijn, kunt u deze stap overslaan. Het uitvoeren van de tests is essentieel: pas nadat ze ten minste één keer zijn uitgevoerd, zijn ze beschikbaar voor associatie met handmatige testgevallen.

   Gradle

    trigger: none
   
    pool:
      vmImage: ubuntu-latest
   
    steps:
    - task: Gradle@3
      inputs:
        gradleWrapperFile: 'gradlew'
        workingDirectory: '$(Build.SourcesDirectory)'
        tasks: 'build'
        publishJUnitResults: true
        testResultsFiles: '**/TEST-*.xml'
        testRunTitle: 'gridinitialexecution'
        javaHomeOption: 'JDKVersion'
        sonarQubeRunAnalysis: false
        spotBugsAnalysis: false
   

   Maven

     trigger: none
   
     variables:
     - name: system.debug
       value: true
   
     pool:
       vmImage: ubuntu-latest
   
     steps:
     - task: Maven@4
       inputs:
         mavenPomFile: 'pom.xml'
         publishJUnitResults: true
         testResultsFiles: '**/surefire-reports/TEST-*.xml'
         javaHomeOption: 'JDKVersion'
         mavenVersionOption: 'Default'
         mavenAuthenticateFeed: false
         effectivePomSkip: false
         sonarQubeRunAnalysis: false
   

   Python

   trigger: none    
   pool:
     vmImage: windows-latest
   
   steps:
   - task: UsePythonVersion@0
     inputs:
       versionSpec: '3.8.10'
       addToPath: true
       displayName: 'Use Python $(python.version)'
   
   - script: |
      pip install pytest pytest-azurepipelines
      pytest
     displayName: 'pytest'
   

3. De volgende stap is het koppelen van de testcases van het tabblad Test van de samenvatting van de pijplijnuitvoering aan een handmatig werkitem voor testcases. Maak hiervoor een nieuwe testcase of gebruik een bestaande (let op de kolom Automatiseringsstatus voor TC4):

   

4. Zodra u een testcase hebt, keert u terug naar de overzichtspagina van de pijplijnuitvoering en koppelt u uw geautomatiseerde test aan de testcase.

   

5. Zo kunt u zien of een handmatige testcase een bijbehorende geautomatiseerde test heeft:

   

   

6. Nu de testcase is gekoppeld aan een handmatig werkitem voor testcases, kunt u deze uitvoeren als onderdeel van een pijplijn door het testplan door te geven als een argument in de Azure-testplantaak.

   trigger: none
   pool:
     vmImage: ubuntu-latest
   
   steps:
   - task: AzureTestPlan@0
     inputs:
       testSelector: 'automatedTests'
       testPlanOrRunSelector: 'testPlan'
       testPlan: '21294'
       testSuite: '229461'
       testConfiguration: '82'
       testLanguageInput: 'JavaGradle'
   

Sla de pijplijn op en voer deze uit.

Hier is de samenvatting van de pijplijnresultaten, die de uitkomst voor TC4 samen met andere testgevallen laat zien:

Behoeften

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welke dan ook
variabelen instellen	Welke dan ook
Agentversie	2.144.0 of hoger
Taakcategorie	Testen