Dela via

AzureTestPlan@0 – Uppgift för Azure Test Plan v0

Kör manuella och automatiserade tester i testplanen i Java, JavaScript och Python.

Anmärkning

Den här uppgiften är i offentlig förhandsversion.

Syntax

# 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.

Ingångar

testSelector - Testfall som ska utföras
string. Obligatoriskt. Tillåtna värden: manualTests (Manuella tester), automatedTests (Automatiserade tester).

  • Manuella tester: Använd det här alternativet för att utlösa manuella tester från testplanen.
  • Automatiserade tester: Använd det här alternativet om du vill köra tester från din testplan som har en automatiserad testmetod kopplad till sig.
    • .

testPlanOrRunSelector - Välj tester med hjälp av
string. Obligatoriskt. Tillåtna värden: testPlan (Testplan), testRun (Testkörning). Standardvärde: testPlan.

  • Testmontering: Använd det här alternativet om du vill ange en eller flera testsammansättningar som innehåller dina tester. Du kan också ange ett filtervillkor för att endast välja specifika tester.
  • Testplan: Använd det här alternativet om du vill köra tester från testplanen som har en automatiserad testmetod kopplad till sig.
  • Testkörning: Använd det här alternativet när du konfigurerar en miljö för att köra tester från testhubben. Det här alternativet bör inte användas när du kör tester i en CI/CD-pipeline (kontinuerlig integrering/kontinuerlig distribution).
    • .

testRunId - Testkörning
string. Krävs när testPlanOrRunSelector = testRun. Standardvärde: $(test.RunId).

Testkörningsbaserat urval används när man utlöser automatiserade testkörningar från testhubben, värdet för detta ska behållas som det är.


testPlan - testplan
string. Krävs när testPlanOrRunSelector = testPlan.

Skriv eller klistra in testplans-ID:t som innehåller testpaket med testfall.


testSuite - Testsvit
string. Krävs när testPlanOrRunSelector = testPlan.

Välj en eller flera testsvit som innehåller testfall.


testConfiguration - Testkonfiguration
string. Obligatoriskt.

Välj Testkonfiguration.


testLanguageInput - Välj språk för testramverket
string. Tillåtna värden: JavaMaven (Java – Maven), JavaGradle (Java – Gradle), Python (Python – PyTest), JavaScriptJest (JavaScript – Jest).

Testramverk Språk för automatiserade tester i testplanen.


pomFilePath - Sökväg till pom-fil
string. Valfritt. Använd när testLanguageInput = JavaMaven.

Relativ sökväg från lagringsplatsens rot till Maven POM-filen.


gradleFilePath - Sökväg till Gradle-fil
string. Valfritt. Använd när testLanguageInput = JavaGradle.

Relativ sökväg från databasroten till build.gradle-filen.


publishRunAttachments - Ladda upp testresultatfiler
boolean. Standardvärde: true.

Ladda upp loggar och andra filer som innehåller diagnostikinformation som samlades in när testerna kördes.


failTaskOnFailedTests - Misslyckas om det finns testfel
boolean. Standardvärde: true.

Misslyckas med uppgiften om det finns några testfel. Markera det här alternativet om du vill misslyckas med aktiviteten om testfel identifieras i resultatfilerna.


failTaskOnFailureToPublishResults - Misslyckas om det inte går att publicera testresultat
boolean. Standardvärde: false.

Misslyckas om det inte går att publicera testresultat. Markera det här alternativet om du vill misslyckas med uppgiften om publiceringen av testresultat misslyckades delvis.


failTaskOnMissingResultsFile - misslyckas om inga resultatfiler hittas
boolean. Standardvärde: false.

Uppgiften misslyckas om inga resultatfiler hittas.


Alternativ för uppgiftskontroll

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Integrera dina automatiserade tester med en testplan

Följ stegen nedan för att integrera dina automatiserade tester med manuella testfall och köra dem från testplaner eller via Azure Test Plan-uppgiften i dina bygg-pipelines:

  1. Se till att projektet finns i Azure DevOps Repos (eller GitHub Repos).

  2. Skapa en pipeline som kör testerna med hjälp av uppgifter som Gradle eller Maven. Om dina tester redan körs som en del av en befintlig pipeline kan du hoppa över det här steget. Det är viktigt att köra testerna – först efter att de har körts minst en gång kommer de att vara tillgängliga för koppling till manuella testfall.

     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

  3. Nästa steg är att länka testfallen från fliken Test i pipelinekörningssammanfattningen till ett manuellt arbetsobjekt för testfall. Det gör du genom att skapa ett nytt testfall eller använda ett befintligt (observera kolumnen Automationsstatus för TC4):

    Skärmdump av ett testfall utan automatisering.

  4. När du har ett testfall går du tillbaka till sammanfattningssidan för pipelinekörningen och associerar det automatiserade testet med testfallet.

    Skärmbild av associationsupplevelsen i Azure Pipelines

  5. Så här kan du se om ett manuellt testfall har ett associerat automatiserat test:

    Skärmdump av ett testfall med automatisering.

    Skärmdump av ett testfall med ett tillhörande automatiserat test.

  6. Nu när testfallet är associerat med ett manuellt arbetsobjekt för testfall kan du köra det som en del av en pipeline genom att skicka testplanen som ett argument i Azure Test Plan-uppgiften.

    trigger: none
pool:
  vmImage: ubuntu-latest

steps:
- task: AzureTestPlan@0
  inputs:
    testSelector: 'automatedTests'
    testPlanOrRunSelector: 'testPlan'
    testPlan: '21294'
    testSuite: '229461'
    testConfiguration: '82'
    testLanguageInput: 'JavaGradle'

Spara och kör pipelineskriptet.

Här är sammanfattningen av pipeline-resultatet, som visar resultatet för TC4 tillsammans med andra testfall:

Skärmbild av den associerade automatiseringsfliken.

Kravspecifikation

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
Krav Ingen
Kapaciteter Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar Vilken som helst
variabler som kan Vilken som helst
Agentversion 2.144.0 eller senare
Aktivitetskategori Test