Anpassen einer Prozessvorlage

  • Artikel

Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

Prozessvorlagen definieren die Objekte und Prozesse, die Ihnen beim Erstellen eines Projekts zur Verfügung stehen. Indem Sie eine Prozessvorlage anpassen, passen Sie eines von mehreren Objekten an. Zu den gängigen vorzunehmenden Anpassungstypen gehören:

  • Hinzufügen eines neuen Felds zu einem vorhandenen Arbeitselementtyp (WIT)
  • Ändern der Auswahlliste von Werten für ein Feld
  • Ändern der Workflowzustände, Gründe, Übergänge und Aktionen eines standard- oder benutzerdefinierten Arbeitselementtyps
  • Bearbeiten des Layouts eines Arbeitsaufgabenformulars
  • Hinzufügen oder Entfernen eines Arbeitselementtyps
  • Ändern der Prozesskonfiguration oder der Standardwerte, die Azure Boards Hubs zugeordnet sind

Hinweis

In diesem Artikel werden Prozessvorlagen beschrieben, die zum Erstellen von Projekten verwendet werden, die für Azure DevOps Services definiert sind. Wenn Sie nach Projektvorlagen für die Softwareentwicklung suchen, lesen Sie Erstellen von Visual Studio-Vorlagen.

Standardprozessvorlagen definieren Standardkonfigurationen und Arbeitselementtypen, die von Azure Boards und Azure Test Plans verwendet werden. Die Agile-Prozessvorlage definiert beispielsweise den Satz von Arbeitselementtypen, die in der folgenden Abbildung dargestellt sind.

Konzeptionelles Bild von Agile-Prozessvorlagenartefakten.

Viele dieser Artefakte hängen von Arbeitselementtypen ab, die zum Nachverfolgen der Arbeit verwendet werden. Beispielsweise werden datenfelder, die in der Definition von Feature, Bug, User Story oder Task definiert sind, auch zum Definieren von Arbeitselementabfragen verwendet. Zusätzlich zu diesen Artefakten können Sie auch die anfänglichen Projektbereiche und Iterationen, die Sicherheitskonfiguration und andere Standardeinstellungen definieren, die Testpläne unterstützen.

Nachdem Sie ein Projekt erstellt haben, können Sie Konfigurationen ändern und Artefakte anpassen. Wenn Sie jedoch die Prozessvorlage anpassen, bevor Sie Ihre Projekte erstellen, entsprechen alle daraus resultierenden Projekte einem Standardsatz von Teamprozessen. Die Hauptgründe, warum Sie eine Prozessvorlage anpassen möchten, sind:

  • Sie planen die Erstellung mehrerer Projekte und möchten sich wiederholende Aufgaben minimieren, die Sie später in jedem von Ihnen erstellten Projekt implementieren müssen.
  • Sie möchten sicherstellen, dass alle Teams bestimmte Standards einhalten, indem Sie die Vorlagen und Strukturen innerhalb des Toolsets bereitstellen, das Ihre Softwareentwicklungsteams verwenden.
  • Sie müssen eine benutzerdefinierte Prozessvorlage aktualisieren, um den Assistenten zum Konfigurieren von Features nach einem Upgrade zu unterstützen.

Wenn Sie nur mit einem einzelnen Projekt arbeiten, können Sie erwägen, das Projekt einfach zu erstellen und später ein oder mehrere Objekte anzupassen.

Wie werden Prozessvorlagen verwendet?

Die primäre Verwendung von Prozessvorlagen besteht darin, ein Projekt zu erstellen. Für das Gehostete XML-Prozessmodell wird es auch verwendet, um ein Projekt zu aktualisieren. Ein Projekt stellt den Satz von Objekten, Artefakten und Konfigurationen bereit, die in dem voneinander abhängigen Satz von Vorlagendateien definiert sind. Sie verwenden Ihr Projekt, um Quellcode zu organisieren, Arbeit und Informationen nachzuverfolgen, Software zu erstellen und Testaktivitäten zu unterstützen.

Gehostetes XML-Prozessmodell

Lokales XML-Prozessmodell

Wie sollte ich vorgehen?

Bevor Sie mit dem Anpassen einer Prozessvorlage beginnen, sollten Sie sich mit dem vertraut machen, was Sie konfigurieren und anpassen können, und ihre Änderungen dann entsprechend planen.

Prozessvorlagendateien und Funktionsbereiche, die angepasst werden können

Prozessvorlagen bestehen aus neun Plug-Ins. Jedes Plug-In definiert eine Reihe von Aufgaben, die ausgeführt werden, und die Bildschirme, die beim Erstellen eines Projekts angezeigt werden. Mit Aufgaben werden Berechtigungen festgelegt, Ordner erstellt, Dateien hochgeladen, Websites aktiviert oder andere konfigurierbare Variablen festgelegt. Plug-Ins geben außerdem die Abhängigkeiten an, die für eine Aufgabe im Hinblick auf den erfolgreichen Abschluss anderer Aufgaben bestehen.

