Exemplarische Vorgehensweise: Verwalten von Feldern in einem Arbeitsaufgabentyp

Aktualisiert: November 2007

In dieser exemplarischen Vorgehensweise werden Sie Felder, die von Arbeitsaufgabentypen auf einem Team Foundation Server verwendet werden, anzeigen, umbenennen und löschen. Felder können viele Arbeitsaufgabentypen in verschiedenen Teamprojekten umfassen.

In diesem Abschnitt werden die folgenden Vorgänge behandelt:

• Anzeigen von Feldern   In diesem Vorgang geben Sie die Felder eines Arbeitsaufgabentyps aus und zeigen diese an.

• Umbenennen von Feldern   In diesem Vorgang ändern Sie den Namen eines Felds und können dann sehen, wie sich diese Änderung auf das Formular auswirkt.

• Löschen von Feldern   In diesem Vorgang löschen Sie ein Feld, das Sie dem Arbeitsaufgabenformular in einem vorausgegangenen Vorgang hinzugefügt haben.

Vorbereitungsmaßnahmen

Führen Sie die in Exemplarische Vorgehensweise: Vornehmen von grundlegenden benutzerdefinierten Anpassungen für einen Arbeitsaufgabentyp und Exemplarische Vorgehensweise: Durchführen von erweiterten Anpassungen für einen Arbeitsaufgabentyp aufgeführten Schritte aus.

Wenn Sie eine Verbindung mit einem Team Foundation Server herstellen können und über die entsprechenden Berechtigungen verfügen, können Sie Felder für einen Arbeitsaufgabentyp an einer Eingabeaufforderung, in einer Batchdatei oder einer Skriptdatei verwalten. Hierzu müssen Sie entweder das Dienstprogramm Visual Studio 2008-Eingabeaufforderung verwenden oder an der aktuellen Eingabeaufforderung mithilfe von vsvars32 verschiedene Umgebungsvariablen festlegen, wie im folgenden Beispiel beschrieben. Weitere Informationen über das Beitreten zu einem Teamprojekt finden Sie unter Exemplarische Vorgehensweise: Herstellen einer Verknüpfung mit einem Teamprojekt.

So aktivieren Sie Team Foundation-Befehle an einer Eingabeaufforderung

• Klicken Sie auf Start, zeigen Sie auf Alle Programme, auf Microsoft Visual Studio 2008 und auf Visual Studio-Tools, und klicken Sie anschließend auf Visual Studio 2008-Eingabeaufforderung.

Stattdessen können Sie auch vsvars32 im Visual Studio-Installationspfad ausführen. Dieser lautet i. d. R. DriveLetter:\Programme\Microsoft Visual Studio 9.0\Common7\Tools.

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.

Anzeigen von Feldern

So zeigen Sie Felder an

1. Öffnen Sie eine Visual Studio-Eingabeaufforderung.

2. Geben Sie alle in Team Foundation Server definierten Felder in eine Textdatei aus, indem Sie an der Eingabeaufforderung Folgendes eingeben und dann die EINGABETASTE drücken.

3. witfields view /s:"Team Foundation Server-Name"

   Hiermit wird die Liste der Felder mit den folgenden Informationen angezeigt:

   Feld:	Der Verweisname des Felds.
   Name:	Der angezeigte Name des Felds.
   Typ:	Der Datentyp des Felds.
   Bericht möglich als:	Die Berichterstellungseinstellungen für das Feld.
   Mit:	Die Teamprojekte, die dieses Feld verwenden, und die Arbeitsaufgabentypen, in denen dieses Feld angezeigt wird.

Umbenennen von Feldern

So benennen Sie Felder um

1. Geben Sie an der Visual Studio-Eingabeaufforderung Folgendes ein, und drücken Sie anschließend die EINGABETASTE.

   witfields rename /s:"Team Foundation Server-Name" Microsoft.VSTS.Common.Rank Importance

   Mit diesem Befehl wird das Feld Rank in Importance umbenannt.

2. Geben Sie an der Eingabeaufforderung zur Bestätigung y ein, und drücken Sie die EINGABETASTE. Warten Sie, bis die folgende Meldung angezeigt wird:

   Field renamed.

3. Klicken Sie in Visual Studio im Fenster Team Explorer auf Aktualisieren, um die neuesten Aktualisierungen vom Server herunterzuladen.

   Warten Sie einige Sekunden, bis alle Knoten geladen wurden. Für Knoten, die noch geladen werden, wird in Arbeit angezeigt.

