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

Artykuł
09/13/2015

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

witadmin Narzędzia wiersza polecenia działa tylko, jeśli zostanie uruchomione względem TFS lokalnie. Aby uruchomić narzędzie, Otwórz okno wiersza polecenia gdzie albo Visual Studio lub Team Explorer jest zainstalowany, a następnie wprowadź:

cd %programfiles(x86)%\Microsoft Visual Studio 14.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.

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: Projekt	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 .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. Zmiana koloru skojarzonego z istniejących ZEZWÓ lub dodać kolor do użycia dla nowych ZEZWÓ, Edycja konfiguracji procesu.

Color assignments to different work item types

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

ODP Jeśli masz ZEZWÓ, do wycofania, ale Obsługa elementów pracy, które zostały utworzone zależności od typu, możesz dodać regułę, która powoduje wyłączenie wszystkich użytkowników prawidłowe zapisywanie 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 ZEZWÓ do grupy kategorii ukryte aby uniemożliwić ich tworzenia większości współpracowników. Jeśli chcesz dostęp do grupy użytkowników, możesz można utworzyć hiperłącze w szablonie która otwiera formularza elementu pracy i wymieniać połączonych z tych członków zespołu, którzy chcą je utworzyć.
Dodaj pola regułę przepływu pracy dla pola System.CreatedBy do wydajne Tworzenie elementu roboczego określonego typu ograniczenia dostępu grupy użytkowników. Jak pokazano w poniższym przykładzie, użytkownika, który utworzył element pracy muszą należeć do Allowed Group w celu zapisania elementu pracy.
```
<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 zapobiec członków zespołu przy użyciu określonych ZEZWÓ można utworzyć elementu pracy, można usunąć go z projektu zespołowego. Przy użyciu witadmin destroywitd, trwałe usunięcie wszystkich elementów pracy, które zostały utworzone przy użyciu tego z, a także z, automatycznie. 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 Agile narzędzi planowania nie będą działały dopóki aktualizacji definicji kategorii.

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

Zobacz też

Udostępnij za pośrednictwem