Anpassen einer Prozessvorlage

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Wichtig

Dieser Artikel bezieht sich auf die Projektanpassung für lokale XML-Prozessmodelle. Eine Übersicht über Prozessmodelle finden Sie unter Anpassen ihrer Arbeitsnachverfolgungserfahrung.

Prozessvorlagen definieren die Objekte und Prozesse, die Ihnen beim Erstellen eines Projekts zur Verfügung stehen. Durch Anpassen einer Prozessvorlage 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 des Workflows (Zustände, Gründe, Übergänge, Aktionen) eines vorhandenen WIT
  • Bearbeiten des Layouts eines Arbeitsaufgabenformulars
  • Hinzufügen oder Entfernen eines Arbeitselementtyps
  • Ändern der Prozesskonfiguration oder der Mit Agile-Tools verknüpften Standardwerte

Hinweis

Wenn Sie nach Projektvorlagen für die Softwareentwicklung suchen, finden Sie weitere Informationen unter Erstellen Visual Studio Vorlagen. In diesem Thema werden Prozessvorlagen beschrieben, die zum Erstellen von Projekten verwendet werden, die für Azure DevOps Services und TFS definiert sind.

Standardprozessvorlagen definieren Standardkonfigurationen und die folgenden Artefakte, die Ihr Team zu Plan- und Nachverfolgunsarbeiten, zum Zusammenarbeiten und zur gemeinsamen Nutzung von Informationen verwendet.

Die Agile-Prozessvorlage definiert z. B. den In der folgenden Abbildung dargestellten Satz von Artefakten.

Agile-Prozessvorlagenartefakte

Vorlagenartefaktefür agile Prozesse

Viele dieser Artefakte hängen von den WITs ab, die zum Nachverfolgen der Arbeit verwendet werden. Beispielsweise werden datenfelder, die in der Definition von WITs definiert sind , z. B. Feature, Bug, User Story oder Task, auch zum Definieren von Arbeitselementabfragen und Berichten verwendet. Neben diesen Artefakten können Sie auch die ursprünglichen Projektbereiche und Meilensteine, die Sicherheitskonfiguration und andere Standardeinstellungen definieren, die die Versionskontrolle und die Testverwaltung 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 resultierenden Projekte, die Sie daraus erstellen, einer Standardgruppe von Teamprozessen. Die Hauptgründe, warum Sie eine Prozessvorlage anpassen möchten, sind:

  • Sie planen, mehrere Projekte zu erstellen, und Sie möchten wiederkehrende Aufgaben minimieren, die Sie später in jedem Projekt implementieren müssen, das Sie erstellen.

  • Sie möchten sicherstellen, dass alle Teams bestimmte Standards einhalten, in dem Sie Vorlagen und Strukturen für das Toolset zur Verfügung stellen, das Ihre Softwareentwicklungsteams verwendeten wird.

  • Sie müssen eine benutzerdefinierte Prozessvorlage aktualisieren, damit die Verwendung des Assistenten zum Konfigurieren von Features nach einem TFS-Upgrade unterstützt wird

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 ist das Erstellen eines Projekts. Für das Gehostete XML-Prozessmodell wird es auch zum Aktualisieren eines Projekts verwendet. 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

  • Erstellen eines Projekts

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 dann Ihre Änderungen entsprechend planen.

  • Wenn Sie noch keine Erfahrung mit der Verarbeitung von Vorlagen haben, überprüfen Sie zunächst die Standardprozessvorlagen.

  • Wenn Sie sich mit der Dateistruktur einer Prozessvorlage vertraut machen möchten, lesen Sie eine Beschreibung für jede Datei, oder laden Sie eine Prozessvorlage herunter.

    Sie können die Prozesse für Ihr Projekt ändern, nachdem es erstellt wurde. Wenn Sie mit einem Projekt arbeiten, erfüllen die anfänglichen Einstellungen, die von der Prozessvorlage definiert wurden, möglicherweise nicht mehr Ihre Anforderungen.

  • Wenn Sie am meisten an der Anpassung von Objekten interessiert sind, die zum Nachverfolgen der Arbeit verwendet werden, einschließlich Testplänen, Testsammlungen und Testfällen, lesen Sie Anpassen Ihrer Arbeitsnachverfolgungserfahrung. Die Anpassungen, die Sie durch Ändern einer XML-Definitionsdatei für ein Projekt vornehmen, sind die gleichen Anpassungstypen, die Sie in einer Prozessvorlagendatei vornehmen.

    Wenn Sie Typen von Arbeitselementen hinzufügen oder ändernmöchten, können Sie dies erreichen, ohne die gesamte Prozessvorlage zu ändern. Sie können Änderungen mithilfe eines vorhandenen Projekts vornehmen und testen. Für das lokale XML-Prozessmodell können Sie die Befehlszeilentools witadmin exportwitd und importwitd verwenden, um die XML-Definitionsdateien für Arbeitselementtypen herunterzuladen und hochzuladen.

  • Wenn Sie eine benutzerdefinierte Prozessvorlage aktualisieren müssen, um die Verwendung des Assistenten zum Konfigurieren von Funktionen nach einem TFS-Upgrade zu unterstützen, finden Sie weitere Informationen unter Konfigurieren von Features nach einem Upgrade.

    Beim Aktualisieren von TFS auf eine höhere Version werden die neuesten Versionen der standardmäßigen TFS-Prozessvorlagen hochgeladen. Um die verfügbaren aktualisierten Vorlagen zu verwenden und auf Anpassungen zuzugreifen, die Sie zuvor vorgenommen haben, müssen Sie möglicherweise Anpassungen hinzufügen, die mit den neuen Vorlagen bereitgestellt werden.

  • Wenn Sie umfangreiche Anpassungen vornehmen möchten, überprüfen Sie, wie sich die vorgenommenen Änderungen auf die Wartung und das Upgrade Ihrer Projekte auswirken.

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 angezeigt werden, wenn Sie den Assistenten für neue Team Project starten. 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.

