Usuwanie artefaktów testowych w Azure Boards

Usługi Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Artefakty testowe, takie jak plany testów, zestawy testów i przypadki testowe, to wszystkie elementy robocze w Azure DevOps. Usunięcie ich jest trwałe w Azure DevOps Server, ale możliwe do odzyskania w usługach Azure DevOps. Zrozumienie procesu usuwania i opcji odzyskiwania ułatwia bezpieczne usuwanie.

Wskazówka

Możesz użyć sztucznej inteligencji do wsparcia tego zadania w dalszej części tego artykułu lub zobacz Włącz pomoc AI w serwerze MCP usługi Azure DevOps aby rozpocząć pracę.

Poznaj sposób działania usuwania

Zachowanie usuwania różni się między usługami Azure DevOps i Azure DevOps Server. Zrozumienie, jak każda platforma obsługuje usuwanie i jakie opcje odzyskiwania są dostępne, pomaga usunąć z ufnością.

model usuwania usług Azure DevOps

Azure DevOps Services obsługuje model usuwania nietrwałego. Usunięcie planów testów lub zestawów testów spowoduje wprowadzenie 14-dniowego okna odzyskiwania przed trwałym usunięciem.

Co się stanie po usunięciu artefaktów testowych

  1. Usunąć z magazynu danych TCM

    • Usunięty artefakt testu jest usuwany z magazynu danych usługi Test Case Management (TCM).
    • Podstawowy element roboczy skojarzony z artefaktem testowym jest usuwany.
  2. Usuwanie elementów podrzędnych

    • Zadanie w tle inicjuje usunięcie wszystkich elementów podrzędnych zarówno z magazynu danych TCM, jak i podstawowych elementów roboczych.
    • Ten proces może potrwać kilka minut, w zależności od liczby usuniętych artefaktów.
  3. Usuwanie miękkie

    • Wszystkie informacje zarówno w magazynie danych śledzenia elementów pracy, jak i w magazynie danych TCM są przenoszone do stanu usunięcia nietrwałego i można je przywrócić w ciągu 14 dni.
  4. Trwałe usunięcie

    • W żadnym wypadku nie można ponownie uaktywnić ani przywrócić usuniętych danych.

Aby przywrócić usunięty plan testu lub zestaw testów w 14-dniowej fazie usuwania nietrwałego:

  1. Uruchom interfejs Lista API, aby uzyskać Plan Testów/Zestaw Testów, który chcesz przywrócić.
  2. Jeśli interfejs API List zwraca odpowiedź zawierającą plan testów lub zestaw testów do przywrócenia, uruchom interfejs API PATCH dla Planu testów/Zestawu testów, aby je przywrócić.
  3. Jeśli interfejs API listy nie zwraca planu testu ani zestawu testów, który chcesz przywrócić, zostanie trwale usunięty z systemu i nie można go przywrócić.

Przywracanie usuniętego planu testu lub pakietu

W 14-dniowej fazie usuwania programowego można przywrócić usunięte plany testów i zestawy:

  1. Uruchom interfejs API List, aby pobrać plan testów/lub pakiet testów, które chcesz przywrócić.
  2. Jeśli interfejs API List zwraca odpowiedź zawierającą plan testów lub zestaw testów do przywrócenia, uruchom interfejs API PATCH dla Planu testów/Zestawu testów, aby je przywrócić.
  3. Jeśli interfejs API list nie zwraca planu testów lub zestawu, który chcesz przywrócić, oznacza to, że został on trwale usunięty i nie da się go odzyskać.

Ważne ograniczenia

  • Po usunięciu plany testów i zestawy testów pozostają w stanie miękkiego usunięcia przez 14 dni. Po upływie tego okresu zostaną one trwale usunięte i nie można ich przywrócić.
  • Gdy przywrócisz plan testów lub zestaw testów, wszystkie artefakty podrzędne (zestawy testów, przypadki testowe) również zostaną przywrócone.
  • Przywracanie przebiegów testów skojarzonych z planami testów i zestawami nie jest obsługiwane.
  • Przypadki testowe usunięte za pośrednictwem interfejsów API lub metod innych niż portal są trwale usuwane i nie można ich przywrócić.

model usuwania Azure DevOps Server

Ważne

