Verwenden von Arbeitselementvorlagen

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

Verwenden Sie Arbeitsaufgabenvorlagen, um Arbeitsaufgaben schnell mit vordefinierten Feldwerten zu erstellen und konsistente Aktualisierungen für mehrere Elemente anzuwenden. In diesem Artikel wird erläutert, wie Sie Vorlagen im Webportal und für ältere Umgebungen in Visual Studio 2015 oder früheren Versionen hinzufügen und verwalten. Beispiele finden Sie unter Beispielvorlagen für Arbeitsaufgaben.

Verwenden Sie das Webportal für die aktuelle Azure DevOps Erfahrung. Verwenden Sie Visual Studio 2015 nur dann, wenn Ihre Umgebung immer noch von der Team Explorer-basierten Vorlagenverwaltung abhängt.

Arbeitsaufgabenvorlagen unterscheiden sich von Prozessvorlagen. Weitere Informationen finden Sie unter "Informationen zu Prozessen und Prozessvorlagen" und den Standardartikeln zu Prozessvorlagen für grundlegende, Agile-, Scrum- und Capability Maturity Model Integration (CMMI).

Wählen Sie Ihren Workflow aus

Verwenden Sie diese Tabelle, um den richtigen Workflow auszuwählen.

Wenn Sie möchten... Verwenden... Warum?
Erfassen, Verwalten und Anwenden von Vorlagen in der aktuellen Oberfläche Webportal (primär) Teambereichsbezogene Vorlagen werden in Azure DevOps verwaltet.
Wiederverwenden zentral verwalteter Standardwerte für einen Team- und Arbeitsaufgabentyp Gespeicherte Vorlagen Vorlagen sind von Teammitgliedern auffindbar und wiederverwendbar.
Freigeben eines Schnelllinks, über den eine neue Arbeitsaufgabe mit vordefinierten Werten geöffnet wird Vorlagen-URLs Ideal für die unkomplizierte Freigabe in Dashboards, Wikis oder Mitteilungen.
Fortsetzen eines Team Explorer-basierten Legacyworkflows Visual Studio 2015 mit Power Tools (Legacy) Gilt nur, wenn Ihre Umgebung immer noch von älteren Tools abhängt.

Voraussetzungen

Voraussetzung Description
Workflow des Webportals (primär) – Zugriff auf eine Azure DevOps Organisation und ein Projekt.
– Um Vorlagen zu verwalten, müssen Sie Mitglied des Teams sein, das die Vorlagen besitzt.
- Um Vorlagen zu verwenden, müssen Sie über Contributor-Zugriff auf das Projekt verfügen.
- Verwenden Sie einen unterstützten Browser, und öffnen Sie Azure DevOps im Webportal.
Workflow für Visual Studio 2015 (veraltet) – Verwenden Sie diesen Workflow nur, wenn Ihre Umgebung immer noch von der Team Explorer-Vorlagenverwaltung abhängt.
– Installieren sie Microsoft Visual Studio Team Foundation Server 2015 Power Tools.
– In diesem Workflow erfasste Vorlagen sind benutzerspezifisch und werden nur im Team Explorer angezeigt.

Einschränkungen für die Verwendung von Vorlagen

Im Webportal definierte Vorlagen sind von vorlagen getrennt, die in Visual Studio definiert sind.

Vorlagentyp Geltungsbereich Wo Sie es verwalten und anwenden können
Webportalvorlage Teambezogen Nur Webportal
Visual Studio Vorlage Benutzerspezifisch nur Visual Studio

Sie können die URL aus beiden Vorlagentypen verwenden, um Arbeitsaufgaben über das Webportal hinzuzufügen.

Unterstützte Vorlagenaufgaben

Die Verfügbarkeit von Vorlagenaufgaben hängt von Ihrer Client- und Plattformkonfiguration ab. Verwenden Sie das Webportal für den primären Azure DevOps-Workflow. Verwenden Sie Visual Studio 2015 nur für Ältere Szenarien mit Power Tools.

In der folgenden Tabelle sind die Verfügbarkeit von Aufgaben im Webportal und im älteren Visual Studio-Workflow zusammengefasst.

