Korzystanie z szablonów elementów roboczych

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

Visual Studio 2022 r. | Visual Studio 2019 r. | Visual Studio 2017 | Visual Studio 2015 r.

Szablony elementów roboczych umożliwiają tworzenie elementów roboczych ze wstępnie zdefiniowanymi wartościami i stosowanie spójnych aktualizacji w podobnych elementach. W tym artykule opisano przepływy pracy szablonów w portalu internetowym, a w przypadku starszych środowisk — w programie Visual Studio 2015 lub wcześniejszym. Przykłady można znaleźć w temacie Przykładowe szablony elementów roboczych.

W przypadku większości zespołów użyj portalu internetowego. Użyj Visual Studio 2015 z narzędziami Power Tools tylko wtedy, gdy nadal korzystasz z zarządzania szablonami opartymi na programie Team Explorer.

Szablony elementów roboczych różnią się od szablonów procesów. Aby zapoznać się z podstawowymi informacjami, zobacz About processes and process templates (Informacje o procesach i szablonach procesów) oraz wskazówki dotyczące procesów domyślnych dla opcji Podstawowa, Agile, Scrum i Integracja modelu dojrzałości możliwości (CMMI).

Tip

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

Wybieranie przepływu pracy

Użyj tej tabeli, aby wybrać najlepszy przepływ pracy dla danego scenariusza.

Jeśli chcesz... Użyj... Dlaczego
Tworzenie i stosowanie szablonów oraz zarządzanie nimi w bieżącym Azure DevOps Portal internetowy (podstawowy) Obsługuje szablony dla zespołu w standardowej wersji internetowej.
Ponowne użycie współdzielonych wartości domyślnych według zespołu i typu elementu roboczego Zapisane szablony Pomaga zespołom stosować spójne pola i wartości.
Udostępnij link bezpośredni, który otwiera wstępnie wypełniony element roboczy Adresy URL szablonów Najlepsze do łatwego udostępniania na pulpitach nawigacyjnych, w wiki i na czatach.
Kontynuuj przepływy pracy oparte na szablonach w Team Explorer Visual Studio 2015 za pomocą narzędzi Power Tools (starsza wersja) Używaj tylko wtedy, gdy środowisko nadal zależy od starszych narzędzi.

Wymagania wstępne

Workflow Requirements
Portal internetowy (podstawowy) — Dostęp do organizacji i projektu Azure DevOps.
— Aby zarządzać szablonami, musisz być członkiem zespołu, do którego należą te szablony.
- Aby zastosować szablony, musisz mieć dostęp Współautor do projektu.
— Użyj obsługiwanej przeglądarki i otwórz Azure DevOps w portalu internetowym.
Visual Studio 2015 za pomocą narzędzi Power Tools (starsza wersja) — Użyj tego przepływu pracy tylko wtedy, gdy środowisko nadal zależy od zarządzania szablonami programu Team Explorer.
- Zainstaluj Microsoft Visual Studio Team Foundation Server 2015 Power Tools.
— Szablony utworzone w tym przepływie pracy są ograniczone do zakresu użytkownika i są wyświetlane tylko w programie Team Explorer.

Ograniczenia dotyczące używania szablonów

Szablony portalu sieci Web i szablony programu Visual Studio są przechowywane w oddzielnych repozytoriach. Szablon utworzony na jednym kliencie nie jest wyświetlany w innym kliencie.

Typ szablonu Scope Gdzie można nim zarządzać Gdzie można go zastosować
Szablon portalu internetowego Zakres zespołu Portal internetowy Portal internetowy
szablon Visual Studio Ograniczony do użytkownika Visual Studio Visual Studio

Nadal możesz użyć adresu URL z dowolnego typu szablonu, aby utworzyć elementy robocze w portalu internetowym.

Obsługiwane zadania szablonu

Dostępność zadań zależy od używanego klienta. Użyj portalu internetowego dla podstawowych przepływów pracy Azure DevOps i użyj Visual Studio 2015 z narzędziami Power Tools tylko w przypadku starszych scenariuszy.

W poniższej tabeli przedstawiono obsługę klienta.