Konzeptionelle Abbildung der Prozessvorlagen-Plug-Ins.

Wichtig

Wenn Sie ein Projekt über das Webportal erstellen, werden mehrere Prozessvorlagendateien ignoriert. Insbesondere die Dateien, die eine Berichts-Manager-Website erstellen würden, werden nicht unterstützt. Informationen zur Unterstützung der Berichterstellung für eine Projektsammlung finden Sie unter Hinzufügen von Berichten zu einem Teamprojekt.

Um eine Prozessvorlage anzupassen, können Sie eine oder mehrere Dateien in Zusammenhang mit einem Funktionsbereich anpassen. Das Anpassen eines Objekts ist zwar recht einfach, sie sollten jedoch sicherstellen, dass Sie beim Anpassen keine abhängigkeitsübergreifenden Abhängigkeiten unterbrechen. Die ProcessTemplate.xml Plug-In-Datei definiert, welche Plug-Ins in die Vorlage eingeschlossen werden sollen. Diese Datei enthält alle Aufgabengruppen, die Sie ausführen möchten, um ein Projekt zu erstellen. Jede Aufgabengruppe verweist auf eine untergeordnete XML-Plug-In-Datei, in der die spezifischen Aufgaben für das Plug-In definiert sind.

Plug-In-Abhängigkeiten

Viele Objekte basieren auf der Definition von anderen Objekten innerhalb einer Prozessvorlage. Eine Übersicht über erforderliche Plug-Ins und Plug-In-Abhängigkeiten finden Sie unter Definieren von Abhängigkeiten für Aufgabengruppen und Aufgaben.

Plug-In- und Benennungseinschränkungen

Wenn Sie einer Prozessvorlage Objekte hinzufügen, stellen Sie sicher, dass Sie sie richtig bezeichnen, um XML-Validierungsfehler zu vermeiden.

  • Für die Namen oder Bezeichnungen der meisten Team Foundation-Objekte gelten Einschränkungen. Eine Übersicht über Benennungseinschränkungen, die für Prozessvorlagen, Sicherheitsgruppen, Bereichs- und Iterationsknoten, Arbeitselementtypen und Arbeitselementfelder gelten, finden Sie unter Benennungseinschränkungen.

  • Die meisten Prozessvorlagenkomponenten, die Sie anpassen, wirken sich nur auf das Projekt aus, das Sie mithilfe der Prozessvorlage erstellen. Die Ausnahmen von dieser Regel sind globale Listen, Linktypen und Arbeitselementfelder. Diese Objekte werden für eine Projektauflistung definiert.

  • Jedes Arbeitsaufgabenfeld verfügt über einen zugeordneten Feldverweisnamen, der jedes Feld eindeutig identifiziert. Der Verweisname kann nicht mehr geändert werden, nachdem er zugewiesen wurde.

    Wenn Sie SQL Server Reporting Services für Ihre Projektsammlung verwenden, muss der Berichtsname, der einem Arbeitselementfeld zugewiesen ist, für alle Arbeitselementtypen übereinstimmen, die für die Projektauflistung definiert sind. Stimmen die Namen nicht überein, treten beim Hochladen der Prozessvorlage möglicherweise Validierungsfehler auf, oder in den Data Warehouse-Datenbanken entstehen Konflikte.

    Arbeitselementfeldnamen, Linktypnamen und globale Listen sind auf eine Projektsammlung ausgerichtet. Wenn Sie eines dieser Objekte anpassen, spiegelt sich die Änderung in allen Projekten wider, die in der Auflistung definiert sind, und in den Arbeitselementtypen, die dieses Arbeitselementfeld enthalten.

  • Die maximale Größe einer Prozessvorlage beträgt 2 GB. Stellen Sie beim Anpassen einer Prozessvorlage sicher, dass ihre Änderungen nicht über diesen Wert hinaus größer werden.

Schritte zum Anpassen einer Prozessvorlage

Beim Anpassen einer Prozessvorlage handelt es sich um ein iteratives Verfahren. Sie benötigen eine Projektsammlung, die auf einem Server definiert ist, auf dem Azure DevOps Server auf dem Sie Ihre Prozessvorlage testen können, um sicherzustellen, dass sie ordnungsgemäß angepasst wurde.

Laden Sie zum Anpassen einer Prozessvorlage zuerst eine vorhandene oder leere Prozessvorlage herunter, ändern Sie Dateien oder fügen Sie welche hinzu, laden Sie die Prozessvorlagendateien hoch und überprüfen Sie dann die Änderungen.

