Hinzufügen eines Felds und Ändern des Layouts vorhandener Arbeitsaufgabentypen

Um zusätzliche Daten für eine Arbeitsaufgabe nachzuverfolgen, können Sie einem Arbeitsaufgabentyp ein Feld hinzufügen, zeigen sie auf dem Arbeitsaufgabenformular an, und Sie können berichtsfähig.Sie können das Layout eines Arbeitsaufgabenformulars zu bestem auch ändern Aktion die Anforderungen des Teams.In diesem Thema Julia Kapazitätsauslastung und Peter, Mitglied der Fabrikam Fiber passen, zwei verschiedene Typen von Arbeitsaufgaben, um ihre Nachverfolgungsziele zu unterstützen.

Um nachzuverfolgen wo Anforderung für die neue Funktionen stammt, fügt Julia ein benutzerdefiniertes Feld mit einem Dropdownmenü von Optionen hinzu und ändert das Layout des Arbeitsaufgabenformulars für das Produktrückstandselement.Julia führt fünf Aufgaben, ein benutzerdefiniertes Feld mit einer Dropdownliste von Optionen aus hinzuzufügen und das Layout des Arbeitsaufgabenformulars für das Produktrückstandselement zu ändern.
Um den zu verbessern und auf seinem und die Fähigkeit des Teams zu verbessern Arbeit einzuschätzen, fügt Peter ein Feld der Arbeitsaufgabentyp Aufgabe hinzu.

Wie die folgende Abbildung zeigt, die Julia und der Peter ihre Aufgaben unabhängig, aber in einer vorgeschriebenen Reihenfolge ausführen.

Ändern Sie das Layout eines Arbeitsaufgabenformulars

Reihenfolge beim Hinzufügen von Feldern zu einem Arbeitsaufgabentyp

Fügen Sie einem Arbeitsaufgabenformular ein - Feld hinzu

Feld zu einem Arbeitsaufgabentyp hinzufügen

Um die Arbeitsaufgabenfelder und Felder zu überprüfen, die als berichtsfähiges in den standardmäßigen Prozessvorlagen für Team Foundation Server zugewiesen werden, finden Sie unter Arbeitsaufgabenfeldverweis für Visual Studio ALM und Referenz zu berichtsfähigen Feldern für Visual Studio ALM.

Anforderungen

Damit Sie diese Schritte ausführen können, müssen Sie Mitglied der Gruppe Team Foundation-Administratoren oder Mitglied der Gruppe Projektadministratoren für das Projekt sein.Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

Hinweis
Wenn Sie Windows Vista ausführen, verfügen Sie möglicherweise nicht über die erforderlichen Berechtigungen für bestimmte Ordner.Wenn Sie versuchen, den Arbeitsaufgabentyp an einen Speicherort zu exportieren, für den Sie keine Berechtigungen festgelegt haben, wird die exportierte Datei durch die Technologie zur Registrierungsvirtualisierung automatisch umgeleitet und in einem virtuellen Speicher gespeichert.Um diese Umleitung zu vermeiden, können Sie die Datei an einen Speicherort exportieren, für den Sie Berechtigungen festgelegt haben.Weitere Informationen zur Registrierungsvirtualisierung, finden Sie auf den folgenden Seiten der Microsoft-Website: Registrierungs-Virtualisierung und Gemeinsame Dateien und Registrierungsvirtualisierungsprobleme in Windows Vista.

Wenn Sie Windows Vista ausführen, verfügen Sie möglicherweise nicht über die erforderlichen Berechtigungen für bestimmte Ordner.Wenn Sie versuchen, den Arbeitsaufgabentyp an einen Speicherort zu exportieren, für den Sie keine Berechtigungen festgelegt haben, wird die exportierte Datei durch die Technologie zur Registrierungsvirtualisierung automatisch umgeleitet und in einem virtuellen Speicher gespeichert.Um diese Umleitung zu vermeiden, können Sie die Datei an einen Speicherort exportieren, für den Sie Berechtigungen festgelegt haben.Weitere Informationen zur Registrierungsvirtualisierung, finden Sie auf den folgenden Seiten der Microsoft-Website: Registrierungs-Virtualisierung und Gemeinsame Dateien und Registrierungsvirtualisierungsprobleme in Windows Vista.