Zadanie szablonu Portal internetowy Visual Studio
Przechwytywanie elementu roboczego jako szablonu ✅ Obsługiwane ✅ Obsługiwane
Zarządzanie szablonami elementów roboczych
(Definiowanie, edytowanie, usuwanie, kopiowanie linku, tworzenie kopii i zmienianie nazwy)		 ✅ Obsługiwane ✅ Obsługiwane
Kopiowanie linku (adresu URL) szablonu ✅ Obsługiwane ✅ Obsługiwane
Dodawanie elementu roboczego przy użyciu szablonu ✅ Obsługiwane ✅ Obsługiwane
Definiowanie szablonu elementu roboczego ✅ Obsługiwane ✅ Obsługiwane
Zastosuj szablon na jeden lub więcej elementów roboczych ✅ Obsługiwane ✅ Obsługiwane
Dodawanie lub usuwanie tagów z szablonów ❌ Nieobsługiwane ✅ Obsługiwane
Definiowanie szablonu z hiperlinkiem ✅ Obsługiwane ❌ Nieobsługiwane

Przechwytywanie elementu roboczego jako szablonu

Użyj procedury zgodnej z klientem: portal internetowy (podstawowy) lub Visual Studio 2015 i starsze (starsza wersja).

Każdy przechwycony szablon w portalu internetowym otrzymuje unikatowy identyfikator GUID. Wykonaj poniższe kroki, aby przechwycić element roboczy jako szablon i skopiować jego link.

  1. W portalu internetowym otwórz element roboczy, którego chcesz użyć jako źródła szablonu.

  2. Po prawej stronie wybierz pozycję Więcej akcji>Szablony>Przechwyć:

    Zrzut ekranu przedstawiający sposób wyboru definicji pól dla przechwytywania elementu roboczego jako opcji szablonu z menu Dodatkowe akcje.

  3. W sekcji Capture Template skonfiguruj wymagane i opcjonalne pola:

    • Zespół (wymagany): wybierz zespół do skojarzenia z szablonem.

    • Nazwa (wymagana): wprowadź nazwę szablonu.

    • Pola: użyj polecenia Dodaj , aby uwzględnić pola, usuń , aby usunąć pola i ustawić wartość pola zgodnie z potrzebami.

    • Uwagi: Dodaj kontekst szablonu. Podczas tworzenia elementu roboczego na podstawie szablonu ten tekst jest wyświetlany jako pierwszy wpis w wątku Dyskusji .

    Zrzut ekranu przedstawiający sposób konfigurowania pól w oknie dialogowym szablonu przechwytywania w portalu internetowym.

  4. Wybierz pozycję Zapisz, a następnie wybierz pozycję Kopiuj link , aby skopiować adres URL szablonu.

    Użyj adresu URL, aby utworzyć elementy robocze tego samego typu ze wstępnie zdefiniowanymi wartościami. Aby zapoznać się z typowymi scenariuszami udostępniania, zobacz Tworzenie elementu roboczego na podstawie adresu URL szablonu i Dodawanie linku szablonu do pulpitu nawigacyjnego zespołu.

  5. Sprawdź, czy szablon jest wyświetlany na liście szablonów wybranego zespołu dla tego typu elementu roboczego, a skopiowany link otwiera nowy formularz elementu roboczego ze wstępnie zdefiniowanymi wartościami.

Zarządzanie szablonami elementów roboczych

Dla każdego typu elementu roboczego można wyświetlać szablony zdefiniowane przez zespół i zarządzać nimi. Możesz dodawać, edytować, kopiować, usuwać, zmieniać nazwy i kopiować link szablonu.

Wykonaj następujące kroki, aby otworzyć szablony elementów roboczych w portalu internetowym:

  1. W portalu sieci Web otwórz Ustawienia projektu.

  2. W sekcji Tablice wybierz Konfiguracja zespołu.

  3. Jeśli potrzebujesz innego zespołu, użyj selektora Team w okruszkach.

  4. Na stronie Tablice wybierz pozycję Szablony:

    Screenshot pokazujący, jak uzyskać dostęp do listy zapisanych szablonów w Azure DevOps z ustawień projektu, konfiguracji zespołu, tablic, szablonów.

  5. Wybierz typ elementu roboczego, taki jak Usterka, Funkcja lub Przypadek testowy, aby wyświetlić lub dodać szablony dla tego typu:

    Zrzut ekranu przedstawiający szablony zdefiniowane dla typu elementu roboczego usterki.

