Freigeben über


Erstellen Sie eine Abfrage basierend auf Build- und Testintegrationsfeldern

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Verwenden Sie Arbeitsaufgabenfelder, die die Build- und Testintegration unterstützen, um die Rückverfolgbarkeit zu verbessern, Qualitätstrends zu analysieren und testbezogene Workflows zu automatisieren. Zu den typischen Szenarien gehören:

  • Ordnen Sie Fehler mit den spezifischen Builds zu, in denen sie entdeckt oder behoben wurden.
  • Fehler nach Build abfragen, um Trends zu identifizieren und Korrekturen zu priorisieren.
  • Markieren Sie Testfälle als manuell oder automatisiert, und verfolgen Sie Automatisierungsmetadaten.
  • Definieren Sie Aktions- und Validierungsschritte für Testfälle und freigegebene Schritte, damit Teams Tests zuverlässig ausführen und überprüfen können.

In diesem Artikel wird erläutert, wie Sie diese Felder verwenden und Beispielabfragen und Tipps anbieten.

Voraussetzungen

Area Berechtigung und Rolle Was dies zulässt
Projektebene Beitragende Erstellen und Bearbeiten von Abfragen.
Projektebene Leser Anzeigen von Abfragen (Abfragen können nicht erstellt oder bearbeitet werden).
Projektebene Projektadministratoren Vollzugriff auf Projekteinstellungen, einschließlich Abfragen.
Testen von Artefakten Verwalten von Testplänen Erstellen, Bearbeiten und Löschen von Testplänen
Testen von Artefakten Verwalten von Testsuiten Erstellen, Bearbeiten und Löschen von Test-Suites
Testen von Artefakten Bearbeiten von Arbeitsaufgaben in diesem Knoten Fügen Sie testspezifische Arbeitsaufgaben wie Testfälle und Testsammlungen hinzu oder bearbeiten Sie sie.

Hinweis

  • Einige Testberechtigungen sind auf Ebene des Testplans oder Bereichsknotens angesiedelt, und Projekt-Administratoren können diese Berechtigungen zuweisen.
  • Um Abfragen für alle Projekte auszuführen oder zu automatisieren, stellen Sie sicher, dass Sie über die erforderlichen projektübergreifenden Berechtigungen verfügen oder ein Dienstkonto mit dem entsprechenden Zugriff verwenden.

Unterstützte Operatoren und Makros

Die meisten Build- und Testintegrationsfelder verwenden Datentypen "String", "PlainText" oder "HTML". Verwenden Sie die folgenden Operatoren und Makros, wenn Sie Abfrageklauseln für Text- oder Rich-Text-Felder angeben.

Datentyp

Unterstützte Operatoren und Makros


Rich-Text (HTML) und
Mehrzeiliger Text (PlainText)

Contains Words, Does Not Contain Words, Is Empty, Is Not Empty.

Einzeiliger Text (Zeichenfolge)

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever.
Makros: [Any] (gültig mit Arbeitsaufgabentyp); @Project (gültig mit Teamprojekt). Das System wird bei Bedarf standardmäßig auf das aktuelle Projekt festgelegt. Beispiele für projektübergreifende Abfragen finden Sie unter "Abfragen für projekteübergreifende Projekte".

Nützliche Filter

Filtern nach

Schließen Sie diese Abfrageklauseln ein

Automatisierte Testfälle

Work Item Type = Test Case UND Automation Status = Automated

Abfragebasierte Testsuiten

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

Anforderungsbasierte Testsuiten

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

Fehler und die sie testenden Testfälle auflisten

Erstellen Sie eine neue Abfrage, legen Sie den Abfragetyp auf Arbeitselemente und direkte Verknüpfungen fest. Filtern Sie nach Fehlern auf der obersten Ebene, und fügen Sie einen verknüpften Arbeitsaufgabenfilter für Testfälle hinzu.

Screenshot, der Fehler und deren verknüpfte Testfälle zeigt.

Hinweis

Sie können keine Abfrage erstellen, die eine hierarchische Ansicht von Testplänen, Testsuiten und Testfällen anzeigt, da diese Artefakte nicht durch Parent-Child-Linktypen verbunden sind. Um diese Hierarchie anzuzeigen, öffnen Sie die Seite " Testpläne > testen " (siehe Erstellen eines Testplans).

Erstellen und Testen von Datenfeldern

In der folgenden Tabelle werden Felder beschrieben, die in einem oder mehreren testbezogenen Arbeitsaufgabentypen angezeigt werden. Informationen zu Datentypen und Feldattributen finden Sie unter "Arbeitselementfelder und -attribute".

Informationen zum Anpassen eines Felds oder einer Auswahlliste finden Sie unter Hinzufügen oder Ändern eines Felds zur Unterstützung von Abfragen, Berichten und Workflows.

Feldname

Beschreibung

Arbeitsaufgabentyp


Automatisierungsstatus1

Der Status eines Testfalls. Werte: Automatisiert, nicht automatisiert, geplant. Informationen zum Ausführen automatisierter Tests finden Sie unter Ausführen automatisierter Tests aus Testplänen.
Verweisname=Microsoft.VSTS.TCM.AutomationStatus, Datentyp=Zeichenfolge

