Udostępnij za pośrednictwem


Pola niestandardowe

Azure DevOps Services

Użycie pól niestandardowych umożliwia przechowywanie danych niestandardowych względem przebiegu testu i/lub wyniku testu. Dla pojedynczego projektu usługi Azure DevOps może być zdefiniowanych maksymalnie 100 pól niestandardowych. Administrator projektu może zarządzać (dodawać/usuwać ) zestaw pól niestandardowych.

Zarządzanie polami niestandardowymi

Istnieją dwa sposoby zarządzania polami niestandardowymi — za pośrednictwem interfejsu API REST lub administratora projektu można to zrobić za pomocą ustawień projektu podczas wybierania opcji Zarządzanie testami w obszarze Potoki. Na tej stronie można dodać nowe pole niestandardowe, klikając przycisk + Dodaj nowy .

Zrzut ekranu przedstawiający ustawienia projektu z wybranymi ustawieniami zarządzania testami i przyciskiem umożliwiającym dodanie nowego pola niestandardowego oznaczonego czerwonym prostokątem.

Wybierz pozycję + Dodaj nowy , aby dodać nowe pole niestandardowe. Każde pole niestandardowe musi mieć nazwę, typ skonfigurowany i wskazać, do jakiego typu artefakt ma zastosowanie.

Zrzut ekranu przedstawiający okno dialogowe służące do dodawania nowego pola niestandardowego.

Nazwa pola niestandardowego nie może być dłuższa niż 50 znaków (spacje, liczby i znaki specjalne są niedozwolone) i musi być unikatowa w projekcie. Nazwy są niewrażliwe na wielkość liter, więc nie można mieć jednego pola niestandardowego o nazwie "Test" i drugiego o nazwie "test". Typ może być jednym z następujących elementów:

  • Bit
  • DateTime
  • Int
  • Liczba zmiennoprzecinkowa
  • String
  • Identyfikator GUID

Istniejące pola niestandardowe można edytować (można zmienić tylko nazwę) lub usunąć.

Uwaga

Po usunięciu pola niestandardowego nie można użyć jego nazwy przez około dzień. Proces w tle, który powoduje trwałe usunięcie usuniętych pól niestandardowych, jest uruchamiany dziennie.

Przechowywanie danych niestandardowych w polach niestandardowych

Dane niestandardowe można przechowywać w skonfigurowanych polach niestandardowych w ramach tworzenia przebiegu/wyniku testu lub po utworzeniu przebiegu/wyniku testu. Oba te czynności można teraz wykonać przy użyciu interfejsu API REST. W przyszłości zezwolimy na pobieranie danych niestandardowych z pliku wyników testu. Aby uzyskać wartości przechowywane w polach niestandardowych dla istniejącego przebiegu/wyniku testu, należy użyć interfejsu API REST. Na razie nie wyświetlamy pól niestandardowych i wartości przechowywanych w nich w interfejsie użytkownika usługi Azure DevOps (dodamy tę możliwość w przyszłości).

Podczas tworzenia przebiegu testu i/lub wyniku za pośrednictwem interfejsu API REST i chcesz przechowywać dane niestandardowe w istniejącym polu niestandardowym, najlepszą opcją jest wysłanie danych niestandardowych w ramach przebiegu testu i/lub utworzenia wyniku. Aby utworzyć przebieg testu wywołania interfejsu API REST — utwórz i utwórz wyniki testu wywołania interfejsu API REST — Dodaj.

Gdy przebieg testu i/lub wynik nie są tworzone za pośrednictwem interfejsu API REST, ale w inny sposób, najpierw należy znaleźć identyfikację przebiegu testu lub wyniku, dla którego chcesz ustawić (lub zaktualizować) dane niestandardowe w polach niestandardowych, a następnie wywołać uruchomienia interfejsu API REST — aktualizacja przebiegu testu i wyników interfejsu API REST — aktualizacja wyników testu.

Aby pobrać dane niestandardowe z pól niestandardowych przechowywanych wcześniej względem przebiegu testu i/lub wyniku, należy najpierw znaleźć identyfikację przebiegu lub wyniku testu. Następnie możesz wywołać uruchomienia interfejsu API REST — zapytanie dotyczące przebiegu testu i wyników interfejsu API REST — uzyskaj wynik testu.

Dane niestandardowe dla pól niestandardowych są wysyłane lub odbierane w tablicy. Każdy element tej tablicy zawiera dwie właściwości "fieldname" i "value" i można zobaczyć przykład tego tutaj. Wartość jest obiektem typu zgodnego z typem skonfigurowanym dla pola niestandardowego. Aby zrozumieć typ pola niestandardowego, możesz użyć interfejsu API REST, który udostępnia tablicę pól niestandardowych. Dla każdego pola można znaleźć jego identyfikator, nazwę, typ i zakres. Możesz również zakodować typ, jeśli wiesz, jaki jest typ pola niestandardowego podanej nazwy.