4. Klicken Sie mit der rechten Maustaste auf den Knoten Arbeitsaufgaben, und wählen Sie dann Abfrage hinzufügen aus, um eine neue Abfrage zu erstellen.

5. Klicken Sie in den mit Klicken Sie hier, um eine Klausel hinzuzufügen bezeichneten Bereich, um eine neue Zeile hinzuzufügen. Wählen Sie dann die leere Zelle Feld aus. Geben Sie in die Zelle Rank ein. Oberhalb der Ergebnisliste wird eine Meldung angezeigt. Diese Meldung gibt an, dass Rank nicht gefunden werden kann.

   Führen Sie die Abfrage aus, um sich die Abfrageergebnisse anzeigen zu lassen. TF51005: Die Abfrage verweist auf ein Feld, das nicht vorhanden ist. Der Fehler wird durch <<Rank>> verursacht.

6. Löschen Sie den Wert Rank aus der Zelle Feld, und geben Sie in die Zelle Importance ein.

7. Wählen Sie in der Zelle Operator die Option < > aus, und geben Sie in die Zelle Wert den Wert 1 ein.

8. Klicken Sie im Menü Team auf Abfrage ausführen.

9. Klicken Sie in den Ergebnissen mit der rechten Maustaste auf eine beliebige Zeile, und wählen Sie Spaltenoptionen aus. Führen Sie in der Liste Verfügbare Spalten einen Bildlauf nach unten durch. Das Feld Rank ist nicht mehr vorhanden, dafür wird nun das Feld Importance angezeigt.

10. Wählen Sie im Feld Verfügbare Spalten die Option Importance aus, und klicken Sie dann auf die Schaltfläche zum Hinzufügen ausgewählter Spalten (>). Klicken Sie auf OK.

    Der angezeigte Name für Microsoft.VSTS.Common.Rank wurde im Abfrage-Generator und den Ergebnislisten von Rank in Importance umbenannt.

11. Klicken Sie zum Schließen der Abfrage auf Schließen. Klicken Sie auf Nein, wenn Sie zum Speichern der Abfrage aufgefordert werden.

12. Erstellen Sie eine neue Arbeitsaufgabe vom Typ Spezielle Aufgabe. Klicken Sie hierfür mit der rechten Maustaste auf den Knoten Arbeitsaufgabe, zeigen Sie auf Arbeitsaufgabe hinzufügen, und klicken Sie dann auf SpecialTask.

    Diese Arbeitsaufgabe wird aus dem von Ihnen geänderten und importierten Arbeitsaufgabentyp erstellt.

13. Beachten Sie, dass sich die Bezeichnung für das umbenannte Feld Rank im Feld Status nicht geändert hat. Das liegt daran, dass sich die Feldbezeichnungen auf dem Arbeitsaufgabenformular auf das übergeordnete Teamprojekt beziehen und nicht von dem eben angegebenen serverweit gültigen Feldnamen abhängig sind.

    Hinweis:
    Weitere Informationen zum Ändern von Feldbezeichnungen auf Arbeitsaufgabenformularen finden Sie in Exemplarische Vorgehensweise: Durchführen von erweiterten Anpassungen für einen Arbeitsaufgabentyp im Verfahren "Anpassen einer Feldbezeichnung".

14. Klicken Sie auf Schließen, um die neue spezielle Aufgabe zu schließen. Klicken Sie auf Nein, wenn Sie zum Speichern der Arbeitsaufgabe aufgefordert werden.

Löschen von Feldern

Vorbedingung: Sie haben das in Exemplarische Vorgehensweise: Vornehmen von grundlegenden benutzerdefinierten Anpassungen für einen Arbeitsaufgabentyp unter "Add a Field/Hinzufügen eines Felds" beschriebene Verfahren durchgeführt.

So löschen Sie Felder

1. Versuchen Sie, das Feld Category zu löschen, das mit dem Verfahren "Hinzufügen eines Felds" hinzugefügt wurde. Geben Sie hierfür an der Visual Studio-Eingabeaufforderung Folgendes ein, und drücken Sie dann die EINGABETASTE.

   witfields delete /s:"Team Foundation Server-Name" MyCompany.MyProcess.Category

   Sie werden in einer Fehlermeldung informiert, dass das Feld von einem Teamprojekt verwendet und daher nicht gelöscht werden kann.

