Anpassade fält

  • Artikel

Azure DevOps Services

Med hjälp av de anpassade fälten kan du lagra anpassade data mot testkörningen och/eller testresultatet. Det kan finnas upp till 100 anpassade fält som definierats för ett enda Azure DevOps-projekt. Projektadministratören kan hantera (lägga till/ta bort) uppsättningen med de anpassade fälten.

Hantera anpassade fält

Det finns två sätt att hantera de anpassade fälten – antingen via REST API eller projektadministratör kan du göra det via projektinställningarna när du väljer Testhantering under Pipelines. På den sidan kan du lägga till ett nytt anpassat fält genom att klicka på knappen + Lägg till ny .

Skärmbild av projektinställningar med testhanteringsinställningarna valda och knappen för att lägga till ett nytt anpassat fält markerat med röd rektangel.

Välj + Lägg till ny för att lägga till ett nytt anpassat fält. Varje anpassat fält måste ha ett namn, en typ konfigurerad och ange vilken typ av artefakt det gäller för.

Skärmbild av en dialogruta som används för att lägga till ett nytt anpassat fält.

Namnet på det anpassade fältet får inte vara längre än 50 tecken (blanksteg, siffror och specialtecken tillåts inte) och måste vara unikt i projektet. Namnen är skiftlägesokänsliga, så du kan inte ha ett anpassat fält med namnet "Test" och det andra med namnet "test". Typ kan vara något av följande:

  • Bit
  • Datum/tid
  • Int
  • Flyttal
  • String
  • GUID

Befintliga anpassade fält kan antingen redigeras (endast namn kan ändras) eller tas bort.

Kommentar

När du har tagit bort det anpassade fältet kan du inte använda dess namn för ungefär en dag. Bakgrundsprocessen som tar bort de borttagna anpassade fälten permanent körs en om dagen.

Lagra anpassade data i anpassade fält

Du kan lagra dina anpassade data i de konfigurerade anpassade fälten antingen som en del av testkörningen/resultatet eller efter att testkörningen/resultatet skapades. Båda kan göras med hjälp av REST API för tillfället. I framtiden kommer vi att tillåta att anpassade data hämtas från testresultatfilen. Om du vill hämta de värden som lagras i dina anpassade fält för den befintliga testkörningen/resultatet måste du använda REST-API:et. För tillfället visar vi inte de anpassade fält och värden som lagras i dessa i Azure DevOps-användargränssnittet (vi kommer att lägga till den möjligheten i framtiden).

När du skapar en testkörning och/eller ett resultat via REST API och vill lagra anpassade data i ett befintligt anpassat fält är det bästa alternativet att skicka anpassade data som en del av testkörningen och/eller resultatskapandet. Skapa ett testkörningsanrop för REST API Runs – Skapa och för att skapa testresultatet genom att anropa REST API-resultat – Lägg till.

När testkörningen och/eller resultatet inte skapas via REST API, utan på annat sätt, måste du först hitta identifieringen av testkörningen eller resultatet som du vill ange (eller uppdatera) anpassade data för i de anpassade fälten och sedan anropa REST API Runs – Uppdatera för testkörningen och REST API-resultat – Uppdatera för testresultatet.

Om du vill hämta anpassade data från de anpassade fält som lagrats tidigare mot testkörningen och/eller resultatet måste du först hitta identifieringen av testkörningen eller resultatet. Sedan kan du anropa REST API Runs – Fråga efter testkörningen och REST API-resultat – Hämta för testresultatet.

Anpassade data för de anpassade fälten skickas eller tas emot i en matris. Varje objekt i matrisen innehåller två egenskaper "fieldname" och "value" och du kan se ett exempel på det här. Värdet är ett objekt av den typ som matchar den typ som konfigurerats för det anpassade fältet. För att förstå typen av anpassat fält kanske du vill använda REST API som tillhandahåller matrisen för de anpassade fälten. För varje fält hittar du dess ID, namn, typ och omfång. Du kan också hårdkoda typen om du vet vilken typ av det anpassade fältet med förnamn är.