1.Exportieren einer Arbeitsaufgaben-Typdefinition

Wenn Sie die Typdefinition aus dem Teamprojekt herunterladen, stellen Sie sicher, dass Sie mit der neuesten Version verwenden.

Hinweis
Wenn Sie geringfügige Änderungen haben und gerne mit dem XML-Format arbeiten, können Sie Dateien ändern, indem Sie Editor oder einem anderen Text-Editor.Oder, Sie können den Prozess-Editor verwenden, der ein Powertool handelt, der als Add-In für Visual Studio installiert ist.Mithilfe dieses Tools müssen Sie die Typdefinitionen nicht importieren oder exportieren.Stattdessen können Sie sie mithilfe des Prozesseditors öffnen und sie durch die Editorschnittstelle ändern. Sie können den Powertool von der folgenden Seite der Microsoft-Website herunterladen: Team Foundation Server-Toole. Informationen zum Herunterladen der Schemadateien für Prozessvorlagen finden Sie unter Index für die XML-Elementdefinitionen für Prozessvorlagen-Plug-Ins.

Wenn Sie geringfügige Änderungen haben und gerne mit dem XML-Format arbeiten, können Sie Dateien ändern, indem Sie Editor oder einem anderen Text-Editor.Oder, Sie können den Prozess-Editor verwenden, der ein Powertool handelt, der als Add-In für Visual Studio installiert ist.Mithilfe dieses Tools müssen Sie die Typdefinitionen nicht importieren oder exportieren.Stattdessen können Sie sie mithilfe des Prozesseditors öffnen und sie durch die Editorschnittstelle ändern.

Sie können den Powertool von der folgenden Seite der Microsoft-Website herunterladen: Team Foundation Server-Toole.

Informationen zum Herunterladen der Schemadateien für Prozessvorlagen finden Sie unter Index für die XML-Elementdefinitionen für Prozessvorlagen-Plug-Ins.

So exportieren Sie die Definitionsdatei eines Arbeitsaufgabentyps aus einem vorhandenen Teamprojekt

Um das witadmin-Befehlszeilentool auszuführen, öffnen Sie ein Eingabeaufforderungsfenster, wo entweder Visual Studio oder Team Explorer installiert ist, und geben Sie Folgendes ein:
```
cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
```
Ersetzen Sie bei einer 64-Bit-Windows-Edition %programfiles% durch %programfiles(x86)%.
Geben Sie den folgenden Befehl ein und für die Argumente ersetzen, die hier, wo CollectionURL die URL einer Teamprojektsammlung angibt, Projektname angibt den Namen eines Teamprojekts angezeigt werden, das in der Auflistung definiert ist, gibt WorkItemTypeName den Namen der Arbeitsaufgabe an, um zu exportieren, und Dateiname gibt den Namen und den Speicherort an, damit die exportierte Datei exportiert.Wählen Sie dann die EINGABETASTE Schlüssel aus.
```
witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:WorkItemTypeName /f:FileName
```
Beispiel: Exportieren Sie die Definition für das Produktrückstandselement

Beispielsweise verwendet Julia den folgenden Befehl, um die Typdefinition für ihren FabrikamFiber-Teamprojekt für das Produktrückstandselement in FF_ProductBItem.xml zu exportieren.
```
witadmin exportwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /n:"Product Backlog Item" /f:FF_ProductBItem.xml
```
Beispiel: Exportieren Sie die Definition für Aufgabe

Die Peter verwendet den folgenden Befehl, um die Typdefinition für die Aufgabe zu exportieren und an die Datei zu speichern, die FF_Task.xml bezeichnet wird.
```
witadmin exportwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /n:Task /f:FF_Task.xml
```
Nach erfolgreichem Abschluss wird folgende Meldung angezeigt:

Der Vorgang wurde abgeschlossen.

2.Fügen Sie ein Feld einer Typdefinition hinzu

Um ein Feld einer Typdefinition hinzuzufügen, müssen Sie ein FIELD-Element innerhalb des FIELDS-Abschnitts und ein Control-Element innerhalb des FORM-Abschnitt hinzufügen.Außerdem empfohlen, dass Sie die Benennungskonventionen entsprechen, die für Felder eingerichtet werden.

