Anpassen und Verwalten der Testerfahrung

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Mithilfe des tcm fieldmapping Befehls können Sie die folgenden drei Features anpassen, die Azure Test Plans unterstützt.

  • Ändern des Fehlertyps, der zum automatischen Dateifehler im Test-Manager verwendet wird
  • Anpassen der Auswahlliste für Auflösungszustände
  • Passen Sie die Auswahlliste für Fehlertypen an.

Microsoft Test Manager wurde veraltet. Es wurde durch Azure Test Plans ersetzt, eine voll ausgestattete Testverwaltungslösung. Microsoft Test Manager 2017, der mit Microsoft Visual Studio 2017 ausgeliefert wurde, ist die letzte Version verfügbar.

Das Befehlszeilentool tcm funktioniert beim Ausführen von Azure DevOps Services und lokalen Azure DevOps Server.

Wichtig

Das tcm-Tool ist über Visual Studio 2017 und frühere Versionen verfügbar. Sie ist in Visual Studio 2019 und späteren Versionen nicht verfügbar.

Außerdem können Sie Befehlsoptionen zum Kopieren und Klonen von Testplänen und Testsuiten verwendentcm.

Voraussetzungen

Für das Projekt, in dem Sie die Arbeitsaufgabentypen definieren, müssen Sie Mitglied der Sicherheitsgruppe Project Administratoren sein. Siehe Berechtigungen auf Projektebene ändern.

Um das Befehlszeilentool tcm auszuführen, geben Sie die Eingabeaufforderung für Entwickler im Suchfeld "Hier eingeben " ein, und wählen Sie die Version aus, die für Sie gilt. Der Befehl "tcm " befindet sich im folgenden Ordner:

Azure DevOps Services, Azure DevOps Server 2020 - 2019, TFS 2018 und TFS 2017, Visual Studio 2017-Client:

%programfiles(x86)%\Microsoft Visual Studio\2017\Professional\Common7\IDE

Syntax

tcm fieldmapping /export /collection:CollectionURL /teamproject:Project /type:resolutiontype|bug|failuretype /mappingfile:path [/login:username,[password]]  

tcm fieldmapping /import /collection:CollectionURL /teamproject:Project /type:resolutiontype|bug|failuretype /mappingfile:path [/login:username,[password]]  

Parameter

Parameter Beschreibung
/export Gibt einen Export der Feldzuordnungsdatei des angegebenen Typs an. Weitere Informationen zur Syntax der unterstützten Dateitypen finden Sie im Abschnitt Hinweise.
/import Gibt einen Import der Feldzuordnungsdatei an.
/mappingfile:Path Der Pfad und der Dateiname der XML-Definitionsdatei, die die Feldzuordnungen enthält.
/collection:CollectionURL Gibt den URI (Uniform Resource Identifier) der Projektauflistung an. Das Format für den URI lautet wie folgt: http://ServerName:Port/VirtualDirectoryName/CollectionName

Wenn kein virtuelles Verzeichnis verwendet wird, hat der URI das folgende Format:

http://ServerName:Port/CollectionName
/teamproject:Project Gibt den Namen des Projekts an, für das die Feldzuordnungen angewendet werden sollen. Dieses Projekt muss in der Projektsammlung definiert werden, die vom Parameter "/collection " angegeben wird.
/type:resolutiontype|bug|failuretype Der Typ der zu importierenden oder zu exportierenden Datei. Informationen zur Syntaxstruktur jedes Dateityps finden Sie unter Fehler, Lösungszustände und Fehlertypen.
/login:UserName,Password Optional. Gibt den Namen und das Kennwort eines Benutzers an, der protokolliert wird, wer über Berechtigungen zum Ausführen des Befehls verfügt.

Sie verwenden diese Option, wenn die Windows-Anmeldeinformationen nicht mit ausreichenden Berechtigungen verbunden sind, wenn Sie die Standardauthentifizierung verwenden oder wenn Sie sich nicht in einer Domäne befinden.
/? oder Hilfe Zeigt die Hilfe zum Befehl im Eingabeaufforderungsfenster an.

Hinweise