Tworzenie szablonu elementu roboczego

Wykonaj następujące kroki, aby utworzyć szablon elementu roboczego w portalu internetowym:

  1. Na stronie typ elementu roboczego wybierz pozycję Nowy szablon:

    Zrzut ekranu przedstawiający sposób dodawania nowego szablonu dla typu elementu roboczego Usterka.

    Uwaga / Notatka

    Jeśli planujesz używać języka Markdown w dużym polu tekstowym, dodaj <br> tagi do zarządzania podziałami wierszy i upewnij się, że znaczniki markdown są renderowane poprawnie.

  2. W oknie dialogowym Nowy szablon wprowadź nazwę (wymaganą), a następnie dodaj dowolne opcjonalne pola i wartości.

  3. Wybierz opcję Zapisz. Opcja Kopiuj łącze stanie się dostępna.

  4. Wybierz pozycję Kopiuj link , aby skopiować adres URL szablonu.

  5. Sprawdź, czy szablon jest wyświetlany dla wybranego typu elementu roboczego i czy skopiowany link otwiera nowy formularz elementu roboczego z wartościami szablonu.

Po zapisaniu szablonu możesz go zaktualizować, usunąć, skopiować link lub utworzyć kopię.

Na stronie typu elementu roboczego dla szablonu wybierz pozycję Więcej akcji, a następnie wybierz jedną z następujących opcji:

Zrzut ekranu przedstawiający opcje menu Więcej akcji dla wybranego szablonu.

  1. Sprawdź, czy lista szablonów odzwierciedla twoją akcję (zaktualizowane wartości, zmieniono nazwę elementu, skopiowano szablon lub usunięto szablon).

  2. Sprawdź, czy łącze Kopiuj otwiera nowy formularz elementu roboczego z oczekiwanymi wartościami szablonu.

Dodawanie elementu roboczego przy użyciu szablonu

Użyj linku szablonu w przeglądarce, aby utworzyć element roboczy ze wstępnie zdefiniowanymi wartościami.

  1. Pobierz link do szablonu. Aby uzyskać więcej informacji, zobacz Edytowanie, usuwanie, kopiowanie linku, tworzenie kopii.

  2. Wklej link szablonu do przeglądarki, wypełnij wymagane pola i zapisz zmiany.

  3. Przed zapisaniem sprawdź, czy nowy element roboczy zostanie otwarty z wartościami zdefiniowanymi przez szablon.

Stosowanie szablonu do nowych lub istniejących elementów roboczych

Zastosuj szablon do nowego lub istniejącego elementu roboczego albo użyj szablonu do aktualizacji zbiorczych.

W portalu internetowym można zastosować szablon w otwartym elemencie roboczym lub w wybranych elementach roboczych.

Stosowanie szablonu w elemencie roboczym

Wykonaj następujące kroki, aby zastosować szablon do nowego lub istniejącego elementu roboczego:

  1. Otwórz nowy lub istniejący element roboczy, który chcesz zaktualizować przy użyciu wartości zdefiniowanych przez szablon.

  2. Wybierz pozycję Więcej akcji>Szablony, a następnie wybierz nazwę wstępnie zdefiniowanego szablonu:

    Zrzut ekranu przedstawiający sposób stosowania szablonu do istniejącego elementu roboczego w formularzu.

    Uwaga / Notatka

    Lista Szablony zawiera szablony zdefiniowane dla zespołów, których jesteś członkiem. Jeśli lista jest pusta, może nie być żadnych szablonów dla typu elementu roboczego. Odśwież przeglądarkę, aby odnaleźć najnowsze dostępne szablony.

  3. Wybierz pozycję Zapisz , aby zastosować szablon. Zmiany pól są rejestrowane w polu Historia elementu roboczego.

  4. Sprawdź, czy pola zostały zaktualizowane w formularzu i czy element roboczy Historia rejestruje zapisane zmiany.

