Freigeben über


Benutzerdefinierte Felder

Azure DevOps Services

Die Verwendung der benutzerdefinierten Felder ermöglicht das Speichern der benutzerdefinierten Daten für die Testausführung und/oder das Testergebnis. Es können bis zu 100 benutzerdefinierte Felder für ein einzelnes Azure DevOps Projekt definiert werden. Projekt-Administrator kann den Satz der benutzerdefinierten Felder verwalten (hinzufügen/löschen).

Voraussetzungen

Kategorie Anforderungen
Projektzugriff Projektmitglied
Zugriffsebenen Mindestens einfacher Zugriff zum Anzeigen testbezogener Arbeitsaufgaben. Benutzer mit Stakeholder-Zugriff können nicht auf Azure Test Plans zugreifen.

Um Testpläne und Testsammlungen hinzuzufügen, Testartefakte zu löschen oder Testkonfigurationen zu definieren, benötigen Sie Basic + Testpläne Zugriff oder ein Visual Studio Abonnement: Enterprise, Test Professional oder MSDN Platforms.
Berechtigungen Bereichspfad:
- Bearbeiten Sie Arbeitsaufgaben in diesem Knoten: Hinzufügen oder Ändern von Testplänen, Testsammlungen, Testfällen oder anderen testbasierten Arbeitsaufgaben.
- Verwalten von Testplänen: Ändern von Testplaneigenschaften wie Build- und Testeinstellungen.
- Verwalten von Testsuiten: Erstellen und Löschen von Testsuiten, Hinzufügen und Entfernen von Testfällen aus Testsammlungen, Ändern von Testkonfigurationen und Verschieben von Testsammlungen.

Project-level:
- Verwalten von Testkonfigurationen und Verwalten von Testumgebungen: Verwalten von Testkonfigurationen oder Testumgebungen.
- Dauerhaftes Löschen von Arbeitsaufgaben: Dauerhaftes Löschen testbasierter Arbeitsaufgaben.

Weitere Informationen finden Sie unter Manueller Testzugriff und Berechtigungen.

Verwalten der benutzerdefinierten Felder

Es gibt zwei Möglichkeiten zum Verwalten der benutzerdefinierten Felder – entweder über REST-API oder der Projektadministrator kann dies über die Projekteinstellungen tun, indem er unter Pipelines die Testverwaltung auswählt. Auf dieser Seite kann ein neues benutzerdefiniertes Feld hinzugefügt werden, indem Sie auf die Schaltfläche "+Neu hinzufügen" klicken.

Screenshot der Projekteinstellungen mit den ausgewählten Testverwaltungseinstellungen und der Schaltfläche zum Hinzufügen eines neuen benutzerdefinierten Felds, das durch rotes Rechteck gekennzeichnet ist.

Wählen Sie +Neu hinzufügen, um ein neues benutzerdefiniertes Feld hinzuzufügen. Jedes benutzerdefinierte Feld muss einen Namen haben, einen Typ konfiguriert sein und angeben, auf welches Artefakt es angewendet wird.

Screenshot eines Dialogfelds, das zum Hinzufügen eines neuen benutzerdefinierten Felds verwendet wird.

Der Name des benutzerdefinierten Felds darf nicht länger als 50 Zeichen sein (Leerzeichen, Zahlen und Sonderzeichen sind nicht zulässig) und muss im Projekt eindeutig sein. Bei den Namen wird die Groß-/Kleinschreibung nicht beachtet, sodass Sie nicht über ein benutzerdefiniertes Feld mit dem Namen "Test" und das andere Feld mit dem Namen "test" verfügen können. Als Type kann eines der folgenden Elemente verwendet werden:

  • Bit
  • DateTime
  • Int
  • Gleitkomma
  • String
  • Guid

Die vorhandenen benutzerdefinierten Felder können entweder bearbeitet werden (nur Name kann geändert werden) oder entfernt werden.

Hinweis

Nach dem Entfernen des benutzerdefinierten Felds können Sie seinen Namen nicht für etwa einen Tag verwenden. Der Hintergrundprozess, der die gelöschten benutzerdefinierten Felder dauerhaft entfernt, wird einen Tag lang ausgeführt.

Speichern benutzerdefinierter Daten in benutzerdefinierten Feldern

Sie können Ihre benutzerdefinierten Daten entweder als Teil der Testausführungs-/Ergebniserstellung oder nach dem Erstellen der Testausführung/des Ergebnisses in den konfigurierten benutzerdefinierten Feldern speichern. Beides kann jetzt mithilfe der REST-API erfolgen. In Zukunft ermöglichen wir, dass die benutzerdefinierten Daten aus der Testergebnisdatei aufgenommen werden. Um die werte abzurufen, die in Ihren benutzerdefinierten Feldern für die vorhandene Testausführung/das vorhandene Testergebnis gespeichert sind, müssen Sie die REST-API verwenden. Im Moment werden die benutzerdefinierten Felder und die darin gespeicherten Werte nicht in der Azure DevOps-Benutzeroberfläche angezeigt (wir werden diese Funktion in Zukunft hinzufügen).

Wenn Sie die Testausführung und/oder das Ergebnis über die REST-API erstellen und benutzerdefinierte Daten in vorhandene benutzerdefinierte Felder speichern möchten, besteht die beste Option darin, die benutzerdefinierten Daten als Teil der Testausführung und/oder Ergebniserstellung zu senden. Um einen Testlauf zu erstellen, rufen Sie REST API Runs – Erstellen auf, und um Testergebnisse hinzuzufügen, verwenden Sie REST API Results – Hinzufügen.

Wenn die Testausführung und/oder das Ergebnis nicht über die REST-API erstellt wird, aber auf andere Weise müssen Sie zuerst die Identifizierung der Testausführung oder des Ergebnisses finden, für die Sie die benutzerdefinierten Daten in den benutzerdefinierten Feldern festlegen (oder aktualisieren möchten), und dann REST-API-Ausführung aufrufen – Update für die Testausführung und REST-API-Ergebnisse – Update für das Testergebnis.

Um die benutzerdefinierten Daten aus den benutzerdefinierten Feldern abzurufen, die zuvor für die Testausführung und/oder das Ergebnis gespeichert wurden, müssen Sie zuerst die Identifizierung der Testausführung oder des Ergebnisses finden. Anschließend können Sie REST-API-Ausführungen – Abfrage für die Testausführung und REST-API-Ergebnisse – Abrufen für das Testergebnis aufrufen.

Die benutzerdefinierten Daten für die benutzerdefinierten Felder werden in einem Array gesendet oder empfangen. Jedes Element dieses Arrays enthält zwei Eigenschaften "Fieldname" und "value", und Sie können hier ein Beispiel dafür sehen. Der Wert ist ein Objekt des Typs, der dem für das Benutzerdefinierte Feld konfigurierten Typ entspricht. Um den Typ des benutzerdefinierten Felds zu verstehen, sollten Sie DIE REST-API verwenden, die ein Array der benutzerdefinierten Felder bereitstellt. Für jedes Feld finden Sie dort die ID, den Namen, den Typ und den Bereich. Sie können den Typ auch fest codieren, wenn Sie wissen, welchen Typ das benutzerdefinierte Feld des angegebenen Namens hat.