Konzeptionelle Abbildung, die den Workflow für die Anpassung von Prozessvorlagen zeigt.

Schritt Aufgabe
Schritt 1 Laden Sie eine Prozessvorlage herunter. Bevor Sie eine Prozessvorlage anpassen können, müssen Sie sie auf den lokalen Computer herunterladen.

Um die änderungen zu minimieren, die Sie vornehmen müssen, wählen Sie eine Vorlage aus , die Ihren Teamprozessen am ehesten entspricht. Im Allgemeinen wählen Sie eine Prozessvorlage auf Grundlage von Arbeitsaufgabentypen und Workflows aus.
Schritt 2 Ändern oder Hinzufügen von Dateien. Prozessvorlagen werden durch Ändern, Löschen oder Hinzufügen von Dateien angepasst, die für eine Prozessvorlage definiert sind. Sie passen ein Plug-In oder eine Definitionsdatei durch Ändern des XML-Inhalts an. Jede Plug-In-Datei und Typdefinitionsdatei muss der XML-Schemadefinition entsprechen.

Wenn Sie eine Prozessvorlage erstmals anpassen, sollten Sie eine kleinere Änderung vornehmen. Wenn Sie zahlreiche Änderungen vornehmen, ohne die Auswirkungen dieser Änderungen auf die Vorlage genau zu kennen, riskieren Sie eine Vielzahl von Fehlern, die das Debuggen erschweren.

Stellen Sie sicher, dass der Name der Prozessvorlage eindeutig ist. Wenn Sie eine Prozessvorlage herunterladen, Änderungen vornehmen und diese hochladen, müssen Sie den Namen ändern, da sonst die bestehende Prozessvorlage aus der Projektauflistung überschrieben wird.
Schritt 3 Laden Sie eine Prozessvorlage hoch. Nachdem Sie Ihre Vorlage angepasst haben, laden Sie sie in die Projektsammlung hoch, in der Sie das Projekt erstellen.

Im Idealfall sollten Sie eine Projektsammlung verwenden, die nicht von anderen Projekten verwendet wird. Wenn Sie in einer Prüfstand-Projektsammlung arbeiten, wird verhindert, dass durch eine bestimmte Änderung Konflikte mit bestehenden Teamprozessen verursacht werden, die sich noch in der Entwicklungsphase befinden. Außerdem soll die Projektsammlung die gleichen Ressourcen unterstützen, auf die Sie zugreifen möchten, z. B. ein Projektportal und eine Berichtswebsite.

Stellen Sie sicher, dass der Name der Prozessvorlage eindeutig ist. Wenn Sie eine Prozessvorlage aus einer Projektsammlung heruntergeladen, eine Änderung vorgenommen und die Vorlage jetzt hochladen, müssen Sie ihren Namen ändern oder die vorhandene Prozessvorlage aus der Projektsammlung löschen.

Während des Uploads wird eine Überprüfung ausgeführt, um sicherzustellen, dass die XML gültig ist. Wenn beim Hochladen der Prozessvorlage Fehler auftreten, wurde der Fehler durch die Änderungen verursacht. Überprüfen Sie die Änderungen, und korrigieren Sie sämtliche XML-Syntaxfehler, die Sie finden.
Schritt 4 Erstellen Sie ein Projekt. Zum Testen neuer Prozessvorlagen müssen Sie ein Projekt erstellen. Wenn Fehler auftreten, zeigen Sie das Protokoll für die Projekterstellung an. Das Protokoll enthält eine Liste der Aufgaben, die ausgeführt werden sollten, sowie die fehlgeschlagenen Aufgaben. Sie können fehlgeschlagene Aufgaben zum XML-Code zurückverfolgen, um die Fehlerursache zu ermitteln.

Sie können unnötige Projekte bereinigen, indem Sie das Befehlszeilentool TFSDeleteProject verwenden.
Schritt 5 Überprüfen Sie Änderungen an Prozessvorlagen. Bevor Sie Ihre Prozessvorlage in den Produktionsmodus versetzen und sie als Grundlage für mehrere Projekte verwenden, sollten Sie überprüfen, ob sie klar definiert ist. Diese Aufgabe wird ausgeführt, indem systematisch überprüft wird, ob jedes Objekt und Artefakt erwartungsgemäß funktioniert.

Tools, die das Anpassen einer Prozessvorlage unterstützen

Sie können eine Prozessvorlage mit einem der folgenden Tools anpassen:

  • Beliebiger Text-Editor oder XML-Editor zum Ändern von XML-Dateien.

  • Das Prozess-Editor-Tool.
    Basierend auf der Version von Visual Studio, die Sie installiert haben, rufen Sie das Prozess-Editor-Tool aus einer der folgenden Erweiterungen ab.