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.

Warunki wstępne

Kategoria	Wymagania
poziomy dostępu	— Co najmniej dostęp do w warstwie Podstawowa z uprawnieniami do wyświetlania elementów roboczych w odpowiedniej ścieżce obszaru. — Aby dodać plany testów i zestawy testów, usuwać artefakty testowe i definiować konfiguracje testowe: dostęp Basic + Test Plans. Lub jedną z następujących subskrypcji programu Visual Studio: - Enterprise - Test Professional - platformy MSDN
uprawnienia	— Aby dodać lub zmodyfikować plany testów, zestawy testów, przypadki testowe lub inne typy elementów roboczych opartych na testach: Edytuj elementy robocze w tym węźle uprawnienia ustawione na Zezwalaj w ramach odpowiedniej ścieżki obszaru . — Aby zmodyfikować właściwości planu testów, takie jak ustawienia kompilacji i testowania: uprawnienie do zarządzania planami testów ustawione na Zezwalaj w ramach odpowiedniej ścieżki obszaru . — aby tworzyć i usuwać zestawy testów, dodawać i usuwać przypadki testowe z zestawów testów, zmieniać konfiguracje testów połączone z zestawami testów i modyfikować hierarchię zestawów testów (przenieść zestaw testów): Zarządzanie zestawami testów z uprawnieniami ustawionymi na Zezwalaj w ramach odpowiedniej ścieżki obszaru .

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 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 .

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.

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.