Udostępnij za pośrednictwem

Importowanie i eksportowanie elementów pracy oraz zarządzanie nimi

  • Artykuł

Typy elementów roboczych dla projektów zespołowych można zarządzać za pomocą następujących witadmin polecenia:

  • destroywitd: Zniszczy typu elementu roboczego i zniszczy każdy element pracy tego typu trwale bez odzyskiwania.

  • exportwitd: Eksportuje definicji typu elementu roboczego do pliku XML lub do okna wiersza polecenia.

  • importwitd: Importowania elementów pracy typów z pliku XML definicji do projektu zespołowego na serwerze, na którym działa Team Foundation Server.Jeśli typu elementu roboczego o takiej nazwie już istnieje, nową definicję typu elementu roboczego zastępuje istniejący.Jeśli typu elementu roboczego jeszcze nie istnieje, to polecenie tworzy nowy typ elementu pracy.Aby sprawdzić plik XML, który definiuje typu elementu roboczego, ale nie importować plik, należy użyć /v opcji.

  • listwitd: Wyświetla nazwy elementów roboczych, jak określony projekt w oknie wiersza polecenia.

  • renamewitd: Zmienia nazwę wyświetlaną typu elementu roboczego w ciągu określonego projektu.Po wykonaniu tego polecenia z elementami roboczymi programu tego typu nową nazwę.

Aby uruchomić witadmin wiersza polecenia narzędzie, Otwórz okno poleceń gdzie albo Visual Studio lub Team Explorer jest zainstalowany, a następnie wprowadź:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

W przypadku 32-bitowej wersji systemu Windows, zastępuje %programfiles(x86)% z %programfiles%.

Aby uzyskać więcej informacji na temat typów elementów roboczych, zobacz Dodawanie definicji typu dla elementów roboczych do szablonu procesu.

[!UWAGA]

Można tworzyć i modyfikować typów elementów pracy za pomocą edytora procesu, narzędzie power dla Visual Studio.To narzędzie nie jest obsługiwany.Aby uzyskać więcej informacji, zobacz następujące strony w witrynie sieci Web firmy Microsoft: Team Foundation Server zaawansowanych narzędzi.

Wymagania

Dla projektu zespołowego, gdzie są zdefiniowane typy elementów roboczych, musi mieć następujące uprawnienia ustawienia:

  • Eksportowanie lub lista typów elementów pracy, musi być członkiem Administratorzy projektu grupie lub mieć swoją wyświetlić informacje dotyczące projektu uprawnienie ustawione na Zezwalaj.

  • Usunięcie, importowanie lub zmień nazwę typów elementów pracy, musi być członkiem Administratorzy programu Team Foundation grupy zabezpieczeń lub Administratorzy projektu grupy zabezpieczeń.

Aby uzyskać więcej informacji, zobacz Uprawnienia serwera programu Team Foundation Server i Domyślne grupy, uprawnienia i role serwera TFS [przekierowanie].

[!UWAGA]

Nawet wtedy, gdy użytkownik loguje się z uprawnieniami administracyjnymi, należy otworzyć okno wiersza polecenia z podniesionymi uprawnieniami do wykonania tej funkcji na serwerze, na którym działa Windows Server 2008.Aby otworzyć okno Wiersz polecenia z podwyższonym poziomem uprawnień, wybierz polecenie Start, otwórz menu skrótów wiersza polecenia, a następnie wybierz Uruchom jako Administrator.Aby uzyskać więcej informacji, zobacz witrynę sieci Web firmy Microsoft: kontroli dostępu użytkownika.

witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]

witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]

witadmin importwitd /collection:CollectionURL [/p:Project] /f:FileName [/e:Encoding] [/v]

witadmin listwitd /collection:CollectionURL /p:Project

witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]

Parametry

Parametr

Opis

/collection:CollectionURL

Określa identyfikator URI kolekcji projektów zespołowych.Format identyfikatora URI jest następująca: http://nazwa_serwera: port/NazwaKataloguWirtualnego/CollectionName

Jeśli katalog wirtualny nie jest używany, format identyfikatora URI jest następująca:

http://Nazwa_serwera: port / CollectionName

/p:Project

