Hinzufügen oder Entfernen eines Felds von einem Arbeitsaufgabentyp

Artikel
07/20/2011

Wenn Sie ein Datenfeld einem Arbeitsaufgabentyp hinzuzufügen oder daraus entfernen möchten, ändern Sie die Definitionsdatei des Arbeitsaufgabentyps. Sie müssen FIELD-Elemente dem FIELDS-Bereich sowie dem Layout und den Steuerelementen, die im FORM-Bereich definiert sind, hinzufügen oder daraus entfernen. Nachdem Sie den Arbeitsaufgabentyp geändert haben, können Sie die XML-Datei importieren und den aktualisierten Arbeitsaufgabentyp verwenden.

Wichtig

Felder von Arbeitsaufgabentypen werden für eine Teamprojektsammlung verwaltet. Weitere Informationen finden Sie unter Verwalten von Arbeitsaufgabenfeldern [witadmin].

In diesem Thema

Exportieren und Öffnen der Definitionsdatei des Arbeitsaufgabentyps
Hinzufügen eines Felds
Entfernen eines Felds
Importieren und Öffnen der Definitionsdatei des Arbeitsaufgabentyps
Überprüfen der Anzeige der Änderungen im Arbeitsaufgabenformular

Erforderliche Berechtigungen

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.

Exportieren und Öffnen der Arbeitsaufgabentyp-Definitionsdatei

So exportieren und öffnen Sie die Arbeitsaufgabentyp-Definitionsdatei

Führen Sie basierend auf dem Umfang der durchzuführenden Anpassung einen der folgenden Schritte aus:

Wenn Sie für ein einzelnes Projekt einen Arbeitsaufgabentyp ändern:
1. Führen Sie witadmin exportwitd aus, um die XML-Datei für den zu bearbeitenden Arbeitsaufgabentyp zu exportieren. Geben Sie den folgenden Befehl ein, damit die Daten durch die angezeigten Argumente ersetzt werden:
```
witadmin exportwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename
```
  Weitere Informationen finden Sie unter Exportieren und Importieren von Arbeitsaufgabentypen eines vorhandenen Projekts.
2. Klicken Sie in Visual Studio auf Datei, auf Öffnen und dann auf Datei.
  
  Das Dialogfeld Datei öffnen wird angezeigt.
3. Wechseln Sie unter Suchen in in das Verzeichnis, in das Sie die Datei exportiert haben.
Wenn Sie einen Arbeitsaufgabentyp ändern, um eine Prozessvorlage anzupassen:
1. Navigieren Sie zu dem Verzeichnis, in das Sie die Prozessvorlage heruntergeladen haben.
2. Wählen Sie die Arbeitsaufgabentyp-XML-Datei aus, die Sie aktualisieren möchten, und klicken Sie dann auf Öffnen. Klicken Sie in der Eingabeaufforderung für Zeilenenden auf Nein.

Hinzufügen eines Felds

So fügen Sie einem Arbeitsaufgabentyp ein Feld hinzu

Suchen Sie den folgenden Abschnitt der XML-Datei:
```
<FIELDS>
```
Erstellen Sie ein Zeichenfolgenfeld, indem Sie den im folgenden Beispiel hervorgehobenen XML-Code eingeben:
```
<FIELDS>
<FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="Dimension">
</FIELD>
```
Tipp

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.
Suchen Sie den Abschnitt der XML-Datei, in dem das Arbeitsaufgabenformular beschrieben wird:
```
<FORM>
```

Suchen Sie die folgenden Zeilen im Abschnitt <FORM>:

<Group Label="Classification">
  <Column PercentWidth="100">
    <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
    <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
  </Column>
</Group>

Fügen Sie zum Anzeigen des Felds ein Steuerelement ein, indem Sie den im folgenden Beispiel hervorgehobenen XML-Code eingeben:

<Group Label="Classification">
  <Column PercentWidth="100">
    <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
    <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
    <Control Type="FieldControl" FieldName="MyCompany.MyProcess.IssueLevel" Label="Issue Level" LabelPosition="Left" />
  </Column>
</Group>

Klicken Sie im Menü Datei auf <Dateiname>.xml speichern, um die Änderungen der XML-Datei zu speichern.
Informationen zum Importieren des neuen Arbeitsaufgabentyps in ein einzelnes Projekt finden Sie unter Importieren und Öffnen der Definitionsdatei des Arbeitsaufgabentyps. Informationen zum Hinzufügen des Arbeitsaufgabentyps zur Prozessvorlage finden Sie unter Hinzufügen von Typdefinitionen für Arbeitsaufgaben zu einer Prozessvorlage.

