Pola niestandardowe

Azure DevOps Services

Użycie pól niestandardowych umożliwia przechowywanie danych niestandardowych w odniesieniu do wyników i/lub przebiegu testu. Dla pojedynczego projektu Azure DevOps może być zdefiniowanych maksymalnie 100 pól niestandardowych. administrator Project może zarządzać zestawem pól niestandardowych.

Warunki wstępne

Kategoria Wymagania
Dostęp do projektu członek projektu
poziomy dostępu Co najmniej podstawowy dostęp do wyświetlania elementów roboczych związanych z testami. Użytkownicy z uprawnieniami Stakeholder nie mogą uzyskać dostępu do Azure Test Plans.

Aby dodać plany testów i zestawy testów, usunąć artefakty testowe lub zdefiniować konfiguracje testów, potrzebujesz dostępu Basic + Test Plans lub subskrypcji Visual Studio: Enterprise, Test Professional lub subskrypcję platform MSDN.
uprawnienia Ścieżka obszaru:
- Edytuj elementy robocze w tym węźle: dodaj lub zmodyfikuj plany testów, zestawy testów, przypadki testowe lub inne elementy robocze oparte na testach.
- Zarządzanie planami testów: modyfikowanie właściwości planu testów, takich jak ustawienia kompilacji i testowania.
- Zarządzanie zestawami testów: tworzenie i usuwanie zestawów testów, dodawanie i usuwanie przypadków testowych z zestawów testów, zmienianie konfiguracji testów i przenoszenie zestawów testów.

Project-level:
- Zarządzanie konfiguracjami testów i zarządzanie środowiskami testowymi: zarządzanie konfiguracjami testów lub środowiskami testowymi.
- Trwałe usuwanie elementów roboczych: trwałe usuwanie elementów roboczych opartych na testach.

Aby uzyskać więcej informacji, zobacz Podręcznik dostępu do testów i uprawnień.

Zarządzanie polami niestandardowymi

Istnieją dwa sposoby zarządzania polami niestandardowymi — za pośrednictwem interfejsu API lub administrator project może to zrobić za pośrednictwem ustawień Project wybierając Test management w obszarze Pipelines. 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 raz dziennie.

Przechowywanie danych niestandardowych w polach niestandardowych

Dane własne można przechowywać w skonfigurowanych polach własnych, zarówno podczas tworzenia przebiegu lub wyniku testu, jak i po ich utworzeniu. 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 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łaj REST API Runs - Create, a aby utworzyć wyniki testu, wywołaj REST API Results - Add.

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ć zapytanie uruchomień interfejsu API REST dla przebiegu testu i pobierz wyniki interfejsu API REST dla rezultatu 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.