Prozessvorlagen-Plug-Ins

Wichtig

Wenn Sie ein Projekt über das Webportal erstellen, werden mehrere Prozessvorlagendateien ignoriert. Insbesondere werden die Dateien, die eine Berichts-Manager Website und ein SharePoint Projektportal erstellen würden, nicht unterstützt.

Wenn Sie möchten, dass diese Features für ein Projekt in Ihrem lokalen TFS erstellt werden, erstellen Sie Ihr Projekt aus Visual Studio oder Team Explorer. Weitere Informationen finden Sie unter Verarbeiten von Vorlagen- und Plug-In-Dateien, Clientunterstützung für die Projekterstellung.

Für die Plug-Ins "Build", "Portal" und "Berichterstellung" sind die folgenden Ressourcen installiert und konfiguriert.

Plug-In Team Foundation Build SharePoint-Produkte SQL Server Analysis Services SQL Server Reporting Services
Entwickeln Erforderliche
Portal Erforderliche Erforderliche Empfohlen Nur erforderlich für die Unterstützung von grundlegenden Dashboards
Berichterstellung Erforderliche Erforderliche

Um eine Prozessvorlage anzupassen, können Sie eine oder mehrere Dateien in Zusammenhang mit einem Funktionsbereich anpassen. Während das Anpassen eines objekts recht einfach ist, sollten Sie sicherstellen, dass Sie beim Anpassen keine 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.

Teams, Gruppen, Berechtigungen, & Bereichs- und Iterationspfade

