Een query maken op basis van opbouw- en testintegratievelden

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Werkitemvelden die ondersteuning bieden voor build- en testintegratie ondersteunen de volgende acties:

  • Fouten koppelen aan de builds waar ze zijn gevonden of opgelost
  • Query uitvoeren op fouten die zijn gekoppeld aan een build
  • Testcases markeren als handmatig of geautomatiseerd en informatie opslaan ter ondersteuning van geautomatiseerde testcases
  • Voor testcases en gedeelde stappen definieert u de actie- en validatiestappen en de gegevens die worden gebruikt om tests uit te voeren.

Ondersteunde operators en macro's

De meeste build- en testintegratievelden hebben een gegevenstype Tekenreeks, PlainText of HTML. Queryclausules die een tekst- of rtf-tekstveld opgeven, kunnen de operatoren en macro's gebruiken die in de volgende tabel worden vermeld.

Gegevenstype

Ondersteunde operators en macro's

Rtf-tekst (HTML) en
Tekenreeksen met meerdere regels (PlainText)

Contains Words, , Does Not Contain WordsIs Empty, . Is Not Empty
De Is Empty en Is Not Empty operators worden ondersteund voor Azure DevOps Server 2019 RC2 en latere versies.

Eén tekst (tekenreeks)

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], , ContainsDoes Not Contain, In, , Not In, , In GroupNot In GroupWas Ever
Macro's: [Any], geldig met het veld Type werkitem ; en @Project, geldig met het veld Teamproject . Het systeem wordt automatisch gefilterd op basis van het huidige project. Zie Query's in verschillende projecten voor meer informatie.

Nuttige filters

Filteren op

Deze queryclausules opnemen

Geautomatiseerde testcases

        Work Item Type = Test Case And Automation Status = Automated

Op query's gebaseerde testsuites

        Work Item Type = Test Suite And Test Suite Type = Query Based

Testsuites op basis van vereisten

        Work Item Type = Test Suite And Test Suite Type = Requirement Based

Fouten en de testcases vermelden die ze testen

Open een nieuwe query, stel het querytype in op Werkitems en directe koppelingen. Filter op bugs op het hoogste niveau en voeg het filter voor testcases toe in het filter voor gekoppelde werkitems.

Fouten en de testcases vermelden die ze testen

Notitie

U kunt geen query maken waarin een hiërarchische weergave van testplannen, testsuites en testcases wordt weergegeven. Deze items worden niet aan elkaar gekoppeld met behulp van koppelingstypen tussen bovenliggende en onderliggende items. U kunt de hiërarchie bekijken via de pagina Testplannen>.

Gegevensvelden bouwen en testen

In de volgende tabel worden de velden beschreven die zijn gedefinieerd in een of meer test-WIT's. Zie Werkitemvelden en -kenmerken voor informatie over gegevenstypen en veldkenmerken.

Als u een veld of selectielijst wilt aanpassen, raadpleegt u Een veld toevoegen of wijzigen ter ondersteuning van query's, rapporten en werkstroom.

Veldnaam

Beschrijving

Type werkitem

Automation-status 1

De status van een testcase. U kunt de volgende waarden opgeven:

Testscenario

Gevonden in 2

Productbuildnummer, ook wel revisie genoemd, waarin een fout is gevonden.
Verwijzingsnaam=Microsoft.VSTS.Build.FoundIn, gegevenstype=Tekenreeks

Notitie

U kunt ook het type gevonden in de buildkoppeling gebruiken om een werkitem te koppelen aan een build. Dit koppelingstype is beschikbaar vanuit Azure DevOps en werkt alleen met de huidige buildprocessen (niet XAML-builds).

Fout

Integratie build 2

Productbuildnummer dat de code bevat of een bug oplost.
Referentienaam=Microsoft.VSTS.Build.IntegrationBuild, gegevenstype=Tekenreeks

Notitie

U kunt ook het type geïntegreerde buildkoppeling gebruiken om een werkitem te koppelen aan een build. Dit koppelingstype is beschikbaar vanuit Azure DevOps en werkt alleen met de huidige buildprocessen (niet XAML-builds).

Alle

Probleem

Geeft aan dat de gedeelde stappen zijn gekoppeld aan een verwacht resultaat. Toegestane waarden zijn Ja en Nee. Verwijzingsnaam=Microsoft.VSTS.Common.Issue, Gegevenstype=Tekenreeks

Gedeelde stappen

Parameters

Bevat de parameters die moeten worden gebruikt bij het uitvoeren van een handmatige test.
Microsoft.VSTS.TCM.Parameters, gegevenstype=HTML

Gedeelde parameters, gedeelde stappen, testcase

Stappen

De actie- en validatiestappen die nodig zijn om de test uit te voeren. Microsoft.VSTS.TCM.Steps, gegevenstype=HTML

Gedeelde stappen, testcase

Systeemgegevens

Informatie over de software- en systeemconfiguratie die relevant is voor de test.
Microsoft.VSTS.TCM.SystemInfo, gegevenstype=HTML