Trwałe i nieodwracalne usunięcie: Azure DevOps Server obsługuje tylko trwałe usuwanie artefaktów testowych, w tym planów testów, zestawów testów, przypadków testowych, kroków udostępnionych i parametrów udostępnionych. Nie można przywrócić usuniętych artefaktów, a wszystkie skojarzone elementy podrzędne, takie jak wyniki testu, również zostaną usunięte. Ponadto zbiorcze usuwanie artefaktów testowych nie jest obsługiwane.

Wykonaj kopię zapasową wszelkich niezbędnych informacji przed usunięciem artefaktów testowych, ponieważ tej akcji nie można cofnąć.

Co się stanie po usunięciu artefaktów testowych

  1. Usuń z pamięci danych TCM:

    • Usunięty artefakt testu jest usuwany z magazynu danych usługi Test Case Management (TCM).
    • Podstawowy element roboczy skojarzony z artefaktem testowym jest usuwany.
  2. Usuń elementy podrzędne:

    • Zadanie w tle inicjuje usunięcie wszystkich elementów podrzędnych zarówno z magazynu danych TCM, jak i podstawowych elementów roboczych.
    • Ten proces może potrwać kilka minut, w zależności od liczby usuniętych artefaktów.
  3. Trwałe usunięcie:

    • Proces trwale usuwa wszystkie informacje zarówno w magazynie danych śledzenia elementów roboczych, jak i w magazynie danych TCM.
    • W żadnym wypadku nie można ponownie uaktywnić ani przywrócić usuniętych danych.

Wymagania wstępne

Kategoria Wymagania
Poziomy dostępu Podstawowe i testowe plany lub Visual Studio Enterprise do zarządzania lub usuwania artefaktów testowych. Użytkownicy z dostępem podstawowym mogą usuwać tylko oddzielone przypadki testowe (przypadki testowe nie są połączone z żadnym planem testu lub pakietem).
Uprawnienia — przebiegi testów Członek grupy Administratorzy projektu lub uprawnienie na poziomie projektu Usuń przebiegi testowe ustawione na Zezwalaj.
Uprawnienia — plany testów i pakiety testów Członek grupy Administratorzy projektu lub uprawnienie na poziomie węzła ścieżki obszaru Zarządzaj planami testów albo Zarządzaj zestawami testów ustawione na wartość Zezwalaj.

Uwaga

Jeśli nie jesteś administratorem projektu, potrzebujesz zarówno uprawnienia Usuwanie uruchomień testów na poziomie projektu, jak i odpowiednich uprawnień na poziomie węzła ścieżki obszaru.

Wskazówka

Nie wiesz, czy masz odpowiednie uprawnienia? Zobacz sekcję Weryfikowanie uprawnień usuwania .

Typy elementów roboczych, które obsługują środowisko testowania

Na poniższej ilustracji przedstawiono zestaw typów elementów roboczych, które obsługują środowisko testowe i współpracują z programem Microsoft Test Manager. Te typy elementów roboczych są połączone razem przy użyciu wyświetlanych typów linków.

Zrzut ekranu przedstawiający typy elementów roboczych zarządzania testami.

W portalu internetowym lub programie Microsoft Test Manager można wyświetlić przypadki testowe zdefiniowane dla zestawu testów oraz zestawy testów zdefiniowane dla planu testu. Te obiekty nie są jednak połączone ze sobą za pośrednictwem typów łączy. Aby zapoznać się z definicjami każdego pola używanego w tych typach elementów roboczych, zobacz Wykonywanie zapytań na podstawie pól integracji kompilacji i testowania.

Usuwanie artefaktów testowych

Warning

Usuwanie artefaktów testowych jest trwałe i nie można go cofnąć. W usługach Azure DevOps masz 14 dni na przywrócenie usuniętych planów testów i zestawów testów. W Azure DevOps Server usunięcie jest natychmiastowe i trwałe. Przed potwierdzeniem usunięcia sprawdź dokładnie wybór.

Usuwanie przypadku testowego

  1. Przejdź do przypadku testowego, który chcesz usunąć.
  2. Wybierz pozycję Trwale usuń z menu akcji.
  3. Potwierdź usunięcie w wyświetlonym oknie dialogowym.

Usuń przypadek testowy i skojarzone artefakty testowe z formularza internetowego.

Uwaga

Opcja Trwałe usuwanie jest dostępna tylko wtedy, gdy masz niezbędne uprawnienia i poziom dostępu.

Usuwanie zestawu testów

  1. Przejdź do zestawu testów, który chcesz usunąć.
  2. Wybierz pozycję Trwale usuń z menu akcji.
  3. Potwierdź usunięcie w wyświetlonym oknie dialogowym.

