Anpassen einer Prozessvorlage

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

Prozessvorlagen definieren die Objekte und Prozesse, die Ihnen zur Verfügung stehen, wenn Sie ein Projekt erstellen. Indem Sie eine Prozessvorlage anpassen, passen Sie eine der weiteren Objekte 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 Standardeinstellungen, die mit agilen Tools verknüpft sind

Hinweis

Wenn Sie nach Projektvorlagen für die Softwareentwicklung suchen, finden Sie 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 beispielsweise den Satz von Artefakten, die im folgenden Bild angezeigt werden.

Agile-Prozessvorlagenartefakte

Agile process template artifacts

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, Fehler, Benutzergeschichte oder Aufgabe, verwendet, um Arbeitselementabfragen und Berichte zu definieren. 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. Indem Sie jedoch die Prozessvorlage anpassen, bevor Sie Ihre Projekte erstellen, entsprechen alle daraus erstellten Projekte einem Standardsatz von Teamprozessen. Die Hauptgründe, warum Sie eine Prozessvorlage anpassen möchten, sind:

  • Sie planen, mehrere Projekte zu erstellen, und Sie möchten wiederholte 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, 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, sollten Sie das Projekt einfach erstellen und später ein oder mehrere Objekte anpassen.

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 der interdependenten Gruppe von Vorlagendateien definiert sind. Sie verwenden Ihr Projekt, um Quellcode zu organisieren, Arbeit und Informationen zu verfolgen, 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 der Anpassung einer Prozessvorlage beginnen, möchten Sie sich mit dem vertraut machen, was Sie konfigurieren und anpassen und dann ihre Änderungen entsprechend planen können.

  • Wenn Sie neu für die Verarbeitung von Vorlagen sind, überprüfen Sie zuerst die Standardprozessvorlagen.

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

    Sie können die Prozesse für Ihr Projekt ändern, nachdem sie erstellt wurde. Während Sie mit einem Projekt arbeiten, erfüllen die ursprünglichen Einstellungen, die die definierte Prozessvorlage definiert hat, möglicherweise nicht mehr Ihren Anforderungen.

  • Wenn Sie am meisten daran interessiert sind, Objekte anzupassen, die zum Nachverfolgen der Arbeit verwendet werden, einschließlich Testpläne, Testsuiten und Testfälle, überprüfen Sie Die Arbeitsverfolgungserfahrung anpassen. Die Anpassungen, die Sie vornehmen, indem Sie eine XML-Definitionsdatei für ein Projekt ändern, sind die gleichen Arten von Anpassungen, die Sie in einer Prozessvorlagendatei vornehmen.

    Wenn Sie Arbeitselementetypen hinzufügen oder ändern mö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 witadmin exportwitd- und importwitd-Befehlszeilentools 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 Features nach einem TFS-Upgrade zu unterstützen, finden Sie 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, überprüfen Sie, wie die änderungen, die Sie vornehmen, die Wartung und das Upgrade Ihrer Projekte beeinflussen.

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 "Neues 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.

Process Template Plugins

Wichtig

Wenn Sie ein Projekt aus dem 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 diese Features für ein Projekt in Ihrem lokalen TFS erstellt werden sollen, erstellen Sie Ihr Projekt dann aus Visual Studio oder Team-Explorer. Ausführliche Informationen finden Sie unter Prozessvorlage und Plug-In-Dateien, Clientunterstützung für die Projekterstellung.

Das Build-, Portal- und Berichts-Plug-In erfordert, dass die folgenden Ressourcen installiert und konfiguriert wurden.

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