Fout, antwoord op feedback

Stappen voor opnieuwpropro (of stappen om te reproduceren)

De stappen die nodig zijn om onverwacht gedrag te reproduceren. Leg voldoende informatie vast zodat andere teamleden de volledige impact van het probleem kunnen begrijpen en of ze de fout hebben opgelost. Dit omvat acties die worden ondernomen om de bug en het verwachte gedrag te vinden of te reproduceren. Verwijzingsnaam=Microsoft.VSTS.TCM.ReproSteps, gegevenstype=HTML

Fout

Test Suite type 1

De categorie testsuite. Toegestane waarden zijn:

  • Op basis van query: gebruik dit om testcases te groeperen die een bepaald kenmerk hebben, bijvoorbeeld alle tests met Priority=1. De suite bevat automatisch elke testcase die wordt geretourneerd door de query die u definieert.
  • Vereiste gebaseerd: gebruik dit om testcases te groeperen die zijn ontworpen om de teststatus van achterstandsitems bij te houden. Elke testcase die u toevoegt aan een testpakket op basis van vereisten, wordt automatisch gekoppeld aan het achterstallige item.
  • Statisch: Gebruik dit om testcases samen te groeperen met eventuele kenmerken of testsuites.
    Zie Een testplan maken voor meer informatie.
    Verwijzingsnaam=Microsoft.VSTS.TCM.TestSuiteType, gegevenstype=tekenreeks

Testpakket

Notitie

  1. Pas de selectielijst voor deze velden niet aan. Het systeem accepteert alleen de waarden die worden vermeld.
  2. Door een GLOBALLIST element toe te voegen aan de FIELD definitie, kunt u een vervolgkeuzelijst met builds opgeven waaruit gebruikers kunnen kiezen. Zie Builds en de automatische populatie van globale lijsten verderop in dit artikel voor meer informatie.

Andere velden

De volgende velden worden niet weergegeven in werkitemformulieren, maar deze velden worden bijgehouden voor testcases of testsuites. U kunt een aantal van deze velden gebruiken om query's te filteren en rapporten te maken. (Geen van deze velden worden toegevoegd aan het datawarehouse of geïndexeerd.)

Veldnaam

Beschrijving

Type werkitem

Geautomatiseerde testopslag

De assembly die de test bevat waarmee de testcase wordt geautomatiseerd.

Referentienaam=Microsoft.VSTS.TCM.AutomatedTestStorage, gegevenstype=Tekenreeks

Testscenario

Geautomatiseerd testtype

Het type test waarmee de testcase wordt geautomatiseerd.

Verwijzingsnaam=Microsoft.VSTS.TCM.AutomatedTestType, gegevenstype=tekenreeks

Testscenario

AutomatedTestId

De id van de test waarmee de testcase wordt geautomatiseerd.

Referentienaam=Microsoft.VSTS.TCM.AutomatedTestId, gegevenstype=Tekenreeks

Testscenario

AutomatedTestName

De naam van de test die wordt gebruikt om de testcase te automatiseren.

Referentienaam=Microsoft.VSTS.TCM.AutomatedTestName, gegevenstype=Tekenreeks

Testscenario

LocalDataSource

De lokale gegevensbron die ondersteuning biedt voor de test.

Referentienaam=Microsoft.VSTS.TCM.LocalDataSource, gegevenstype=HTML

Testscenario

Querytekst

Veld dat wordt gebruikt om de query vast te leggen die is gedefinieerd voor een op query's gebaseerd suitetype.

Verwijzingsnaam=Microsoft.VSTS.TCM.QueryText, gegevenstype=PlainText

Testpakket

Test Suite Audit

Houdt andere bewerkingen bij wanneer u een testpakket wijzigt, bijvoorbeeld: tests toevoegen aan een testpakket of configuraties wijzigen. Dit veld kan worden weergegeven via het tabblad Geschiedenis of via een afzonderlijke query. Er is een gecombineerde geschiedenisweergave, inclusief wijzigingen in het veld Werkitems en wijzigingen die het gevolg zijn van gerelateerde artefacten, zoals testpunten en configuraties.

Referentienaam=Microsoft.VSTS.TCM.TestSuiteAudit, gegevenstype=PlainText

Testpakket

Type-id van testpakket 1