Testfall

Gefunden in2

Produktbuildnummer (Revision), in der ein Fehler gefunden wurde. Verweisname=Microsoft.VSTS.Build.FoundIn, Datentyp=Zeichenfolge.

Hinweis

Verwenden Sie den Typ "In Build gefunden", um eine Arbeitsaufgabe mit einem Build zu verknüpfen. Dieser Verknüpfungstyp funktioniert mit aktuellen Buildprozessen (Azure Pipelines und klassische Builddefinitionen); Sie gilt nicht für ältere XAML-Builds.

Bug

Integrationsversion2

Produktbuildnummer, die den Fix enthält. Verweisname=Microsoft.VSTS.Build.IntegrationBuild, Datentyp=Zeichenfolge.

Hinweis

Verwenden Sie den Linktyp „Integriert im Build“, um ein Arbeitselement mit einem Build zu verknüpfen. Dieser Verknüpfungstyp funktioniert mit aktuellen Buildprozessen (Azure Pipelines und klassische Builddefinitionen); Sie gilt nicht für ältere XAML-Builds.

Alle

Thema

Gibt an, ob gemeinsame Schritte einem erwarteten Ergebnis zugeordnet sind. Zulässige Werte: Ja, Nein. Verweisname=Microsoft.VSTS.Common.Issue, Datentyp=Zeichenfolge.

Freigegebene Schritte

Parameter

Enthält Parameter, die beim Ausführen eines manuellen Tests verwendet werden. Verweisname=Microsoft.VSTS.TCM.Parameters, Datentyp=HTML.

Freigegebene Parameter, Freigegebene Schritte, Testfall

Schritte

Aktions- und Validierungsschritte, die zum Ausführen des Tests erforderlich sind. Verweisname=Microsoft.VSTS.TCM.Steps, Datentyp=HTML.

Gemeinsam genutzte Schritte, Testfall

Systeminformationen

System- und Umgebungsinformationen, die für den Test relevant sind. Verweisname=Microsoft.VSTS.TCM.SystemInfo, Datentyp=HTML.

Fehler, Feedbackantwort

Repro-Schritte (Schritte zum Reproduzieren)

Schritte, die erforderlich sind, um unerwartetes Verhalten zu reproduzieren. Erfassen Sie genügend Informationen, damit andere Korrekturen reproduzieren und überprüfen können. Verweisname=Microsoft.VSTS.TCM.ReproSteps, Datentyp=HTML.

Bug

Test Suite Typ1

Kategorie der Testsuite. Zulässige Werte: Abfragebasiert, Anforderungsbasiert, statisch. Weitere Informationen finden Sie unter Erstellen eines Testplans. Verweisname=Microsoft.VSTS.TCM.TestSuiteType, Datentyp=Zeichenfolge.

Test-Suite

Hinweis

  1. Passen Sie die Auswahlliste für diese Felder nicht an – das System und die Integration erwarten die aufgelisteten Werte.
  2. Durch Hinzufügen eines GLOBALLIST Elements zu einer FIELD Definition können Sie ein Dropdownmenü mit Builds bereitstellen. Siehe Builds und automatische Befüllung globaler Listen.

Weitere Felder

Die folgenden Felder erscheinen nicht in Arbeitsgegenstandsformularen, werden aber für Testfälle und Testsuiten nachverfolgt. Sie können einige von ihnen verwenden, um Abfragen zu filtern und Berichte zu erstellen. (Diese Felder werden weder dem Datenlager hinzugefügt noch indiziert.)

Feldname

Beschreibung

Arbeitsaufgabentyp


Automatisierter Testspeicher

Die Assembly mit dem Test, der den Testfall automatisiert. Verweisname=Microsoft.VSTS.TCM.AutomatedTestStorage, Datentyp=Zeichenfolge.

Testfall

Automatisierter Testtyp

Der Typ des Tests, der den Testfall automatisiert. Verweisname=Microsoft.VSTS.TCM.AutomatedTestType, Datentyp=Zeichenfolge.

Testfall

AutomatedTestId

Die ID des automatisierten Tests. Verweisname=Microsoft.VSTS.TCM.AutomatedTestId, Datentyp=Zeichenfolge.

Testfall

AutomatedTestName

Der Name des automatisierten Tests. Verweisname=Microsoft.VSTS.TCM.AutomatedTestName, Datentyp=Zeichenfolge.

Testfall

LokaleDatenquelle

Die lokale Datenquelle, die vom Test verwendet wird. Verweisname=Microsoft.VSTS.TCM.LocalDataSource, Datentyp=HTML.

Testfall

Abfragetext

Feld, das verwendet wird, um die Abfrage zu erfassen, die für einen abfragebasierten Suite-Typ definiert ist. Verweisname=Microsoft.VSTS.TCM.QueryText, Datentyp=PlainText.

Test-Suite

Test Suite Audit