Vorlagenaufgabe Webportal Visual Studio
Arbeitselement als Vorlage erfassen ✔️ ✔️
Arbeitselementvorlagen verwalten
(Definieren, Bearbeiten, Löschen, Link kopieren, Kopie erstellen und Umbenennen)
✔️ ✔️
Kopieren des Links (URL) einer Vorlage ✔️ ✔️
Hinzufügen einer Arbeitsaufgabe mithilfe einer Vorlage ✔️ ✔️
Arbeitselementvorlage definieren ✔️ ✔️
Vorlage auf ein oder mehrere Arbeitselemente anwenden ✔️ ✔️
Tags in Vorlagen hinzufügen oder daraus entfernen ✔️
Definieren einer Vorlage mit einem Link ✔️

Arbeitselement als Vorlage erfassen

Verwenden Sie das Verfahren, das Ihrem Client entspricht: Webportal (primär) oder Visual Studio 2015 und früher (Legacy).

Jede Vorlage, die Sie im Webportal erfassen, erhält eine eindeutige GUID. Führen Sie die folgenden Schritte aus, um eine Arbeitsaufgabe als Vorlage zu erfassen und dessen Link zu kopieren.

  1. Öffnen Sie im Webportal die Arbeitsaufgabe, die Sie als Vorlagenquelle verwenden möchten.

  2. Wählen Sie rechts "Weitere Aktionen>Vorlagen>erfassen" aus:

    Screenshot, der zeigt, wie man die Option „Arbeitselementfelddefinitionen als Vorlage auswählen“ aus dem Menü „Weitere Aktionen“ auswählt.

  3. Konfigurieren Sie in der Aufnahmevorlage die erforderlichen und optionalen Felder:

    • Team (erforderlich): Wählen Sie das Team aus, das der Vorlage zugeordnet werden soll.

    • Name (erforderlich): Geben Sie einen Vorlagennamen ein.

    • Felder: Verwenden Sie "Hinzufügen", um Felder einzuschließen, "Löschen", um Felder zu entfernen und feldwert nach Bedarf festzulegen.

    • Hinweise: Hinzufügen des Vorlagenkontexts. Wenn Sie eine Arbeitsaufgabe aus der Vorlage erstellen, wird dieser Text als erster Eintrag im Diskussionsthread angezeigt.

    Screenshot, der zeigt, wie Felder im Dialogfeld

  4. Wählen Sie "Speichern" und dann " Link kopieren " aus, um die Vorlagen-URL zu kopieren.

    Verwenden Sie die URL, um Arbeitsaufgaben desselben Typs mit vordefinierten Werten zu erstellen. Allgemeine Freigabeszenarien finden Sie unter Erstellen einer Arbeitsaufgabe aus einer Vorlagen-URL und Hinzufügen eines Vorlagenlinks zu einem Teamdashboard.

  5. Überprüfen Sie, ob die Vorlage in der Vorlagenliste des ausgewählten Teams für diesen Arbeitsaufgabentyp angezeigt wird, und der kopierte Link öffnet ein neues Arbeitsaufgabenformular mit vordefinierten Werten.

Arbeitselementvorlagen verwalten

Für jeden Arbeitsaufgabentyp können Sie von Ihrem Team definierte Vorlagen anzeigen und verwalten. Sie können einen Vorlagenlink hinzufügen, bearbeiten, kopieren, löschen, umbenennen und kopieren.

Gehen Sie folgendermaßen vor, um Arbeitsaufgabenvorlagen im Webportal zu öffnen:

  1. Öffnen Sie im Webportal Project Einstellungen.

  2. Wählen Sie unter Boards die Teamkonfiguration aus.

  3. Wenn Sie ein anderes Team benötigen, verwenden Sie die Teamauswahl im Breadcrumb trail.

  4. Wählen Sie auf der Seite "Boards"die Option "Vorlagen" aus:

    Screenshot, der zeigt, wie Sie auf die Liste der gespeicherten Vorlagen in Azure DevOps über Projekteinstellungen, Boards, Teamkonfiguration und Vorlagen zugreifen können.

  5. Wählen Sie einen Arbeitsaufgabentyp aus, z. B. "Fehler", "Feature" oder "Testfall", um Vorlagen für diesen Typ anzuzeigen oder hinzuzufügen:

    Screenshot der Vorlagen, die für den Typ der Fehlerarbeitsaufgabe definiert sind.