Projektu zespołowego, dla którego mają być zarządzane typy elementów roboczych.Ten projekt zespołu muszą być zdefiniowane w kolekcji projektów, określony przez /collection parametru.

/p Parametr jest wymagany, o ile nie zostanie uruchomiony importwitd z /v opcji.

/n:TypeName

Nazwa typu elementu roboczego na usunięcie, eksportowanie, importowanie lub zmień nazwę.

/f:FileName

Ścieżka i nazwa pliku definicji XML, który zawiera typy elementów pracy, które mają być wyeksportowane lub zaimportowane.Jeśli ten parametr jest pominięty, gdy użytkownik korzysta z exportwitd polecenia XML pojawia się w oknie wiersza polecenia.

[!UWAGA]

Jeśli używasz Windows Vista może nie mieć uprawnień do niektórych folderów.Przy próbie eksportu typu elementu roboczego do lokalizacji, w którym nie masz uprawnień, technologii wirtualizacji rejestru automatycznie przekierowuje wyeksportowany plik i zapisuje go w magazynie wirtualnego.Aby uniknąć przekierowanie, można wyeksportować plik do lokalizacji, w której masz uprawnienia. Aby uzyskać więcej informacji na temat wirtualizacji rejestru, zobacz witrynę sieci Web firmy Microsoft: wirtualizacji rejestru i typowe problemy z wirtualizacją plików i rejestru w systemie Windows Vista.

/e:Kodowanie

Nazwa Program .NET Framework 2,0 format kodowania.Polecenie używa określony schemat kodowania do eksportowania i importowania danych XML.Na przykład /e:utf-7 Określa kodowanie Unicode (UTF-7).Jeśli ten parametr zostanie pominięty witadmin próbuje wykryć kodowania, i w przypadku niepowodzenia wykrywania witadmin używa UTF-8.

/exportgloballists

Eksportuje definicje globalne list odwołują się do typu elementu roboczego.Definicje służące do globalnej listy zostaną osadzone w definicji typu elementu roboczego XML.Jeśli nie zostanie określony, definicje wyświetla globalne są pomijane.

/v

Weryfikuje plik XML, który definiuje typu elementu roboczego, ale nie importuje plik XML definicji.

[!UWAGA]

Definicja typu mogą weryfikować bez określenia projektu zespołowego.Odwołania do zakresu projektu grup jest ignorowana.

/new:Nowa nazwa

Nowa nazwa typu elementu roboczego.

/noprompt

Wyłącza monit o potwierdzenie.

/? lub help

Wyświetla Pomoc dotyczącą polecenia w oknie wiersza polecenia.

Uwagi

Przy użyciu destroywitd polecenia, jego zniszczy wszystkie następujące obiekty:

  • Typ elementu pracy

  • Wszystkie elementy tego typu pracy

  • Odpowiednich wpisów w tabelach łącze, tabele zawierające długie teksty i tabele elementów pracy

  • Obiekty w pamięci podręcznej metadanych typu elementu roboczego

Przykłady

Jeśli nie podano inaczej, w każdym przykładzie są stosowane następujące wartości:

  • Identyfikator URI dla kolekcji projektów zespołowych: DefaultCollection-http://AdventureWorksServer:8080/tfs

  • Nazwa projektu: AdventureWorks

  • Danych wejściowych lub wyjściowych nazwa pliku: myworkitems.xml

  • Nazwa typu elementu roboczego: myworkitem

  • Domyślnym kodowaniem: UTF-8

Eksportowanie definicji ZEZWÓ

Następujące polecenie eksportuje definicję myworkitem w pliku myworkitems.xml.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem

Poniższy przykład eksportuje elementu pracy przy użyciu kodowania Unicode (UTF-7).

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

Eksportowanie definicji ZEZWÓ i jego wyświetla globalne występujących w odwołaniu

Poniższy przykład eksportuje typu elementu roboczego i jej do listy globalnej.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists

Lista definicji ZEZWÓ

Poniższy przykład przedstawia definicji typu elementu roboczego okna wiersza polecenia.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem

Importowanie definicji WITs

Poniższy przykład importuje definicji elementu pracy z pliku XML.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks

Sprawdzanie poprawności definicji XML ZEZWÓ