Arbeitselementverfolgung

  • WIT-Definitionen
  • Kategorien
  • Prozesskonfiguration
  • Linktypen
  • Arbeitselemente oder Arbeitselementabfragen
  • Versionskontroll-, Build-, Lab- und Testverwaltung

    Berichte und Projektportal

    Da die Prozessvorlage viele Komponenten eines Teamprozesses einschließt, möchten Sie die vorzunehmenden Änderungen ggf. planen, koordinieren und nachverfolgen. Insbesondere sollten Sie sich mit Projektleiter, Test-, Entwicklungsleiter und Release-Manager abstimmen, bevor Sie die Standardkonfiguration eines Bereichs ändern.

    Plug-In-Abhängigkeiten

    Viele Objekte basieren auf der Definition von anderen Objekten innerhalb einer Prozessvorlage.

    Beispielsweise verwenden Arbeitselementabfragen, die für die Agile-Prozessvorlage definiert sind, die Iterationsknoten, die in der Datei Classification.xml definiert sind. Wenn Sie die Definitionen der Iterationsknoten ändern, müssen Sie die Arbeitselementabfragen ändern, auf denen sie basieren. Diese Abfragen finden Sie durch eine Suche der folgenden Makros in den WIQ-Dateien:

    • Iteration 1 = @@Iteration%201@@
    • Iteration 2 = @@Iteration%202@@
    • Iteration 3 = @@Iteration%203@@

    Eine Übersicht über erforderliche Plug-Ins und Plug-In-Abhängigkeiten finden Sie unter Definieren von Abhängigkeiten für Aufgabengruppen und Tasks.

    Plug-In und Benennungseinschränkungen

    Wenn Sie einer Prozessvorlage Objekte hinzufügen, sollten Sie sicherstellen, dass Sie ihnen ordnungsgemäße Bezeichnungen zuweisen, um XML-Validierungsfehler zu vermeiden.

    • Einschränkungen gelten für die Namen oder Bezeichnungen der meisten Team Foundation-Objekte. 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. 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.

      Außerdem kann ein Arbeitsaufgabenfeld einen ihm zugewiesenen Berichtsnamen besitzen. Der Berichtsname muss für alle Arbeitselementtypen übereinstimmen, die für eine 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 Projektauflistung begrenzt. Wenn Sie eines dieser Objekte anpassen, wird die Änderung in allen Projekten widergespiegelt, 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 dieser Wert durch die vorgenommenen Änderungen nicht überschritten wird.

    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 Team Foundation Server ausgeführt wird, 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.

    Prozessvorlagenanpassungsworkflow

    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 besten entspricht. Im Allgemeinen wählen Sie eine Prozessvorlage auf Grundlage von Arbeitsaufgabentypen und Workflows aus.
    Schritt 2 Ändern Sie Dateien, oder fügen Sie sie hinzu. 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 Hochladen eine Prozessvorlage. 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 Berichterstellungswebsite.

    Stellen Sie sicher, dass der Name der Prozessvorlage eindeutig ist. Wenn Sie eine Prozessvorlage aus einer Projektsammlung heruntergeladen, eine Änderung vorgenommen haben 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. Um neue Prozessvorlagen zu testen, müssen Sie ein Projekt erstellen. Sie erstellen ein Projekt, indem Sie über Team Explorer auf den Assistenten für neue Team Project zugreifen.

    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 die Änderungen an den 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.

    Wenn Sie einen Bericht hinzugefügt haben, stellen Sie sicher, dass er in Team Explorer angezeigt wird. Wenn Sie ein Feld hinzugefügt haben, stellen Sie sicher, dass Sie keine Schemakonflikte eingeführt haben.

    Manchmal stellen Drittanbieter Prozessvorlagen zur Verfügung, die sie erstellt haben. Möglicherweise müssen Sie nach einem TFS-Upgrade zusätzliche Arbeit ausführen, wenn Sie eine von einem Drittanbieter bereitgestellte Prozessvorlage verwenden, wie unter Anpassen der Arbeitsnachverfolgungserfahrung, Auswirkungen auf Wartung und Upgrade (TFS)beschrieben.

    Erforderliche Berechtigungen

    Zum Herunterladen oder Hochladen von Prozessvorlagen müssen Sie entweder Mitglied der Gruppe Project Sammlungsadministratoren sein, oder Die Berechtigung Prozessvorlage verwalten muss auf Zulassenfestgelegt sein. Weitere Informationen finden Sie unter Hinzufügen von Konten zum Verwalten von Projektsammlungen.

    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.

    • TFS Team Project Manager, ein Open-Source-Client, der über GitHub verfügbar ist.

    • Das Prozess-Editor-Tool.
      Basierend auf der Version von Visual Studio Sie installiert haben, können Sie das Prozess-Editor-Tool aus einer der folgenden Erweiterungen abrufen.

    Das Prozess-Editor-Tool bietet eine Benutzeroberfläche, mit der Sie die folgenden Bereiche anpassen können:

    • Arbeitselementnachverfolgung:
      • Erstellen und Bearbeiten von WIT-Definitionen, einschließlich hinzufügen von Feldern, Ändern von Workflows und Ändern von Arbeitselementformularen im alten Stil (vor TFS 2017)
      • Erstellen und Bearbeiten von Kategorien für die Gruppierung von Arbeitsaufgabentypen
      • Bearbeiten der Prozesskonfiguration von Agile-Planungstools
      • Erstellen und Bearbeiten von Arbeitsaufgabenabfragen und zum Organisieren von Abfragen in Abfrageordnern
      • Erstellen und Bearbeiten von Linktypen
    • Project Klassifizierungen und Hierarchien:
      • Erstellen und Bearbeiten von Produktbereichspfaden
      • Erstellen und Bearbeiten von Meilensteinreleases oder Iterationspfaden
      • Ändern der Zuordnungsdatei für Microsoft Project
    • Sicherheitsgruppen:Erstellen und Bearbeiten von TFS-Gruppen und deren Berechtigungen
    • Versionskontrolle:
      • Bearbeiten der Auscheckeinstellungen
      • Erstellen und Bearbeiten von Eincheckhinweisen
      • Erstellen und Bearbeiten von TFS-Gruppen und deren Berechtigungen
    • Portal und Berichte:
      • Überprüfen von hochzuladenden Dateien und deren Ordnerstruktur
      • Dient zum Hinzufügen von hochzuladenden Dateien.

    Sie können Office Excel Berichte und Dashboards nicht über die Prozessvorlagendateien anpassen. Diese Artefakte werden für ein Projekt erstellt, abhängig von der Auswahl, die Sie im Assistenten für neue Team Project treffen. Weitere Informationen finden Sie unter Anpassen von TFS Project Portalen.