Arbeitselementvorlage erstellen

Führen Sie die folgenden Schritte aus, um eine Arbeitsaufgabenvorlage im Webportal zu erstellen:

  1. Wählen Sie auf der Seite "Arbeitsaufgabentyp" die Option "Neue Vorlage" aus:

    Screenshot, der zeigt, wie eine neue Vorlage für den Arbeitselementtyp

    Hinweis

    Wenn Sie markdown in einem großen Textfeld verwenden möchten, fügen Sie Tags zum Verwalten von Zeilenumbrüchen hinzu <br> , und stellen Sie sicher, dass das Markdown ordnungsgemäß gerendert wird.

  2. Geben Sie im Dialogfeld "Neue Vorlage " einen Namen (erforderlich) ein, und fügen Sie dann optionale Felder und Werte hinzu.

  3. Wählen Sie Speichern aus. Die Option "Link kopieren " ist verfügbar.

  4. Wählen Sie "Link kopieren" aus, um die Vorlagen-URL zu kopieren.

  5. Überprüfen Sie, ob die Vorlage für den ausgewählten Arbeitsaufgabentyp aufgeführt ist und dass der kopierte Link ein neues Arbeitsaufgabenformular mit Vorlagenwerten öffnet.

Nachdem Sie eine Vorlage gespeichert haben, können Sie sie aktualisieren, entfernen, den Link kopieren oder eine Kopie erstellen.

Wählen Sie auf der Seite "Arbeitsaufgabentyp" "Weitere Aktionen" für eine Vorlage aus, und wählen Sie dann eine der folgenden Optionen aus:

Screenshot der Menüoptionen

  • Bearbeiten: Wählen Sie "Bearbeiten", aktualisieren Sie die Vorlage, und wählen Sie dann " Speichern" aus.

  • Löschen: Wählen Sie "Löschen" aus, und bestätigen Sie dann. Gelöschte Vorlagen können nicht wiederhergestellt werden.

  • Link kopieren: Wählen Sie "Link kopieren" aus, um die Vorlagen-URL zu kopieren. Informationen zu Freigabeoptionen finden Sie unter Erstellen einer Arbeitsaufgabe aus einer Vorlagen-URL und Hinzufügen eines Vorlagenlinks zu einem Teamdashboard.

  • Kopie erstellen: Wählen Sie "Kopie erstellen", geben Sie einen Namen ein, passen Sie optional Felder an, und wählen Sie dann " Speichern" aus.

  1. Überprüfen Sie, ob die Vorlagenliste Ihre Aktion widerspiegelt (aktualisierte Werte, umbenanntes Element, kopierte Vorlage oder entfernte Vorlage).

  2. Stellen Sie sicher, dass der Link "Kopieren " ein neues Arbeitsaufgabenformular mit den erwarteten Vorlagenwerten öffnet.

Hinzufügen einer Arbeitsaufgabe mithilfe einer Vorlage

Verwenden Sie den Vorlagenlink in einem Browser, um eine Arbeitsaufgabe mit vordefinierten Werten zu erstellen.

  1. Rufen Sie den Link zur Vorlage ab. Weitere Informationen finden Sie unter "Bearbeiten", "Löschen", "Link kopieren", "Kopie erstellen".

  2. Fügen Sie den Vorlagenlink in einen Browser ein, füllen Sie die erforderlichen Felder aus, und speichern Sie Ihre Änderungen.

  3. Stellen Sie sicher, dass das neue Arbeitselement vor dem Speichern mit von der Vorlage definierten Werten ausgefüllt geöffnet wird.

Anwendung einer Vorlage auf neue oder bestehende Arbeitselemente