Jedes Mal, wenn Sie den Befehl "tcm fieldmapping" ausführen, werden die Inhalte der vorhandenen Feldzuordnungsdatei durch den Inhalt ersetzt, den Sie importieren.

Zuordnungsdatei für Fehlerarbeitsaufgabentyp

Wenn die unterstützten Clients für Azure Test Plans einen Fehler erstellen, definiert die Zuordnungsdatei den Arbeitselementtyp zum Erstellen und Ausfüllen von drei Datenfeldern: reproduzierbare Schritte, Systeminformationen und den Build, in dem der Fehler gefunden wurde. Wenn ein Tester einen Test ausführt und einen Defekt findet, kann er einen Fehler erstellen, in dem diese drei Felder automatisch ausgefüllt werden.

Wenn Ihr Projekt mit einer der Standardprozessvorlagen erstellt wurde, ist der Fehlerarbeitselementtyp bereits aktiviert. Wenn Sie der Fehlerkategorie jedoch einen anderen Arbeitselementtyp hinzufügen oder mit einer angepassten Prozessvorlage arbeiten, müssen Sie möglicherweise den Befehl "tcm " verwenden.

Sie können nur einen Arbeitselementtyp definieren, der erstellt werden soll, wenn Sie Tests für Azure Test Plans ausführen.

Die folgende XML-Syntax führt den Standardinhalt der Fehlerfeldzuordnungsdatei auf. Alle drei Felder müssen angegeben werden, wenn Sie eine Fehlerfeldzuordnungsdatei importieren.

<?xml version="1.0" encoding="utf-16"?>  
<BugFilerMappings workitemtypetocreate="Bug">  
   <ReproSteps>Microsoft.VSTS.TCM.ReproSteps</ReproSteps>  
   <SystemInformation>Microsoft.VSTS.TCM.SystemInfo</SystemInformation>  
   <BuildFoundIn>Microsoft.VSTS.Build.FoundIn</BuildFoundIn>  
</BugFilerMappings>  

Weitere Informationen zu Testfeldern finden Sie unter Build- und Testintegrationsfelder.

Zuordnungsdatei für Auflösungszustände

Die folgende XML-Syntax listet den Standardinhalt der Auflösungszustände auf, die für die Standardprozessvorlagen definiert sind.

<?xml version="1.0" encoding="utf-8"?>  
<TestResolutionStates>  
    <TestResolutionState name="Needs investigation" />  
    <TestResolutionState name="Test issue" />  
    <TestResolutionState name="Product issue" />  
    <TestResolutionState name="Configuration issue" />  
</TestResolutionStates>  

Wenn Sie fehlgeschlagene Tests analysieren, weisen Sie den Fehlertyp und den Auflösungszustand zu.

Analyse test run page in Microsoft Test Manager

Zuordnungsdatei für Fehlertypen

Die folgende XML-Syntax listet die für ein Projekt definierten Standardfehlertypen auf.

<?xml version="1.0" encoding="utf-16"?>  
<TestFailureTypes>  
  <TestFailureType name="Regression" />  
  <TestFailureType name="New Issue" />  
  <TestFailureType name="Known Issue" />  
  <TestFailureType name="Unknown" />  
</TestFailureTypes>  

Beispiele

Falls nicht anders angegeben, gelten in jedem Beispiel die folgenden Werte:

  • URI für die Projektsammlung: http://AdventureWorksServer:8080/tfs/Collection1
  • Projektname: AdventureWorks
  • Fehlerfeldzuordnungs-Dateiname: bugfieldmappings.xml
  • Speicherort des Ordners: "C:\Users\AdminUser\Documents\"

Importieren der Fehlerfeldzuordnungsdatei

Der folgende Befehl importiert den Inhalt der datei bugfieldmappings.xml in das AdventureWorks-Projekt, das in Collection1 auf dem Server mit dem Namen AdventureWorksServer definiert ist.

tcm fieldmapping /import /type:bug /mappingfile:"C:\Users\AdminUser\Documents\bugfieldmappings.xml" /collection:http://AdventureWorksServer:8080/tfs/Collection1 /teamproject:AdventureWorks