So fügen Sie einem Arbeitsaufgabentyp ein Feld hinzu

Suchen Sie den Abschnitt der XML-Datei, die die Felder für den Typ definiert und die mit FIELDS beginnt.

Fügen Sie das FIELD-Element hinzu, das den Namen des benutzerdefinierten Felds angibt, um hinzuzufügen.Sie müssen die folgenden erforderlichen Attribute angeben: benutzerfreundliches name, refname (Verweisname) und type.Weitere Informationen finden Sie unter FIELD (Definition)-Element.

Hinweis
Der Verweisname oder refname ist der programmgesteuerte Name für das Feld.Alle weiteren Regeln sollten auf diesen refname verweisen.Weitere Informationen finden Sie unter Benennungskonventionen für Arbeitsaufgabenverfolgungs-Objekte.

Beispiel: Fügen Sie ein benutzerdefiniertes Feld mit einer Menü-Liste hinzu

Beispielsweise gibt Julia den folgenden Text ein, um benutzerdefinierte Feld, den anfordernden Benutzer, mit einem Verweisnamen von FabrikamFiber.MyTeam.Requestor, der Typdefinition für das Produktrückstandselement hinzuzufügen.Sie gibt außerdem die Auswahlliste der zulässigen Werte für dieses Feld an sowie der Standardwert des Kunden für die Liste.

<FIELD name="Requestor" refname="FabrikamFiber.MyTeam.Requestor" type="String" reportable="Dimension">
   <ALLOWEDVALUES>
      <LISTITEM value="Customer" />
      <LISTITEM value="Executive Management" />
      <LISTITEM value="Other" />
      <LISTITEM value="Support" />
      <LISTITEM value="Team" />
      <LISTITEM value="Technicians" />
      <DEFAULTVALUE value="Customer" />
    </ALLOWEDVALUES>
</FIELD>

Weitere Informationen zu Auswahllisten, finden Sie unter Definieren von Auswahllisten.

Beispiel: Fügen Sie ein vordefiniertes Feld hinzu

Für die Typdefinition für Aufgabe, fügt Peter das vordefinierte Feld, Abgeschlossene Arbeit, mit einem Verweisnamen von Microsoft.VSTS.Scheduling.CompletedWork hinzu.

<FIELD name="Completed Work" refname="Microsoft.VSTS.Scheduling.CompletedWork" type="Double" reportable="measure" formula="sum" />

Eine Liste aller vordefinierten Felder, finden Sie unter Arbeitsaufgabenfeldverweis für Visual Studio ALM.

Fügen Sie das CONTROLFORM-Element innerhalb des - Abschnitts hinzu, damit das benutzerdefinierte Feld im Arbeitsaufgabenformular in der - Elementgruppe angezeigt wird, in dem es angezeigt werden soll.Sie müssen das type-Attribut des Steuerelements angeben.Weitere Informationen finden Sie unter XML-Elementreferenz für Control.

Beispiel: Fügen Sie das benutzerdefinierte Feld dem Formular zum Produktrückstandselement hinzu

Beispiel: Fügen Sie den Regler für ein Feld hinzu

Beispielsweise fügt Julia das Control-Element hinzu, sodass das Bittstellerfeld unterhalb des Felds im Arbeitsaufgabenformular, wie im folgenden Codebeispiel gezeigt wird.

<Column PercentWidth="50">
   <Group Label="Status">
      <Column PercentWidth="100">
         <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assi&amp;gned To:" LabelPosition="Left" />
         <Control FieldName="System.State" Type="FieldControl" Label="&amp;State:" LabelPosition="Left" />
         <Control FieldName="System.Reason" Type="FieldControl" Label="Reason:" LabelPosition="Left" ReadOnly="True" />
         <Control FieldName="FabrikamFiber.MyTeam.Requestor" Type="FieldControl" Label="Requestor:" LabelPosition="Left" ReadOnly="True" />
      </Column>
   </Group>
</Column>