2. Geben Sie den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE.

   witexport /f "Dateipfad\specialtask.xml" /t "Team Foundation Server-Name" /p WITLab /n "Special Task"

   Mit diesem Befehl wird die Definition des Arbeitsaufgabentyps Spezielle Aufgabe vom Team Foundation Server in eine XML-Datei exportiert. Diese enthält auch die neue Definition des Felds Microsoft.VSTS.Common.Rank mit dem neuen angezeigten Namen, nachdem dieses im Verfahren Umbenennen von Feldern umbenannt wurde.

   Hinweis:

   Unter Windows Vista haben Sie möglicherweise keine Zugriffsrechte für bestimmte Ordner. Wenn Sie versuchen, den Arbeitsaufgabentyp an einen Speicherort zu exportieren, für den Sie keine Zugriffsrechte besitzen, wird die exportierte Datei durch die Technologie zur Registrierungsvirtualisierung automatisch umgeleitet und in einem virtuellen Speicher gespeichert. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?LinkId=92325 und unter https://go.microsoft.com/fwlink/?LinkId=92323. Um diese Umleitung zu vermeiden, können Sie die Datei an einen Speicherort exportieren, für den Sie über Zugriffsrechte verfügen.

   Nachdem der Exportvorgang abgeschlossen ist, wird folgende Meldung angezeigt:

   Work item type export complete.

3. Klicken Sie in Visual Studio auf Datei, zeigen Sie auf Öffnen, und klicken Sie dann auf Datei.

   Das Dialogfeld Datei öffnen wird angezeigt.

   Hinweis:
   Wenn SpecialTask.xml geöffnet ist, wird möglicherweise eine Meldung angezeigt, in der Sie gefragt werden, ob die Datei in Visual Studio erneut geladen werden soll. Klicken Sie zum erneuten Laden auf Ja.

4. Navigieren Sie unter Suchen in zu dem Verzeichnis, in das Sie die Datei exportiert haben.

5. Klicken Sie auf die Datei specialtask.xml und dann auf Öffnen.

6. Klicken Sie in der Aufforderungsmeldung zu Zeilenenden auf Nein.

7. Suchen Sie die Definition des Felds Category, die im folgenden XML-Code angezeigt wird, und löschen Sie die Definition:

   <FIELD name="Category" refname="MyCompany.MyProcess.Category" type="String" reportable="dimension"><HELPTEXT>Describes the category 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>
   

8. Suchen Sie im Abschnitt <Layout> den folgenden XML-Code, und löschen Sie die hervorgehobenen Abschnitte, um das Feld zu entfernen:

   <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.Category" Label="Category" LabelPosition="Left" />      </Column>    </Group>  </Column>
   </Group>
   

9. Klicken Sie auf Speichern, um die Änderungen in der XML-Datei zu speichern.

10. Importieren Sie den geänderten Arbeitsaufgabentyp Spezielle Aufgabe in Team Foundation Server. Geben Sie hierfür an der Visual Studio-Eingabeaufforderung Folgendes ein, und drücken Sie die EINGABETASTE:

    witimport /f "Dateipfad\specialtask.xml" /t "Team Foundation Server-Name" /p WITLab

    Hiermit wird der Arbeitsaufgabentyp specialtask in Team Foundation Server importiert. Nachdem der Importvorgang abgeschlossen ist, wird folgende Meldung angezeigt:

    Work item type import complete.

11. Vergewissern Sie sich, dass das Feld Category von keinem Arbeitsaufgabentyp mehr verwendet wird, indem Sie an der Eingabeaufforderung den folgenden Befehl eingeben und anschließend die EINGABETASTE drücken.

    witfields view /s:"Team Foundation Server-Name" MyCompany.MyProcess.Category

    Im Tool witfields wird für Category nun "Nicht verwendet" angezeigt.

    Field: MyCompany.MyProcess.Category

    Name: Category

    Type: String

    Reportable As: dimension

    Use: Not In Use

12. Da das Feld Category nicht mehr von Arbeitsaufgabentypen verwendet wird, löschen Sie es unwiderruflich vom Team Foundation Server, indem Sie an der Eingabeaufforderung den folgenden Text eingeben und anschließend die EINGABETASTE drücken. Geben Sie an der Eingabeaufforderung zur Bestätigung y ein, um diesen Schritt abzuschließen.

    witfields delete /s:"Team Foundation Server-Name" MyCompany.MyProcess.Category

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Vornehmen von grundlegenden benutzerdefinierten Anpassungen für einen Arbeitsaufgabentyp

Exemplarische Vorgehensweise: Durchführen von erweiterten Anpassungen für einen Arbeitsaufgabentyp

Weitere Ressourcen

Anpassen von Arbeitsaufgabentypen