Dodawanie pola i zmienić układ istniejących typu elementu pracy

Artykuł
03/12/2013

Aby śledzić dodatkowe dane dla elementu pracy, można dodać pole do typu element prac go wyświetlić w formularzu pracy i sprawiają, że objętego obowiązkiem sprawozdawczym.Można również zmienić układ formularza elementu pracy, które najlepiej pasują do potrzeb drużyny.W tym temacie Julia i Peterowi, członkowie zespołu firmy Fabrikam Fiber dostosować dwa różne typy elementów roboczych do obsługi swoich celów śledzenia.

Aby śledzić, skąd pochodzą wnioski o nowe funkcje, Julia dodaje pola niestandardowego z menu rozwijanego opcji i zmienia układ formularza elementu pracy dla elementu listy zaległości produktu.Julia wykonuje pięć zadania, aby dodać niestandardowe pole z listy rozwijanej opcji i zmienić układ formularza elementu pracy dla elementu listy zaległości produktu.
Aby lepiej śledzenie pracy i poprawić jego i zespół zdolności do szacowania pracy, Peter dodaje pola do typ pozycji roboczej zadania.

Jak pokazano na poniższej ilustracji, Julia i Peterowi wykonywania ich zadań, niezależnie od siebie, ale w zalecanej sekwencji.

Zmienianie układu formularza elementu pracy

Sekwencję czynności, aby dodać pole do typu elementu pracy

Dodawanie pola do formularza elementu pracy

Dodawanie pola do typ pozycji roboczej

Aby przejrzeć pola elementu pracy i przypisane jako objętych obowiązkiem sprawozdawczym w domyślnych szablonów procesu dla pola Team Foundation Server, zobacz Odwołania pola elementu pracy dla Visual Studio ALM i Objętych obowiązkiem sprawozdawczym odniesienia pól dla programu Visual Studio Informatykami.

Wymagania

Aby wykonać tę procedurę, trzeba być członkiem Team Foundation Administratorzy grupę lub element członkowski Administratorzy projektu grupy dla projektu.Aby uzyskać więcej informacji, zobacz Team Foundation Uprawnienia serwera.

[!UWAGA]

W przypadku uruchamiania Windows Vista może nie mieć uprawnienia do niektórych folderów.Podczas próby eksportowania typ pozycji roboczej do lokalizacji, w którym nie masz uprawnienia ustawione, technologii wirtualizacji rejestru automatycznie przekierowuje eksportowanego pliku i zapisuje go do magazynu wirtualnego.Aby uniknąć tego przekierowania, można wyeksportować plik do lokalizacji, gdzie użytkownik ma uprawnienia ustawione.Aby uzyskać więcej informacji na temat wirtualizacji rejestru, zobacz następujące strony w witrynie firmy Microsoft: Wirtualizacji rejestru i typowych problemów ze wirtualizacji plików i rejestru w systemie Windows Vista.

1.Eksportowanie definicji typu elementu pracy

Podczas pobierania definicji typu z danego zespołu projektu, można zapewnić, że pracujesz z najnowszą wersją.

[!UWAGA]

Jeśli masz niewielkie zmiany i uważasz, że praca z formatu XML, można zmodyfikować pliki za pomocą Notatnika lub innego edytora tekstu.Ewentualnie można użyć edytora procesu, który jest narzędzie power tool, który jest instalowany jako dodatek do programu Visual Studio.Za pomocą tego narzędzia, nie trzeba importować lub eksportować definicje typów.Można je za pomocą edytora proces otwierać i modyfikować je za pośrednictwem interfejsu edytora.

Narzędzie power tool można pobrać z następującej strony w witrynie firmy Microsoft w sieci Web: Team Foundation Server narzędzia.

Aby uzyskać informacje dotyczące sposobu pobierania plików schematów dla szablonów procesów, zobacz Indeks do definicji elementu XML dla szablonu procesu Plug-ins.

Aby wyeksportować pliku definicji typu elementu pracy z istniejącym projektem zespołu

Aby uruchomić witadmin wiersza polecenia narzędzia, Otwórz okno wiersza polecenia gdzie albo Visual Studio lub Team Explorer jest zainstalowany i wprowadź:
```
cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
```
W 64-bitowych wersji systemu Windows, należy zastąpić %programfiles% z %programfiles(x86)%.
Wprowadź następujące polecenie, zastępując dane dotyczące argumentów, które są wyświetlane w tym miejscu, gdzie CollectionURL Określa adres URL Kolekcja projektów zespołu, NazwaProjektu Określa nazwę zespołu projektu, zdefiniowane w kolekcji, WorkItemTypeName Określa nazwę elementu pracy, aby wyeksportować, i Nazwa pliku Określa nazwę i lokalizację dla eksportowanego pliku eksportu.Następnie wybierz polecenie Enter klucz.
```
witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:WorkItemTypeName /f:FileName
```
Przykład: Eksportuj definicję dla pozycji listy zaległości produktu