Potwierdź usunięcie artefaktów testowych w oknie dialogowym.

Usuwanie planu testowego

Opcja A: Usuwanie z widoku planu testowego

  1. Przejdź do planu testowego, który chcesz usunąć.
  2. Wybierz pozycję Trwale usuń z menu akcji.
  3. Potwierdź usunięcie w wyświetlonym oknie dialogowym.

Opcja B: usuwanie z centrum planów testów

  1. Otwórz plany testów.
  2. Znajdź plan testu, który chcesz usunąć na liście.
  3. Kliknij prawym przyciskiem myszy plan testu (lub wybierz ikonę menu ··· obok planu).
  4. Wybierz Usuń.
  5. Potwierdź usunięcie.

Zrzut ekranu przedstawiający stronę Plany testów, usuń plan testu.

Usuwanie kroków udostępnionych lub parametrów udostępnionych

  1. Otwórz udostępniony krok lub parametr współdzielony, który chcesz usunąć.
  2. Wybierz pozycję Pokaż odwołania , aby wyświetlić wszystkie przypadki testowe, które łączą się z tym elementem.
  3. Dla każdego przypadku testowego otwórz go i usuń link do udostępnionego kroku lub parametru.
  4. Po usunięciu wszystkich odwołań wróć do udostępnionego kroku lub parametru i wybierz pozycję Trwale usuń.
  5. Potwierdź usunięcie.

Uwaga

Jeśli opcja Trwałe usuwanie jest wyłączona, sprawdź, czy usunięto wszystkie odwołania. System blokuje usuwanie udostępnionych kroków lub parametrów, do których nadal odwołują się przypadki testowe.

Zrzut ekranu przedstawia usuwanie udostępnionych kroków z formularza.

Weryfikowanie uprawnień usuwania

Przed podjęciem próby usunięcia artefaktów testowych sprawdź, czy masz wymagane uprawnienia:

  1. Przejdź do Ustawienia projektu>Uprawnienia.
  2. Wyszukaj konto użytkownika lub zespół.
  3. Sprawdź, czy dla następujących uprawnień ustawiono wartość Zezwalaj:
    • Usuwanie przebiegów testów (w celu usunięcia wyników testu)
    • Zarządzanie planami testów lub Zarządzanie zestawami testów (na potrzeby usuwania planów testów i zestawów)
  4. Sprawdź, czy Twój poziom dostępu to Basic + Test Plans lub wyższy.
  5. Jeśli uprawnienia nie są poprawne, skontaktuj się z administratorem projektu.

Aby uzyskać więcej informacji, zobacz Zarządzanie uprawnieniami do testowania artefaktów.

Rozwiązywanie problemów z usuwaniem artefaktów testowych

Opcja "Trwałe usuwanie" nie jest wyświetlana

Możliwe przyczyny:

  • Twój poziom dostępu jest niższy niż Podstawowy + Plany testowe.
  • Nie masz wymaganych uprawnień dla tego artefaktu.
  • Nie masz uprawnień do elementu Area Path dla tej lokalizacji.

Rozwiązanie:

  1. Sprawdź poziom dostępu: przejdź do pozycji Zabezpieczenia profilu>, aby wyświetlić bieżący poziom dostępu.
  2. Sprawdź swoje uprawnienia: zobacz Weryfikowanie uprawnień usuwania.
  3. Jeśli nie jesteś administratorem projektu, poproś administratora o przypisanie wymaganych uprawnień.

Usuwanie działa wolno lub upłynął limit czasu

Możliwe przyczyny:

  • Artefakt testowy ma wiele elementów podrzędnych (przypadki testowe, zestawy testów, wyniki testów).
  • Zadanie w tle nadal przetwarza operację usuwania.
  • Problemy z łącznością sieciową

Rozwiązanie:

  • Duże usunięcia mogą potrwać kilka minut. Poczekaj, aż zadanie w tle się zakończy.
  • Odśwież stronę po odczekaniu kilku minut na zweryfikowanie usunięcia.
  • Sprawdź łączność sieciową i spróbuj ponownie.

Artefakt nadal pojawia się po usunięciu (Azure DevOps Services)

Możliwa przyczyna:

  • Artefakt jest w stanie usunięcia nieostatecznego (14-dniowy okres odzyskiwania).

