Anpassen des Webformulars für die Arbeitsnachverfolgung

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

Wichtig

Featureverfügbarkeit:Dieses Thema gilt für Anpassungen, die Sie vornehmen können, wenn Sie das gehostete XML-Prozessmodell verwenden oder Ihren Server auf Anwendungsebene auf eine Version Team Foundation Server 2017 oder höher aktualisieren (die das lokale XML-Prozessmodell verwendet). Informationen zum Vererbungsprozessmodell finden Sie unter Anpassen eines Prozesses.

Eine Übersicht über Prozessmodelle finden Sie unter Anpassen ihrer Arbeitsnachverfolgungserfahrung.

So wie Sie das Formularlayout für Ihre Arbeitselementtypen anpassen konnten, können Sie dies mit dem neuen Webformular auch weiterhin tun. Das neue Formular stellt mehrere Features zur Verfügung, die mit dem alten Formular nicht verfügbar sind. Ihr Konto- oder Projektsammlungsadministrator verwaltet den Wechsel zum neuen Formular. Wenn das neue Formular für die Konto- oder Projektsammlung aktiviert ist, wird der Abschnitt WebLayout der XML-Definition für jede in der Auflistung definierte WIT hinzugefügt.

Hinweis

Vor dem Anpassen des Webformulars muss Ihr Administrator das neue Formular aktiviert haben.

Transformierte WITs werden auf die gleiche Weise wie zuvor angepasst. Der Pfad ist je nach Plattform und vorherigen Anpassungsoptionen etwas anders.

Importieren/Exportieren von XML-Definitionsdateien

Verwenden Sie diese Sequenz, wenn Sie das lokale XML-Prozessmodell verwenden, d. h., Sie verwalten Ihre TFS-Arbeitsnachverfolgungsanpassung durch den Import einzelner XML-Definitionsdateien.

Export WIT definition fileEdit XML definition fileImport WIT definition fileRefresh and verify changes

IMPORT/EXPORT-PROZESS-ZIP-Dateien

Verwenden Sie diese Sequenz, wenn Sie das gehostete XML-Prozessmodell verwenden, d. h., wenn Sie die Anpassung der Arbeitsnachverfolgung durch Importieren eines Prozesses oder einer Prozessvorlage verwalten.

Export processEdit XML definition file(s)Import processRefresh and verify changes

Der Hauptunterschied besteht in zwei Hauptlayoutabschnitten innerhalb des FORMULAR-Knotens. Der erste Abschnitt, der im Layout-Element enthalten ist, definiert das Formularlayout, wenn es über einen Client angezeigt wird, z. B. Visual Studio. Der zweite Abschnitt, der im WebLayout-Element enthalten ist, definiert das Formularlayout, wenn es über einen Webbrowser angezeigt wird.

<FORM>
   <Layout HideReadOnlyEmptyFields="true" HideControlBorders="true">
       . . .  
   </Layout>
   <WebLayout>
       . . .  
   </WebLayout>
</FORM>

Informationen zu den angegebenen Anpassungen finden Sie in den folgenden Themen:

Importieren und Exportieren von WIT-Definitionsdateien

Hinweis

Das befehlszeilenbasierte Witadmin-Tool wird auf der Azure DevOps Services. Stattdessen verwenden Sie geerbte Prozesse, um den Arbeitselementtyp zu ändern.

  1. Wenn Sie nicht über Verwaltungsberechtigungen für Ihr Projekt verfügen, erhalten Sie diese.

  2. Öffnen Sie ein Eingabeaufforderungsfenster gemäß den Anweisungen unter witAdmin: Anpassenund Verwalten von Objekten für die Nachverfolgung von Arbeit.

    Beispiel:

    %programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer 
    
  3. Exportieren Sie die WIT-Definitionsdatei, in der Sie ein Feld ändern oder hinzufügen möchten. Geben Sie den Namen des WIT und einen Namen für die Datei an.

    witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"  
    

    Ein Beispiel für eine CollectionURL für eine Organisation ist OrganizationName.

  4. Bearbeiten Sie die Datei. Weitere Informationen finden Sie unter WebLayout-XML-Elemente.

  5. Importieren Sie die WIT-Definitionsdatei.

    witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"  
    
  6. Öffnen Sie entweder das Webportal, um die Änderungen zu sehen. Wenn der Client bereits geöffnet ist, aktualisieren Sie ihn.

    Die aktuellen Updates werden vom Server heruntergeladen, einschließlich der Änderungen, die Sie gerade importiert haben. Warten Sie einige Sekunden, bis die Aktualisierung abgeschlossen ist.

    Weitere Informationen zur Verwendung von witadmin findenSie unter Importieren, Exportieren und Verwalten von Arbeitselementtypen.