Tipp
Die Schemadefinition für die Arbeitsaufgabenverfolgung definiert alle untergeordneten Elemente des FORM-Elements als und und alle anderen Elemente nur alle.Wenn beim Überprüfen der Typdefinitionsdateien Fehler auftreten, überprüfen Sie die Groß-/Kleinschreibung der Elemente.Die Groß-/Kleinschreibung der Start- und Endtags muss ebenfalls den Regeln der XML-Syntax entsprechen.

Die folgende Abbildung zeigt, dass das Arbeitsaufgabenformular für das Produktrückstandselement jetzt das neue Feld enthält.

Benutzerdefiniertes Feld zu Typdefinition und Formular hinzugefügt

Beispiel: Fügen Sie das vordefinierte Feld dem Formular für Aufgabe hinzu

Für die Arbeitsaufgabe für eine Aufgabe fügt Peter das Control Feld hinzu, um über dem Feld Verbleibende Arbeit wie im folgenden Codebeispiel dargestellt werden:

<Column PercentWidth="50">
   <Group Label="Details">
      <Column PercentWidth="100">
         <Control FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Type="FieldControl" Label="Completed Work:" LabelPosition="Left" />
         <Control FieldName="Microsoft.VSTS.Scheduling.RemainingWork" Type="FieldControl" Label="Remaining Work:" LabelPosition="Left" />
         <Control FieldName="Microsoft.VSTS.Common.BacklogPriority" Type="FieldControl" Label="Backlog Priority:" LabelPosition="Left" />
         <Control FieldName="Microsoft.VSTS.Common.Activity" Type="FieldControl" Label="Activity:" LabelPosition="Left" />
         <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area:" LabelPosition="Left" />
      </Column>
   </Group>
</Column>

Die folgende Abbildung zeigt, dass das Arbeitsaufgabenformular für Aufgabe jetzt das abgeschlossene Arbeitsfeld enthält.

Abgeschlossene Arbeit zu Aufgabentyp und Formular hinzufügen

Speichern Sie die Änderungen der XML-Datei.

Weitere Informationen zum Hinzufügen von Arbeitsaufgabenfeldern zu den Typdefinitionen erfahren

3.Ändern Sie das Formularlayout für Registerkartengruppen mit zwei Spalten zu einer einzelnen Spalte

Julia möchte das Formularlayout für das Produktrückstandselement ändern, damit das Textfeld die Breite des Formulars erstreckt.Wie die folgende Abbildung zeigt, das Standardlayout zwei Sätze Registerkartengruppen anzeigt.Um das Layout zu einem einzelnen Satz von Registerkartengruppen Jill zu ändern, muss das - Element der ersten Spalte zu einer 100-Prozent-Breite ändern und entfernt äußere Column und die TabGroup-Elemente aus FORM-Abschnitt.

Layout für Registerkartengruppe mit zwei Spalten

Um das Formularlayout von den ZweiSpaltenregisterkartengruppen zu einer einzelnen Spalte von Registerkartengruppen ändern

Greifen Sie auf den TabGroup-Abschnitt der XML-Datei zu.Beachten Sie, dass es Tab-Elemente wie Beschreibung, Aufgaben, Akzeptanzkriterien und Verlauf gibt, in denen jedes Tab-Element ein Control-Element, das das jeweilige Steuerelement rendert.

<Group>
   <Column PercentWidth="50">
      <TabGroup>
      . . .
      </TabGroup>
   </Column>
   <Column PercentWidth="50">
      <TabGroup>
      . . .
      </TabGroup>
   </Column>
</Group>

Konsolidieren Sie alle <Tab> . . . </Tab>-Elemente unter einem TabGroup.Entfernen Sie Group, Column äußeren und die TabGroup-Elemente.Im folgenden Beispiel wird die neue XML-Syntaxstruktur an.

<Group>
   <Column PercentWidth="100">
      <TabGroup>
      . . .
      </TabGroup>
   </Column>
</Group>

Hinweis
Um die besten Ergebnisse zu erzielen, sollte jedes Steuerelement bzw. jede Gruppe in einer Spalte angezeigt werden. Dies gilt auch, wenn sich die Spalte über die gesamte Breite des Formulars erstreckt.Ebenso sollten alle Spalten in einer Gruppe angezeigt werden, auch wenn die Gruppe keine sichtbare Bezeichnung oder Begrenzung aufweist.Weitere Informationen finden Sie unter Entwerfen und Anpassen eines Arbeitsaufgabenformulars.