Rozwiązanie:

  • W usługach Azure DevOps usunięte plany testów i zestawy testów pozostają widoczne w niektórych widokach w 14-dniowym oknie odzyskiwania.
  • Artefakt jest trwale usuwany po upływie 14 dni.
  • Aby przywrócić artefakt w tym oknie, zobacz Przywracanie usuniętego planu testu lub zestawu (w powyższej sekcji wprowadzenia).

Nie można usunąć udostępnionych kroków ani parametrów

Możliwa przyczyna:

  • Udostępniony krok lub parametr nadal zawiera odwołania z przypadków testowych.

Rozwiązanie:

  1. Otwórz udostępniony krok lub parametr.
  2. Wybierz pozycję Pokaż odwołania , aby wyświetlić wszystkie połączone przypadki testowe.
  3. Otwórz każdy przypadek testowy i usuń link.
  4. Spróbuj usunąć ponownie.

Aby uzyskać więcej informacji, zobacz sekcję Usuwanie udostępnionych kroków lub parametrów powyżej.

Usuwanie artefaktów testowych za pośrednictwem interfejsu API REST

Artefakty testowe można również usunąć programowo przy użyciu interfejsu API REST Azure DevOps. Ta metoda jest przydatna do automatyzacji, zbiorczego usuwania lub integracji z potokami CI/CD.

Usuwanie przypadku testowego

DELETE https://dev.azure.com/{organization}/{project}/_apis/test/testcase/{testCaseId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]

Usuwanie zestawu testów

DELETE https://dev.azure.com/{organization}/{project}/_apis/test/plans/{planId}/suites/{suiteId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]

Usuwanie planu testowego

DELETE https://dev.azure.com/{organization}/{project}/_apis/test/plans/{planId}?api-version=7.1
Authentication: Basic [PAT or OAuth token]

Uwaga

  • Zastąp wartości {organization}, , {project}{planId}, {suiteId}i {testCaseId} wartościami rzeczywistymi.
  • Użyj wersji 7.1 interfejsu API lub nowszej. Sprawdź wersjonowanie interfejsu API REST dla aktualnych wersji.
  • W usługach Azure DevOps można przywrócić usunięte artefakty za pośrednictwem interfejsu API w 14-dniowym oknie usuwania nietrwałego.
  • W Azure DevOps Server usuwanie za pośrednictwem interfejsu API jest trwałe.
  • Uwierzytelnianie przy użyciu osobistego tokenu dostępu (PAT) lub tokenu OAuth.

Aby uzyskać pełne informacje o interfejsie API, zobacz dokumentację referencyjną interfejsu API kosza planu testów.

Usuwanie artefaktów testowych za pomocą sztucznej inteligencji

Jeśli skonfigurujesz Azure DevOps serwer MCP dla organizacji, możesz go użyć do znajdowania i usuwania artefaktów testowych na dużą skalę przy użyciu języka naturalnego. Ta metoda jest szczególnie przydatna w przypadku usuwania zbiorczego lub złożonych zapytań, które są trudne do wykonania ręcznie.

Oto typowe wzorce zapytań języka naturalnego:

Zadanie Przykładowy monit
Usuwanie planu testowego Delete test plan <TestPlanName> in project <Contoso>
Znajdowanie starych artefaktów testowych List all test plans in project <Contoso> that aren't updated in the last 6 months
Usuwanie porzuconych zestawów testów Find all test suites in project <Contoso> that have no test runs in the last 90 days and delete them
Znajdowanie zduplikowanych przypadków testowych Identify duplicate test cases in test suite <SuiteName> that have the same title and steps
Zbiorcze usuwanie przypadków testowych według tagu Delete all test cases marked with tag "deprecated" in project <Contoso>
Usuń osierocone udostępnione kroki Find shared steps in project <Contoso> that aren't referenced by any test cases
Weryfikowanie wpływu usunięcia Before I delete test plan <TestPlanName>, show me how many test cases, test suites, and test runs are associated with it
Usuwanie starych wyników testu Delete all test results older than 1 year from test plan <TestPlanName>
Planowanie oczyszczania artefaktów What test artifacts in project <Contoso> can I safely delete to clean up the test data

Uwaga

Tryb agenta i serwer MCP używają języka naturalnego, dzięki czemu można dostosować te komunikaty lub zadać dalsze pytania w celu uściślenia wyników. W Azure DevOps Server usuwanie artefaktu testowego jest trwałe i nie można go przywrócić, więc dokładnie sprawdź wybór.