Wenden Sie eine Vorlage auf eine neue oder vorhandene Arbeitsaufgabe an, oder verwenden Sie eine Vorlage für Massenaktualisierungen.

Im Webportal können Sie eine Vorlage in einer geöffneten Arbeitsaufgabe oder auf ausgewählte Arbeitsaufgaben anwenden.

Anwenden einer Vorlage innerhalb eines Arbeitselements

Führen Sie die folgenden Schritte aus, um eine Vorlage auf eine neue oder vorhandene Arbeitsaufgabe anzuwenden:

  1. Öffnen Sie ein neues oder vorhandenes Arbeitselement, das Sie mit vorlagendefinierten Werten aktualisieren möchten.

  2. Wählen Sie "Weitere Aktionsvorlagen>" und dann den Namen einer vordefinierten Vorlage aus:

    Screenshot, der zeigt, wie eine Vorlage auf eine vorhandene Arbeitsaufgabe im Formular angewendet wird.

    Hinweis

    In der Vorlagenliste sind Vorlagen aufgeführt, die für Teams definiert sind, deren Mitglied Sie sind. Wenn die Liste leer ist, gibt es möglicherweise keine Vorlagen für den Arbeitsaufgabentyp. Aktualisieren Sie Ihren Browser, um die neuesten verfügbaren Vorlagen zu ermitteln.

  3. Wählen Sie "Speichern" aus, um die Vorlage anzuwenden. Feldänderungen werden im Arbeitsitemfeld Verlauf aufgezeichnet.

  4. Überprüfen Sie, ob die Felder im Formular aktualisiert werden, und die Arbeitsaufgabenhistorie zeichnet die gespeicherten Änderungen auf.

Vorlage auf mehrere Arbeitselemente anwenden

Führen Sie die folgenden Schritte aus, um eine Vorlage auf ausgewählte Arbeitsaufgaben für eine Massenaktualisierung anzuwenden:

  1. Wählen Sie Arbeitsaufgaben aus dem Backlog oder einer Abfrageergebnisliste aus. Alle ausgewählten Elemente müssen denselben Arbeitsaufgabentyp aufweisen, z. B. "Fehler" oder "Feature".

  2. Wählen Sie "Weitere Aktionsvorlagen>" für eine der ausgewählten Arbeitsaufgaben aus, und wählen Sie die anzuwendende Vorlage aus.

    Screenshot, der zeigt, wie Sie eine Vorlage auf mehrere Arbeitsaufgaben anwenden, um eine Massenaktualisierung zu erhalten.

    Die Feldänderungen werden automatisch angewendet und gespeichert. Feldänderungen werden im Feld „Verlauf“ des Arbeitselements protokolliert. Weitere Informationen zu Massenaktualisierungen finden Sie unter Massenänderungen von Arbeitsaufgaben.

  3. Überprüfen Sie, ob für jede ausgewählte Arbeitsaufgabe aktualisierte Feldwerte und entsprechende Verlaufseinträge angezeigt werden.

Tags in Vorlagen hinzufügen oder daraus entfernen

In Visual Studio 2015 oder früheren Versionen können Sie einer Vorlage Tags hinzufügen. Wenn Sie die Vorlage verwenden, gelten die Tags automatisch für die Arbeitsaufgabe. Wenn Sie zwei oder mehr Tags hinzufügen möchten, trennen Sie sie durch ein Komma (,). Sie können keine Tags im Webportal hinzufügen.

Screenshot des Dialogfelds

Wenn Sie keine zu entfernenden Tags angeben, bleiben alle Tags in einer Arbeitsaufgabe definiert. Die Tags bleiben auch dann definiert, wenn Sie eine Arbeitsaufgabenvorlage auf eine vorhandene Arbeitsaufgabe anwenden.

Überprüfen Sie in Visual Studio, dass die Vorlage die konfigurierten Tags beibehält und angewendete Arbeitsaufgaben diese Tags nach dem Speichern enthalten.

Erstellen einer Arbeitsaufgabe aus einer Vorlagen-URL