Um eine Prozessvorlage anzupassen, können Sie eine oder mehrere Dateien in Zusammenhang mit einem Funktionsbereich anpassen. Während das Anpassen eines einzelnen Objekts ziemlich einfach ist, möchten Sie sicherstellen, dass Sie beim Anpassen keine Interabhängigkeiten unterbrechen. Die ProcessTemplate.xml Plug-In-Datei definiert, welche Plug-Ins in die Vorlage einbezogen 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
  • Versionssteuerung, Build, Labor- 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 Aufgaben.

    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 werden auf die Namen oder Bezeichnungen der meisten Team Foundation-Objekte gesetzt. Eine Übersicht über Benennungseinschränkungen, die für Prozessvorlagen, Sicherheitsgruppen, Bereichs- und Iterationsknoten, Arbeitsaufgabentypen und Arbeitsaufgabenfelder gelten, finden Sie unter Benennungseinschränkungen.

    • Die meisten von Ihnen angepassten Prozessvorlagenkomponenten wirken sich nur auf das Projekt aus, das Sie mithilfe der Prozessvorlage erstellen. Die Ausnahmen dieser Regel sind globale Listen, Verknüpfungstypen und Arbeitsaufgabenfelder. Diese Objekte werden für eine Projektsammlung 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 Arbeitsaufgabentypen übereinstimmen, die für eine Projektsammlung 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, wird die Änderung in allen Projekten angezeigt, die in der Auflistung und in den Arbeitsaufgabentypen definiert sind, 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, der Team Foundation Server ausgeführt wird, in 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.

    Process Template Customization Workflow

    Schritt Aufgabe
    Step 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 am häufigsten ihren Teamprozessen entspricht. Im Allgemeinen wählen Sie eine Prozessvorlage auf Grundlage von Arbeitsaufgabentypen und Workflows aus.
    Step 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.
    Step 3 Hochladen einer Prozessvorlage. Nachdem Sie Ihre Vorlage angepasst haben, laden Sie sie in die Projektsammlung hoch, in der Sie das Projekt erstellen.

    Idealerweise 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 möchten Sie, dass die Projektsammlung die gleichen Ressourcen unterstützt, 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 haben, eine Änderung vorgenommen haben und jetzt die Vorlage hochladen, müssen Sie den 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.
    Step 4 Erstellen Sie ein Projekt. Zum Testen neuer Prozessvorlagen müssen Sie ein Projekt erstellen. Sie erstellen ein Projekt, indem Sie im 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 mithilfe des Befehlszeilentools TFSDeleteProject bereinigen.
    Step 5 Überprüfen Sie Änderungen an Prozessvorlagen. Bevor Sie Ihre Prozessvorlage im Produktionsmodus ablegen und als Basis für mehrere Projekte verwenden, sollten Sie überprüfen, ob sie gut 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 im Team-Explorer angezeigt wird. Wenn Sie ein Feld hinzugefügt haben, stellen Sie sicher, dass Sie keine Schemakonflikte eingeführt haben.

    Manchmal stellen Dritte 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 Prozessvorlage verwenden, die von einem Drittanbieter bereitgestellt wird, wie beschrieben " Anpassen Ihrer Arbeitsverfolgungserfahrung, Wartungs- und Upgradeauswirkungen (TFS)" beschrieben.

    Erforderliche Berechtigungen

    Zum Herunterladen oder Hochladen von Prozessvorlagen müssen Sie entweder Mitglied der Gruppe "Project Sammlungsadministratoren" sein, oder Die Berechtigung "Prozessvorlagen verwalten" muss auf "Zulassen" festgelegt sein. Siehe Berechtigungen auf Projektsammlungsebene ändern.

    Tools, die das Anpassen einer Prozessvorlage unterstützen

    Sie können eine Prozessvorlage mithilfe eines der folgenden Tools anpassen:

    • Jeder 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.
      Rufen Sie basierend auf der Version von Visual Studio, die Sie installiert haben, das Prozess-Editor-Tool aus einer der folgenden Erweiterungen ab.

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

    • Nachverfolgung von Arbeitselementen:
      • Erstellen und Bearbeiten von WIT-Definitionen, einschließlich Hinzufügen von Feldern, Ändern von Workflows und Ändern von Arbeitsaufgabenformularen im alten Stil (pre-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
    • Versionssteuerung:
      • 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 den Auswahlen, die Sie im Assistenten "Neues Team Project" vornehmen. Weitere Informationen finden Sie unter Anpassen von TFS-Project Portalen.