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. Der Projektadministrator kann die Gruppe der benutzerdefinierten Felder verwalten (hinzufügen/löschen).

Verwalten der benutzerdefinierten Felder

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

Wählen Sie +Neu hinzufügen, um ein neues benutzerdefiniertes Feld hinzuzufügen. Jedes benutzerdefinierte Feld muss einen Namen, einen Typ konfiguriert und angeben, auf welchen Artefakt es angewendet 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 zeigen wir nicht die benutzerdefinierten Felder und Werte an, die in diesen auf der Azure DevOps-Benutzeroberfläche gespeichert sind (wir werden diese Fähigkeit 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. Zum Erstellen eines Testlaufaufrufs REST API Runs – Erstellen und Erstellen von Rest-API-Ergebnissen des Testergebnisses – 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ührung aufrufen – Abfrage für die Testausführung und REST-API-Ergebnisse – Abrufen für das Testergebnis.

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 objekt des Typs, der dem typ entspricht, der für das benutzerdefinierte Feld konfiguriert ist. 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 hartcodieren, wenn Sie wissen, welcher Typ des benutzerdefinierten Felds des angegebenen Namens ist.