Een door het systeem toegewezen waarde die overeenkomt met de categorie testsuite en alleen van toepassing op testsuites. Toegewezen waarden zijn:

  • 1 (statisch)

  • 2 (op query's gebaseerd)

  • 3 (op basis van vereisten)

Verwijzingsnaam=Microsoft.VSTS.TCM.TestSuiteTypeId, gegevenstype=Geheel getal

Testpakket

Notitie

  1. Pas de selectielijst voor deze velden niet aan. Het systeem accepteert alleen de waarden die worden vermeld.

Velden die worden geïntegreerd met Team Foundation Build

Team Foundation Build is het on-premises buildsysteem dat u kunt gebruiken met Azure DevOps Server en TFS. U kunt uw buildproces configureren met behulp van Team Foundation Build en Team Foundation Build kan werkitems genereren wanneer een build mislukt. U kunt ook buildgegevens toevoegen aan werkitems die zijn opgelost in een bepaalde build. Om dit te laten werken, vereist Team Foundation Build dat de volgende twee velden worden toegevoegd aan de definitie van het type werkitem: Gevonden in en integratiebuild.

Gevonden in en geïntegreerd in buildvelden worden gedefinieerd voor bugs in de standaardprocessen. Deze velden koppelen bugs aan de builds waar ze zijn gevonden of opgelost.

U kunt het volgende codefragment gebruiken om deze velden toe te voegen aan een WIT-definitie.

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
        <SUGGESTEDVALUES>
          <LISTITEM value="&lt;None&gt;" />
        </SUGGESTEDVALUES>
</FIELD>
<FIELD name="Integration Build" refname="Microsoft.VSTS.Build.IntegrationBuild" type="String" reportable="dimension">
    <HELPTEXT>Product build number this bug was fixed in</HELPTEXT>
        <SUGGESTEDVALUES>
          <LISTITEM value="&lt;None&gt;" />
        </SUGGESTEDVALUES>
</FIELD>

Wanneer het veld Gevonden in aanwezig is in een WIT-definitie, wordt in Team Foundation Build een werkitem gemaakt wanneer een build mislukt en wordt het veld Gevonden in ingesteld op het buildnummer van de build die is mislukt. Als het veld Gevonden in ontbreekt, maakt Team Foundation Build geen werkitem voor de mislukte build en werkt alles zoals verwacht.

Wanneer het veld Integration Build aanwezig is in de WIT-definitie, identificeert Team Foundation Build werkitems die zijn opgelost met elke build en werkt deze werkitems vervolgens bij om het buildnummer in te stellen waarin ze zijn opgelost in het veld Integration Build . Als het veld Integration Build ontbreekt, slaat Team Foundation Build het buildnummer niet op in de werkitems en werkt alles zoals verwacht.

Automatische inpopulatie van builds en globale lijsten

De eerste keer dat u een build voor een project in de wachtrij zet met Team Foundation Build, voegt TFS automatisch een algemene lijst met het label Build - ProjectName toe. Telkens wanneer een build wordt uitgevoerd, wordt een LISTITEM toegevoegd aan deze algemene lijst met de naam van de build.

Door een GLOBALLIST-element toe te voegen aan de DEFINITIE FIELD , kunt u een vervolgkeuzelijst met builds opgeven waaruit gebruikers kunnen kiezen. Voorbeeld:

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
        <SUGGESTEDVALUES>
          <LISTITEM value="&lt;None&gt;" />
        </SUGGESTEDVALUES>
        <SUGGESTEDVALUES expanditems="true" filteritems="excludegroups">
          <GLOBALLIST name="Builds - TeamProjectName" />
        </SUGGESTEDVALUES>
</FIELD>

Velden die worden geïntegreerd met testplannen

Met Testplannen kunt u het maken van een bug of een ander type werkitem automatiseren wanneer een test mislukt. Zie Bevindingen toevoegen aan bestaande bugs met verkennende tests voor meer informatie.

Wanneer een werkitem op deze manier is gemaakt, worden informatie over het systeem en de stappen voor het reproduceren van de fout vastgelegd in de velden Systeemgegevens en Stappen voor opnieuw proberen .

U kunt deze velden toevoegen aan werkitemtypen die u maakt voor het bijhouden van defecten met behulp van het volgende codefragment.

<FIELD name="System Info" refname="Microsoft.VSTS.TCM.SystemInfo" type="HTML" />
<FIELD name="Repro Steps" refname="Microsoft.VSTS.TCM.ReproSteps" type="HTML" />

Velden die zijn geïntegreerd met Team Foundation Version Control

Met een van de functies die beschikbaar zijn in Team Foundation-versiebeheer (TFVC) kunt u werkitems koppelen of oplossen wanneer u code incheckt. Mogelijk hebt u aan een bepaald werkitem gewerkt wanneer u een codewijziging aanbrengt en kunt u deze koppeling instellen vanuit het check-invenster van broncodebeheer wanneer u klaar bent met het werken aan de code.

De mogelijkheid van Team Foundation-versiebeheer om een werkitem op te lossen, vereist dat werkitems een bepaalde actie bevatten. Het broncodebeheersysteem voert vervolgens query's uit op het bijhouden van werkitems om te bepalen of het werkitem die actie ondersteunt. Als dit wel het geval is, wordt er ook een query uitgevoerd op de bron- en doelstatus van de overgang. Als de actie wordt gevonden, kan het broncodebeheersysteem het werkitem volgens de setovergang overschakelen wanneer deze in de code wordt gecontroleerd.

Notitie

Wanneer u de actie Checkin gebruikt, moet u de juiste statusseninstellen om de gewenste statusovergang weer te geven.

Zie Veldtoewijzingen automatiseren op basis van status, overgang of reden voor meer informatie over acties.