Erstellen Sie eine URL, die eine neue Arbeitsaufgabe mit vordefinierten Feldwerten öffnet. Verwenden Sie diesen Ansatz, wenn Sie eine gemeinsam nutzbare Verknüpfung zu einer gemeinsamen Arbeitsaufgabenkonfiguration wünschen.

Verwenden Sie gespeicherte Vorlagen für wiederverwendbare, vom Team verwaltete Standardwerte. Verwenden Sie Vorlagen-URLs, wenn das direkte Teilen von Links der primäre Anwendungsfall ist.

  • Verwenden Sie gespeicherte Vorlagen, wenn Ihr Team zentral verwaltete Standardwerte benötigt.
  • Verwenden Sie Vorlagen-URLs, wenn Sie sie zum unkomplizierten Teilen in Dashboards, Wikis oder Nachrichten benötigen.
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}&
. . .

Im folgenden Beispiel wird ein Arbeitselement vom Typ Task mit einem vordefinierten Titel, Zugewiesen an, Beschreibung, Tags, Aktivität und Iterationspfad erstellt.

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

Hinweis

Bei einigen Browserclients wird ein Grenzwert von 2.000 Zeichen für Feldwerte festgelegt.

Sie können die URL als Textdatei speichern oder als Link auf einem Dashboard oder einer Webseite hinzufügen.

Überprüfen Sie, ob das Öffnen der URL den richtigen Arbeitsaufgabentyp lädt und vordefinierte Feldwerte im neuen Arbeitsaufgabenformular anzeigt.

Fügen Sie Vorlagenlinks zu einem Markdown-Widget im Team-Dashboard im Webportal hinzu. Jeder Link öffnet eine neue Arbeitsaufgabe mit vordefinierten Vorlagenwerten.

Das folgende Beispiel zeigt ein Markdown-Widget mit Links zu drei Vorlagen:

Screenshot eines Markdown-Widgets mit Links zu Vorlagen.

Schritte zum Einrichten finden Sie unter Hinzufügen von Markdown zu einem Dashboard, Markdown-Widgets.

Behandeln von Vorlagenproblemen

  • Das Menü "Vorlagen" wird nicht angezeigt: Vergewissern Sie sich, dass Sie Zugriff auf das Projekt haben und dass Sie den von Ihrem Client unterstützten Workflow verwenden.
  • Die Vorlagenliste ist im Webportal leer: Stellen Sie sicher, dass Vorlagen für den ausgewählten Arbeitsaufgabentyp vorhanden sind und dass Sie Mitglied des Teams sind, das die Vorlagen besitzt. Aktualisieren Sie den Browser, um die neuesten Vorlagen zu laden.
  • Eine Teamvorlage kann nicht verwaltet werden: Stellen Sie sicher, dass Sie Mitglied des Teams sind, das die Vorlage besitzt.
  • Eine Vorlage kann nicht auf mehrere Arbeitsaufgaben angewendet werden: Vergewissern Sie sich, dass alle ausgewählten Arbeitsaufgaben den gleichen Arbeitsaufgabentyp aufweisen.
  • Visual Studio Vorlagenoptionen sind nicht verfügbar: Vergewissern Sie sich, dass Sie den Legacyworkflow Visual Studio 2015 verwenden und dass Microsoft Visual Studio Team Foundation Server 2015 Power Tools installiert sind.
  • Vorlagen-URL wird ohne erwartete Werte geöffnet: Stellen Sie sicher, dass jeder Feldverweisname für den Zielarbeitselementtyp gültig ist und dass Werte URL-codiert sind (z. B. Leerzeichen als + oder %20).
  • Die Vorlagen-URL kann nicht geladen werden: Vergewissern Sie sich, dass die URL den richtigen Organisations-, Projekt- und Arbeitsaufgabentyp verwendet und sie bei einem Konto mit Projektzugriff angemeldet sind.
  • Einige Felder aus einer Vorlage werden nicht aufgefüllt: Vergewissern Sie sich, dass die Felder weiterhin für den Arbeitsaufgabentyp vorhanden sind und nicht durch Prozessanpassungsregeln eingeschränkt sind.