Poniższy przykład weryfikuje plik XML, który definiuje typu elementu roboczego, ale nie są importowane definicji.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

Pytania i odpowiedzi

Pyt jakie dostosowania I wybierz i nadal korzystać z Kreatora konfiguracji funkcji można zaktualizować mojego projektu zespołowego, po uaktualnieniu TFS?

Odp można dodać WITs niestandardowe i zmienić układ formularza.Kreatora konfiguracji funkcji zaktualizuje swoje projekty zespołowe i uzyskasz dostęp do najnowszych funkcji.

Zmiana roli użytkownika lub zmiana ZEZWÓ może wymagać można wykonać kilka operacji ręcznego podczas aktualizowania projektu zespołowego.Aby dowiedzieć się więcej o które dostosowania można bezpiecznie dokonać oraz należy unikać, zobacz dostosować pracy śledzenia doświadczenie: przed można dostosować zrozumieć skutki konserwacji i aktualizacji.

Pyt w jaki sposób zmienić kolor skojarzony z ZEZWÓ?

Odp w zespołu Web Access elementów roboczych są wyświetlane w wyników zapytania oraz na stronach zaległości i tablicy nowoczesnych narzędzi planowania.Aby zmienić kolor skojarzony z istniejącym WIT lub dodać kolor do używania z nowym WIT, edytuj konfigurację procesu.

Elementu roboczego przypisania kolorów do różnych typów

P: Jak dezaktywować lub wyłączyć WIT?Jak ograniczać użytkownikom tworzenie elementów roboczych określonego typu?

Odp.: Jeśli masz typ elementu roboczego, który ma zostać wycofany, ale utrzymujesz elementy robocze, które zostały utworzone na podstawie tego typu, można dodać regułę, która wyłącza wszystkim prawidłowym użytkownikom możliwość zapisywania typu elementu roboczego.

<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER not="[Team Project Name]Project Valid Users" />
     </FIELD>
   </FIELDS>
</TRANSITION>

Jeśli chcesz ograniczyć tworzenie szczególnych WIT do grupy użytkowników, istnieją dwa sposoby ograniczania dostępu:

  • Dodaj typ elementów roboczych do grupy kategorii ukrytych, aby uniemożliwić większości współautorów tworzenie ich.Jeśli chcesz zezwolić na dostęp grupie użytkowników, możesz utworzyć hiperłącze do szablonu, które otwiera formularz elementu roboczego i dzielić się tym łączem z członkami zespołu, którzy mają je tworzyć.

  • Dodaj reguły pola do przepływu pracy dla pola System.CreatedBy, aby w praktyce uniemożliwić grupie użytkowników tworzenie elementu roboczego określonego typu.Jak pokazano na poniższym przykładzie, użytkownik tworzący element roboczy musi należeć do Allowed Group, aby zapisać element roboczy.

    <TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER for="Allowed Group" not="Disallowed Group" />
     </FIELD>
   </FIELDS>
</TRANSITION>

P: Jak mam usunąć nowy WIT?

Odp.: Aby uniemożliwić członkom zespołu tworzenie elementu roboczego przy użyciu określonego WIT, można usunąć go z projektu zespołowego.Użycie witadmin destroywitd powoduje trwałe usunięcie wszystkich elementów roboczych, które zostały utworzone przy użyciu tego WIT, jak również samego WIT.Na przykład jeżeli zespół nie używa "Przeszkoda", można usunąć WIT z etykietą "Przeszkoda" z projektu witryny sieci Web firmy Fabrikam.

witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment"

Po usunięciu WIT, który należy do kategorii, musisz zaktualizować definicję kategorii dla projektu zespołowego, aby odzwierciedlały nową nazwę.W szczególności narzędzia planowania Agile nie będą działać, dopóki nie zaktualizujesz definicji kategorii.

Aby uzyskać więcej informacji, zobacz Importowanie i eksportowanie kategorii [witadmin].

Zobacz też

Zadania

Tworzenie typu elementu roboczego

Koncepcje

Dostosowywanie obiektów śledzenia elementów pracy, aby wspierać procesy zespołu

Inne zasoby

witAdmin: dostosowywanie obiektów i zarządzanie nimi w celu śledzenia elementów pracy