Um die besten Ergebnisse zu erzielen, sollte jedes Steuerelement bzw. jede Gruppe in einer Spalte angezeigt werden. Dies gilt auch, wenn sich die Spalte über die gesamte Breite des Formulars erstreckt.Ebenso sollten alle Spalten in einer Gruppe angezeigt werden, auch wenn die Gruppe keine sichtbare Bezeichnung oder Begrenzung aufweist.Weitere Informationen finden Sie unter Entwerfen und Anpassen eines Arbeitsaufgabenformulars.

Die folgende Abbildung zeigt die einspaltigen Registerkartengruppen an.

Registerkartengruppe mit Einzelspalte

Speichern Sie die Änderungen in der XML-Datei.

4.Importieren Sie eine Arbeitsaufgaben-Typdefinition

Nachdem Sie die Typdefinition angepasst haben, müssen Sie sie in das Teamprojekt importieren, die Änderungen zu überprüfen und sie bereitzustellen zur Verwendung.Die XML-Datei, die Sie importieren, überschreibt den Inhalt der aktuellen Typdefinition.Der Importvorgang überprüft die XML-Syntax vor Upload.

So importieren Sie einen Arbeitsaufgabentyp in ein vorhandenes Teamprojekt

Im Eingabeaufforderungsfenster und im Verzeichnis, die in Schritt 1 angegeben ist, geben 1. Exportieren einer Arbeitsaufgaben-Typdefinition , zuvor in diesem Thema beschrieben, den folgenden Befehl ein und dann die EINGABETASTE Schlüssel aus.
```
witadmin importwitd /collection:CollectionURL /p:ProjectName /n:WorkItemTypeName /f:FileName
```
Beispiel: Importieren Sie die Definition für das Produktrückstandselement

Beispielsweise verwendet Jill den folgenden Befehl, um die Typdefinition für das Produktrückstandselement zu importieren, das sie an FF_ProductBItem.xml zum FabrikamFiber-Teamprojekt exportierte.
```
witadmin importwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /f:FF_ProductBItem.xml
```
Beispiel: Importieren Sie die Definition für Aufgabe

Die Peter verwendet den folgenden Befehl, um die Typdefinition für die Aufgabe zu importieren, die er an FF_Task.xml gespeichert ist.
```
witadmin importwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /f:FF_Task.xml
```
Nach erfolgreichem Abschluss wird folgende Meldung angezeigt:

Der Arbeitsaufgabentypimport wurde erfolgreich abgeschlossen.

5.Aktualisieren Sie das Teamprojekt und überprüfen Sie die Änderungen, die an einer Typdefinition vorgenommen werden

Nachdem Sie eine Typdefinition importiert haben, müssen Sie den Cache in Team Explorer aktualisieren, damit die Änderungen verfügbar sind.Sie müssen den Cache aktualisieren, wenn Sie Visual Studio geöffneten zulässig und an Team Foundation Server hergestellt haben, als Sie die Typdefinitionen importiert haben.

Aktualisieren Sie Team Explorer und erstellen Sie ein Produktrückstandselement

Teamprojekt aktualisieren und Änderungen überprüfen

Um den Cache aktualisieren

In Team Explorer wählen Sie die Schaltfläche Aktualisieren aus.

Die aktuellen Updates werden vom Server heruntergeladen, einschließlich der Änderungen, die Sie gerade importiert haben.

Warten Sie einige Sekunden, bis die Aktualisierung beendet.
Wählen Sie Arbeitsaufgaben aus.
Wählen Sie Neue Arbeitsaufgabe aus und wählen dann den Arbeitsaufgabentyp, den Sie geändert haben, wie Produktrückstands-Element oder Aufgabe aus.
Überprüfen Sie, ob die Änderungen, die Sie ausgeführt haben, in der Arbeitsaufgabenformular angezeigt wird.
Wählen Sie die Schaltfläche Schließen, um die neue Arbeitsaufgabe zu schließen.Wählen Sie die Schaltfläche Nein aus, wenn Sie aufgefordert werden, die Arbeitsaufgabe zu speichern.

Last updated on 2013-03-12