Verfolgt Vorgänge beim Ändern einer Testsuite nach (z. B. Hinzufügen von Tests oder Ändern von Konfigurationen). Kann über die Registerkarte "Verlauf" oder eine Abfrage angezeigt werden. Verweisname=Microsoft.VSTS.TCM.TestSuiteAudit, Datentyp=PlainText.

Test-Suite

Test Suite-Typ-ID 1

Vom System zugewiesener Wert, der der Testsuitekategorie entspricht: 1 (Statisch), 2 (Abfragebasiert), 3 (Anforderungsbasiert). Verweisname=Microsoft.VSTS.TCM.TestSuiteTypeId, Datentyp=Ganze Zahl.

Test-Suite

Hinweis

  1. Passen Sie die Auswahlliste für diese Felder nicht an – das System und die Integration erwarten die aufgelisteten Werte.

Felder, die in Team Foundation Build- und Azure-Pipelines integriert werden

Team Foundation Build ist das lokale Buildsystem, das mit älteren Azure DevOps Server-Versionen verwendet wird. Azure Pipelines bietet cloudgehostete Build- und Pipelinefeatures in Azure DevOps Services. Beide Systeme integrieren Buildmetadaten in Arbeitsaufgaben, wenn Builds ausgeführt werden, und wenn Arbeitsaufgaben in Builds aufgelöst werden.

Die beiden Felder, die häufig für die Buildintegration verwendet werden, sind Gefunden in und Integrationsbuild. Wenn sie in einer WIT-Definition vorhanden sind, kann ein Buildsystem Arbeitselemente mit den relevanten Buildnummern zuordnen.

Sie können diese Felder zu einer WIT-Definition hinzufügen:

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

Wenn das Feld "Gefunden in " in einer WIT-Definition vorhanden ist, kann ein kompatibler Buildprozess eine Arbeitsaufgabe erstellen, wenn ein Build fehlschlägt, und "Gefunden in " auf die Buildnummer festlegen. Wenn integrationsbuild vorhanden ist, kann ein kompatibler Buildprozess Arbeitsaufgaben aktualisieren, die durch einen Build mit der entsprechenden Buildnummer aufgelöst wurden.

Builds und automatische Auffüllung von globalen Listen

Wenn Sie zum ersten Mal einen Build für ein Projekt mit Team Foundation Build oder Azure Pipelines in die Warteschlange stellen, erstellt das System eine globale Liste mit dem Namen Build - <ProjectName>. Jeder Buildlauf fügt einen LISTITEM Eintrag für diesen Build hinzu. Die globale Liste verwendet den Projektanzeigenamen und kann in einem GLOBALLIST-Element innerhalb einer FIELD-Definition verwiesen werden, um eine Dropdown-Liste der Builds bereitzustellen.

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

Felder, die in Testpläne integriert werden

Testpläne können einen Fehler oder eine andere Arbeitsaufgabe erstellen, wenn ein Test fehlschlägt. Wenn Sie eine Arbeitsaufgabe auf diese Weise hinzufügen, erfasst das Testsystem Umgebungsdetails und Wiedergabeschritte in den Feldern "Systeminfo " und " Repro Steps ".

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

Felder, die mit Team Foundation Version Control (TFVC) integriert sind

TFVC unterstützt das Zuordnen oder das Bearbeiten von Arbeitsaufgaben während des Check-ins. Wenn Sie ein Arbeitselement aus dem Check-In-Fenster verknüpfen und die Aktion unterstützt wird, wendet TFVC den konfigurierten Zustandsübergang auf das Arbeitselement an.

Hinweis

Wenn Sie die Checkin-Aktion verwenden, legen Sie geeignete von- und zu-Zustände für den erwarteten Übergang fest.

Weitere Informationen finden Sie unter Automatisieren von Feldzuweisungen basierend auf Status, Übergang oder Grund.

Einschränkungen

Wichtige Einschränkungen beim Abfragen nach Testfall:

  • Hierarchische Ansichten: Sie können keine Abfrage erstellen, die eine hierarchische Ansicht von Testplänen, Testsuiten und Testfällen anzeigt, da diese Artefakte nicht durch Verknüpfungstypen für übergeordnete und untergeordnete Elemente verbunden sind.
  • Abfragebasierte Testsuiten: Abfragebasierte Suites enthalten jeden von der Abfrage zurückgegebenen Testfall; Stellen Sie sicher, dass Ihre Abfrage präzise ist, um unbeabsichtigte Einschlüsse zu vermeiden.
  • Feldbeschränkungen: Einige detaillierte Ausführungsergebnisse sind nicht als Standardfelder verfügbar und erfordern möglicherweise eine benutzerdefinierte Berichterstellung oder API-Verwendung.
  • Leistungs- und Geschwindigkeitsbeschränkungen: Azure DevOps erzwingt Anforderungs- und Ressourcengrenzwerte; Nicht optimierte Abfragen oder übermäßige API-Aufrufe können zu Verzögerungen oder Drosselungen führen.
  • Testfallverknüpfung: Testfälle werden nicht automatisch mit anderen Arbeitselementen verknüpft auf eine Weise, die komplexe hierarchische Abfragen unterstützt.