Stosowanie szablonu do kilku elementów roboczych

Wykonaj następujące kroki, aby zastosować szablon do wybranych elementów roboczych dla aktualizacji zbiorczej:

  1. Wybierz elementy robocze z Backlogu lub z listy wyników Zapytań. Wszystkie wybrane elementy muszą być tym samym typem elementu roboczego, takim jak Usterka lub Funkcja.

  2. Wybierz pozycję Więcej akcji>Szablony dla jednego z wybranych elementów roboczych i wybierz szablon do zastosowania.

    Zrzut ekranu przedstawiający sposób stosowania szablonu do wielu elementów roboczych w celu aktualizacji zbiorczej.

    Zmiany pola są stosowane i zapisywane automatycznie. Zmiany pól są rejestrowane w polu Historia elementu roboczego. Aby uzyskać więcej informacji na temat aktualizacji zbiorczych, zobacz Zbiorcze modyfikowanie elementów roboczych.

  3. Sprawdź, czy każdy wybrany element roboczy zawiera zaktualizowane wartości pól i odpowiadające im wpisy historii .

Dodawanie lub usuwanie tagów z szablonów

W Visual Studio 2015 lub starszych wersjach można dodawać tagi do szablonu. Gdy używasz szablonu, tagi są automatycznie stosowane do elementu roboczego. Aby dodać co najmniej dwa tagi, rozdziel je przecinkiem (,). Nie można dodawać tagów w portalu internetowym.

Zrzut ekranu przedstawiający okno dialogowe Edytowanie szablonu przedstawiające sposób dodawania lub usuwania tagów.

Jeśli nie określisz tagów do usunięcia, wszystkie tagi w elemencie roboczym pozostaną zdefiniowane. Tagi pozostają zdefiniowane nawet podczas stosowania szablonu elementu roboczego do istniejącego elementu roboczego.

Sprawdź w Visual Studio, czy szablon zachowuje skonfigurowane tagi i zastosowane elementy robocze zawierają te tagi po zapisaniu.

Tworzenie elementu roboczego na podstawie adresu URL szablonu

Utwórz adres URL, który otwiera nowy element roboczy ze wstępnie zdefiniowanymi wartościami pól. Użyj tego podejścia, jeśli chcesz udostępnić skrót do wspólnej konfiguracji elementu roboczego.

Użyj zapisanych szablonów jako ustawień domyślnych zarządzanych przez zespół. Używaj adresów URL szablonów, gdy bezpośrednie udostępnianie linków jest głównym sposobem korzystania.

  • Użyj zapisanych szablonów, gdy zespół potrzebuje ustawień domyślnych zarządzanych centralnie.
  • Użyj szablonów adresów URL, gdy potrzebujesz prostego udostępniania w pulpitach nawigacyjnych, wiki lub wiadomościach.
https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

Poniższy przykład tworzy element roboczy zadania ze wstępnie zdefiniowanym tytułem, przypisanym do, opisem, tagami, działaniem i ścieżką iteracji.

https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/Task?
[System.Title]=TaskTitle&
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1

http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/Task?
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1

Uwaga / Notatka

Niektórzy klienci przeglądarki nakładają limit 2000 znaków dla wartości pól.

Możesz zapisać adres URL jako plik tekstowy lub dodać go jako hiperlink na pulpicie nawigacyjnym lub stronie internetowej.

Sprawdź, czy otwarcie adresu URL ładuje prawidłowy typ elementu roboczego i wyświetla wstępnie zdefiniowane wartości pól w nowym formularzu elementu roboczego.

Dodaj linki szablonu do widżetu Markdown na pulpicie nawigacyjnym zespołu w portalu internetowym. Każde łącze otwiera nowy element roboczy ze wstępnie zdefiniowanymi wartościami szablonu.

W poniższym przykładzie przedstawiono widżet języka Markdown z linkami do trzech szablonów:

Zrzut ekranu przedstawiający widżet Markdown z linkami do szablonów.

Aby uzyskać instrukcje konfiguracji, zobacz Dodawanie języka Markdown do pulpitu nawigacyjnego, widżetów języka Markdown.