Entfernen eines Felds

So entfernen Sie ein Feld aus einem Arbeitsaufgabenformular

Suchen und löschen Sie die Definition des Felds, das aus dem Arbeitsaufgabentyp entfernt werden soll. Im folgenden Beispiel ist ein Feld mit dem Namen "Issue Level" dargestellt. Zum Entfernen dieses Felds wird der folgende Feldabschnitt gelöscht:

Tipp

Der Feldabschnitt in der XML-Datei enthält möglicherweise nicht alle Elemente des folgenden Codes: Wenn Sie jedoch das Feld für den Arbeitsaufgabentyp so angepasst haben, dass diese Elemente eingeschlossen sind, müssen sie ebenfalls gelöscht werden.

<FIELDS>
. . .
<FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="dimension">
<HELPTEXT>Describes the issue level to which this special task belongs.</HELPTEXT>
  <WHEN field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">
    <ALLOWEDVALUES>
      <LISTITEM value="Planning" />
      <LISTITEM value="Review" />
    </ALLOWEDVALUES>
  </WHEN>
  <WHENNOT field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">
    <ALLOWEDVALUES>
      <LISTITEM value="Process Management" />
      <LISTITEM value="Planning" />
      <LISTITEM value="Execution" />
      <LISTITEM value="Review" />
    </ALLOWEDVALUES>
  </WHENNOT>
</FIELD>
…
</FIELDS>

Suchen Sie den Abschnitt <Layout>, in dem das Steuerelement für das Arbeitsaufgabenfeld definiert wird, und löschen Sie die entsprechenden Abschnitte, um das Feld zu entfernen. Die folgenden markierten Abschnitte sind Beispiele für die Art Code, nach dem Sie suchen müssen.

<Group Label="Classification">
  <Column PercentWidth="50">
    <Group>
      <Column PercentWidth="100">
        <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
        <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
      </Column>
    </Group>
  </Column>
  <Column PercentWidth="50">
    <Group>
      <Column PercentWidth="100">
        <Control Type="FieldControl" FieldName="MyCompany.MyProcess.IssueLevel" Label="IssueLevel" LabelPosition="Left" />
      </Column>
    </Group>
  </Column>
</Group>

Klicken Sie im Menü Datei auf <Dateiname> speichern, um die Änderungen in der XML-Datei zu speichern.

Importieren und Öffnen der Definitionsdatei des Arbeitsaufgabentyps

So importieren Sie die Definitionsdatei des Arbeitsaufgabentyps

Führen Sie witadmin importwitd aus, um die XML-Datei für den bearbeiteten Arbeitsaufgabentyp zu importieren. Geben Sie den folgenden Befehl ein, damit die Daten durch die angezeigten Argumente ersetzt werden:
```
witadmin importwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename
```
Weitere Informationen finden Sie unter Exportieren und Importieren von Arbeitsaufgabentypen eines vorhandenen Projekts.

Überprüfen der Anzeige der Änderungen im Arbeitsaufgabenformular

So überprüfen Sie die in ein einzelnes Projekt importierten Änderungen

Klicken Sie in Team Explorer mit der rechten Maustaste auf den Knoten des Teamprojekts, das die geänderte Arbeitsaufgaben-Typdefinition enthält, und klicken Sie auf Aktualisieren.

Die aktuellen Updates werden vom Server heruntergeladen, einschließlich der Änderungen, die Sie gerade importiert haben. Warten Sie einige Sekunden, bis der Knoten Arbeitsaufgaben aktualisiert wurde. Für Knoten, für die noch ein Ladevorgang ausgeführt wird, wird In Arbeit angezeigt.
Erstellen Sie mithilfe des geänderten Arbeitsaufgabentyps eine Arbeitsaufgabe, indem Sie mit der rechten Maustaste auf den Knoten Arbeitsaufgaben klicken, auf Arbeitsaufgabe hinzufügen zeigen und auf den Arbeitsaufgabentyp klicken.

Die Arbeitsaufgabe wird aus dem von Ihnen geänderten Arbeitsaufgabentyp erstellt.
Überprüfen Sie, ob die vorgenommenen Änderungen im Arbeitsaufgabenformular angezeigt werden.
Klicken Sie auf Schließen, um die neue Arbeitsaufgabe zu schließen. Klicken Sie auf Nein, wenn Sie zum Speichern der Arbeitsaufgabe aufgefordert werden.

Siehe auch

Freigeben über