Na przykład Julia używa następującego polecenia do eksportowania definicji typu dla jej FabrikamFiber zespołu projektu dla elementu listy zaległości produktu, FF_ProductBItem.xml.
```
witadmin exportwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /n:"Product Backlog Item" /f:FF_ProductBItem.xml
```
Przykład: Eksportuj definicję zadania

I Peterowi używa następującego polecenia Eksportuj definicję typu zadania, a następnie zapisz plik jako FF_Task.xml.
```
witadmin exportwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /n:Task /f:FF_Task.xml
```
Po pomyślnym zakończeniu pojawi się następujący komunikat:

Operacja została zakończona.

2.Dodawanie pola do definicji typu

Aby dodać pole do definicji typu, należy dodać FIELD elementu wewnątrz FIELDS sekcji i Control elementu wewnątrz FORM sekcji.Ponadto zaleca się, że zgodne z konwencjami nazewnictwa, ustalone dla pól.

Aby dodać pole do typ pozycji roboczej

Znajdź sekcję pliku XML, który definiuje pól dla typu i który zaczyna się od FIELDS.
Dodać FIELD element, który określa nazwę pola niestandardowego, aby dodać element.Należy określić następujące atrybuty wymagane: przyjazna name, refname (Nazwa referencyjna), i type.Aby uzyskać więcej informacji, zobacz Element pola (definicja).

[!UWAGA]

Nazwa odwołania lub refname, jest Nazwa programowa dla pola.Wszystkie inne zasady powinno odnosić się do tego refname.Aby uzyskać więcej informacji, zobacz Konwencje nazewnictwa dla elementu pracy śledzenia obiektów.

Przykład: Add wartość pola niestandardowego z Menu Lista

Na przykład Julia wprowadzi następujący tekst, aby dodać pole niestandardowe, żądającego, FabrikamFiber.MyTeam.Requestor, jeśli nazwa odwołanie do definicji typu dla pozycji listy zaległości produktu.Określa ona również listę dozwolonych wartości dla tego pola, jak również wartości domyślne klienta dla listy.
```
<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>
```
Aby uzyskać więcej informacji na temat list pobrania, zobacz Definiowanie list wyboru.

Przykład: Add wstępnie zdefiniowanego pola

Definicji typu dla zadania Peter doda pole wstępnie zdefiniowanych, pracę wykonaną z nazwą odwołania Microsoft.VSTS.Scheduling.CompletedWork.
```
<FIELD name="Completed Work" refname="Microsoft.VSTS.Scheduling.CompletedWork" type="Double" reportable="measure" formula="sum" />
```
Aby uzyskać listę wszystkich wstępnie zdefiniowanych pól, zobacz Odwołania pola elementu pracy dla Visual Studio ALM.

Dodać CONTROL elementu wewnątrz FORM sekcji tak, aby pole niestandardowe pojawia się w formularzu prac w ramach grupy elementów gdzie ma się pojawiać.Należy określić formant type atrybut.Aby uzyskać więcej informacji, zobacz Odwołanie Element XML kontroli.

Przykład: Dodać niestandardowe pole do formularza dla pozycji listy zaległości produktu

Przykład: Add kontrolkę pola.

Na przykład Julia dodaje Control element dla pola żądającego pojawi się poniżej pola przyczyny pracy w formularzu, jak pokazano w następującym przykładzie kodu.

<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>

Porada
Definicja schematu śledzenie elementów pracy definiuje wszystkie elementy podrzędne FORM element jako wielbłąda i wszelkimi innymi elementami jako wielkie.Jeśli występują błędy podczas sprawdzania poprawności plików definicji typu, należy sprawdzić sprawa struktury elementy.Ponadto sprawa struktura otwierającym i zamykającym znacznikiem musi być zgodna zgodnie z regułami dotyczącymi składni języka XML.

Definicja schematu śledzenie elementów pracy definiuje wszystkie elementy podrzędne FORM element jako wielbłąda i wszelkimi innymi elementami jako wielkie.Jeśli występują błędy podczas sprawdzania poprawności plików definicji typu, należy sprawdzić sprawa struktury elementy.Ponadto sprawa struktura otwierającym i zamykającym znacznikiem musi być zgodna zgodnie z regułami dotyczącymi składni języka XML.

Na poniższej ilustracji przedstawiono, że formularza elementu pracy dla elementu listy zaległości produktu zawiera teraz nowe pole.

Pole niestandardowe dodawane do definicji typu i formularza

Przykład: Add wstępnie zdefiniowanego pola do formularza dla zadania

Dla elementu pracy zadań dodaje Peter Control pole było wyświetlane powyżej pola Praca pozostała, jak pokazano w następującym przykładzie kodu:

<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>

Na poniższej ilustracji przedstawiono, że formularza elementu pracy dla zadania zawiera teraz pola zakończona praca.

Dodać pracę wykonaną do typu zadania i formularz

Zapisać zmiany w pliku XML.