Rozwiązywanie problemów z szablonem

  • Menu Szablony nie jest wyświetlane: Sprawdź, czy masz dostęp do projektu i czy używasz przepływu pracy obsługiwanego przez klienta.
  • Lista szablonów jest pusta w portalu internetowym: upewnij się, że szablony istnieją dla wybranego typu elementu roboczego i że jesteś członkiem zespołu, który jest właścicielem szablonów. Odśwież przeglądarkę, aby załadować najnowsze szablony.
  • Nie można zarządzać szablonem zespołu: sprawdź, czy jesteś członkiem zespołu, który jest właścicielem szablonu.
  • Nie można zastosować szablonu do kilku elementów roboczych: Upewnij się, że wszystkie wybrane elementy robocze są tym samym typem elementu roboczego.
  • Opcje szablonów programu Visual Studio są niedostępne: upewnij się, że używasz starszego przepływu pracy w programie Visual Studio 2015 oraz że zainstalowano narzędzia Microsoft Visual Studio Team Foundation Server 2015 Power Tools.
  • Adres URL szablonu otwiera się bez oczekiwanych wartości: Upewnij się, że nazwa każdego pola odwołania jest prawidłowa dla docelowego typu elementu roboczego i że wartości są zakodowane w adresie URL (na przykład spacje jako + lub %20).
  • Nie można załadować adresu URL szablonu: Upewnij się, że adres URL używa poprawnego typu organizacji, projektu i elementu roboczego oraz że logujesz się do konta z dostępem do projektu.
  • Niektóre pola z szablonu nie są wypełniane: Upewnij się, że pola nadal istnieją w typie elementu roboczego i nie są ograniczone przez reguły dostosowywania procesów.

Tworzenie i stosowanie szablonów elementów roboczych za pomocą sztucznej inteligencji

W przypadku skonfigurowania Azure DevOps serwera MCP można opisać zadania związane z szablonami w języku naturalnym zamiast wykonywać każdy krok ręcznie w portalu internetowym lub programie Team Explorer.

Potraktuj następujące polecenia jako przykładowe scenariusze. Dostępne operacje mogą się różnić w zależności od wersji serwera MCP, włączonych narzędzi oraz Twoich uprawnień.

Przed uruchomieniem polecenia zastąp symbole zastępcze wartościami z Twojego środowiska: <ProjectName>, <TeamName>, <TemplateName>, <WorkItemId> i <IterationPath>.

Zadanie Przykładowy monit
Tworzenie szablonu na podstawie elementu Capture work item <WorkItemId> in project <ProjectName> as a template named "Security bug" for team <TeamName>
Utwórz nowy szablon Create a Bug template named "Regression" for team <TeamName> in project <ProjectName> with Priority 2 and tag "regression"
Stosowanie szablonu do jednego elementu Apply the "<TemplateName>" template to work item <WorkItemId> in project <ProjectName>
Zbiorcze stosowanie szablonu Apply the "<TemplateName>" template to all active Bugs tagged "regression" in project <ProjectName>
Tworzenie elementów roboczych na podstawie szablonu Create 5 Bugs in project <ProjectName> for team <TeamName> using the "<TemplateName>" template with the titles I provide
Generowanie adresu URL szablonu Generate a template URL that creates a Task in project <ProjectName> with Activity=Development and Iteration=<IterationPath>
Aktualizowanie szablonu Update the "<TemplateName>" template for team <TeamName> in project <ProjectName> to set Severity to 2 - High
Kopiowanie szablonu Create a copy of the "<TemplateName>" template named "Regression - Mobile" for team <TeamName> in project <ProjectName>
Znajdowanie zespołów, w których brakuje szablonu List teams in project <ProjectName> that don't have a Bug template defined
Inspekcja użycia szablonu Show which work items in iteration <IterationPath> were created from the "<TemplateName>" template in project <ProjectName>

Uwaga / Notatka

Jeśli używasz Visual Studio Code, tryb agenta jest szczególnie przydatny przy złożonych operacjach na szablonach.

Treści powiązane

  • Last updated on