Tipp

Mit witadminkönnen Sie Definitionsdateien importieren und exportieren. Weitere Tools, die Sie verwenden können, sind der Prozess-Editor (erfordert, dass Sie eine Version von Visual Studio). Installieren Sie den Prozessvorlagen-Editor über Visual Studio Marketplace.

Sie können auch tfs team Project Managerverwenden, einen Open-Source-Client, der über GitHub.

Tipp

Mit witadminkönnen Sie Definitionsdateien importieren und exportieren. Weitere Tools, die Sie verwenden können, sind der Prozess-Editor (erfordert, dass Sie eine Version von Visual Studio). Installieren Sie den Editor für TFS-Prozessvorlagen über Visual Studio Marketplace. Sie können diese Version des Prozess-Editors verwenden, um die alten Arbeitselementformulare zu ändern. Sie können es nicht zum Bearbeiten von Formularen verwenden, die den neuen Webformularen zugeordnet sind.

Sie können auch tfs team Project Managerverwenden, einen Open-Source-Client, der über GitHub.

Tipp

Mit witadminkönnen Sie Definitionsdateien importieren und exportieren. Weitere Tools, die Sie verwenden können, sind der Prozess-Editor (erfordert, dass Sie eine Version von Visual Studio). Installieren Sie TFS Power Tools. Sie können auch tfs team Project Managerverwenden, einen Open-Source-Client, der über GitHub.

Layout und Größen ändern

Die Größe des neuen Webformulars wird abhängig von der verfügbaren Breite und der Anzahl der definierten Abschnitte geändert. Bei maximaler Breite wird in den meisten Webbrowsern jeder Abschnitt innerhalb einer Seite innerhalb einer eigenen Spalte angezeigt. Wenn die Anzeigebreite abnimmt, wird die Größe jedes Abschnitts proportional wie folgt geändert:

  • Vier Abschnitte: 40 %, 20 %, 20 % und 20 %
  • Für drei Abschnitte: 50 %, 25 % und 25 %
  • Für zwei Abschnitte: 66 % und 33 %
  • Für einen Abschnitt: 100 %.

Wenn die Anzeigebreite nicht die spaltenare Anzeige der einzelnen Abschnitte aufnehmen kann, werden Abschnitte in einer Spalte gestapelt angezeigt.

Globale Listen

Globale Listen werden in gehostetem XML anders verwaltet als auf Azure DevOps Server (und TFS). Zunächst wird witadmin nicht unterstützt, sodass keine separate globale Listendatei vorhanden ist. In gehosteten XML-Dateien werden sie an einen vorhandenen Arbeitselementtyp angefügt. Hier ist ein Beispiel...

<?xml version="1.0" encoding="utf-8"?>
<witd:WITD xmlns:witd="http://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef" application="Work item type editor" version="1.0">
  <WORKITEMTYPE name="Shared Steps" refname="Custom.SharedSteps">
    <DESCRIPTION>Server-side data for reusable set of test steps. Version: B.02</DESCRIPTION>
    <GLOBALLISTS>
      <GLOBALLIST name="Foo">
        <LISTITEM value="No" />
        <LISTITEM value="Yes" />
        <LISTITEM value="Maybe" />
        <LISTITEM value="Not Sure" />
      </GLOBALLIST>
      <GLOBALLIST name="Bar">
        <LISTITEM value="Open" />
        <LISTITEM value="Closed" />
      </GLOBALLIST>
     </GLOBALLISTS>  
     ...

Standardmäßig werden die globalen Listen an den Arbeitselementtyp Freigegebene Schritte angefügt.

Wenn Sie noch nicht mit der WIT-Anpassung noch nicht mit der WIT-Anpassung enfingen, finden Sie weitere Informationen unter Hinzufügen und Ändern einer WIT-Datei.

Importieren von Warnungen und Fehlern

Sie erhalten eine Warnung, wenn Sie eine geänderte WIT-Definition importieren, wenn Sie ein Control-Element für ein erforderliches Feld nur im WebLayout- oder Layout-Knoten hinzufügen, aber nicht im anderen.

Sie erhalten eine Fehlermeldung, wenn Sie das neue Formular aktivieren und dann eine WIT-Definition ändern, in der Sie den WebLayout-Knoten löschen.