Aby dowiedzieć się więcej na temat dodawania definicje typów pól elementu pracy

3.Zmienić układ formularza dla grup kartę z dwóch kolumn na pojedynczej kolumny

Julia chce zmienić układ formularza dla pozycji listy zaległości produktu, tak aby pola Opis obejmującej całą szerokość formularza.Jak pokazano na poniższej ilustracji, domyślnego układu są wyświetlane dwa zestawy grupowanie kart.Aby zmienić układ na jeden zbiór grup kart, Jill musi zmienić pierwszego elementu kolumny do szerokości 100 procent i usunąć obcych Column i TabGroup elementy z FORM sekcji.

Dwie kolumny kartę Układ grupy

Aby zmienić układ formularza z grup kartę z dwiema kolumnami na pojedynczej kolumny grup kart

Znajdź TabGroup sekcji pliku XML.Należy zauważyć, że istnieje Tab elementy dla elementów, takich jak Opis, zadania, Kryteria przyjęcia, i historii w której każdy Tab element zawiera Control element, który renderuje odpowiednich kontroli.

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

Konsolidacja wszystkich <Tab> . . . </Tab> elementy zgodnie z jednym TabGroup.Usuń Group, Column, obcych TabGroup elementy.Nowa struktura składni XML można znaleźć w poniższym przykładzie.
```
<Group>
   <Column PercentWidth="100">
      <TabGroup>
      . . .
      </TabGroup>
   </Column>
</Group>
```
[!UWAGA]

Aby uzyskać najlepsze wyniki każdy formant lub grupy powinien być wyświetlany w kolumnie nawet, jeżeli kolumna obejmuje całą szerokość formularza.Z kolei każda kolumna powinien być wyświetlany w grupie nawet, jeśli grupa nie ma widocznej etykiecie lub obwiedni.Aby uzyskać więcej informacji, zobacz Projektowanie i dostosowywanie formularza elementu pracy.

Na poniższej ilustracji przedstawiono grupowanie kart jedną kolumną.
Zapisz zmiany do pliku XML.

4.Importowanie definicji typu elementu pracy

Po dostosowaniu definicji typu, należy go zaimportować do swojego projektu zespołu, aby zweryfikować zmiany i udostępnić do użytku.Plik XML, który importujesz spowoduje zastąpienie zawartości z aktualną definicją typu.Proces importowania sprawdza poprawność uprzedniej składni XML do przekazania.

Aby zaimportować typ pozycji roboczej z istniejącym projektem zespołu

Z okna wiersza polecenia i katalogu określonego w kroku 1 1. Eksportowanie definicji typu elementu pracy , opisane wcześniej w tym temacie, wprowadź następujące polecenie, a następnie wybierz Enter klucz.
```
witadmin importwitd /collection:CollectionURL /p:ProjectName /n:WorkItemTypeName /f:FileName
```
Przykład: Importuj definicję dla pozycji listy zaległości produktu

Na przykład Jill użyto następującego polecenia do importowania definicji typu dla elementu listy zaległości produktu, który ona wywożonych do FF_ProductBItem.xml do FabrikamFiber zespołu projektu.
```
witadmin importwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /f:FF_ProductBItem.xml
```
Przykład: Importuj definicję zadania

I Peterowi użyto następującego polecenia do importowania definicji typu zadania, który był zapisany do FF_Task.xml.
```
witadmin importwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /f:FF_Task.xml
```
Po pomyślnym zakończeniu pojawi się następujący komunikat:

Importuj typu elementu pracy zakończył się.

5.Odśwież zespołu projektu i sprawdzić, zmiany wprowadzone do definicji typu

Po zaimportowaniu definicji typu, należy odświeżyć pamięć podręczną w Eksploratorze zespołu zmiany w celu udostępnienia.Należy odświeżyć pamięć podręczną tylko wtedy, gdy użytkownik miał Visual Studio otworzyć i podłączony do Team Foundation Server po zaimportowaniu definicji typu.

Odśwież Eksplorator zespołów i utworzyć element listy zaległości produktu

Odśwież zespołu projektu i zweryfikować zmiany

Aby odświeżyć pamięć podręczną

In Team Explorer, choose the Refresh button.

Najnowsze aktualizacje są pobierane z serwera, łącznie z modyfikacjami zaimportowany.

Odczekaj kilka sekund, dopiero po zakończeniu odświeżania.
Wybierz polecenie elementów pracy.
Wybierz polecenie Nowy element pracy, a następnie wybierz typ pozycji roboczej, który był modyfikowany, takich jak Pozycji listy zaległości produktu lub zadanie.
Zweryfikuj, że zmiany, dokonane są wyświetlane w pracach pozycja formularza.
Wybierz polecenie zamknąć przycisk, aby zamknąć nowego elementu pracy.Wybierz polecenie nr przycisk po wyświetleniu monitu o zapisanie elementu pracy.

Udostępnij za pośrednictwem