Udostępnij za pośrednictwem


Importowanie i eksportowanie kategorii

Można importować i eksportować kategorie zdefiniowane dla projektu zespołowego, zgodnie z następującym witadmin polecenia:

  • exportcategories: Eksportuje definicji XML kategorie zdefiniowane na serwerze, na którym działa Team Foundation Server.

  • importcategories: Importuje plik definicji XML typu elementu roboczego do projektu zespołowego na serwerze, na którym działa Team Foundation Server.

    Jeśli kategoria o takiej nazwie już istnieje, to polecenie spowoduje zastąpienie istniejącą definicję.Jeśli typu elementu roboczego jeszcze nie istnieje, to polecenie tworzy nową kategorię.

Aby dowiedzieć się więcej o domyślnych kategorii i sposób ich użycia, przejdź tutaj.

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

[!UWAGA]

Można tworzyć i modyfikować kategorie za pomocą edytora procesu, narzędzie power dla Visual Studio.Narzędzie power nie jest obsługiwane.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, dla którego zdefiniowano kategorie, musi mieć następujące uprawnienia ustawienia:

  • Aby wyeksportować kategorii typu elementu roboczego, musi mieć swoją wyświetlić informacje dotyczące projektu uprawnienie ustawione na Zezwalaj.

  • Do importowania kategorii typów elementów pracy, musi być członkiem Administratorzy projektu zabezpieczeń grupie lub mieć edytować informacje na poziomie projektu uprawnienie ustawione na Zezwalaj.

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

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

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

Nazwa projektu zespołowego z zostaną wyeksportowane kategorii lub są importowane kategorii.

/f:Nazwa pliku

Ścieżka i nazwa pliku definicji XML, który zawiera kategorie, które mają być wyeksportowane lub zaimportowane.Jeśli ten parametr jest pominięty, gdy użytkownik korzysta z exportcategories polecenia, polecenie kategorie są wyświetlane w oknie wiersza polecenia.

/e:Kodowania

Nazwa Program .NET Framework 2,0 format kodowania.Określony schemat kodowania będzie używany 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.

/? lub help

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

Uwagi

Importowanie pliku kategorie tworzy kategorie, jeśli jeszcze nie istnieje.Jeśli kategorii już istnieje, witadmin importcategories polecenie ostrzega bieżącej listy zostaną zastąpione.Można napisać program do aktualizacji istniejącego zestawu kategorii lub można zaktualizować kategorii samodzielnie nowych danych.

Ważna uwagaWażne

Zmiany wprowadzone do kategorii może mieć wpływ na proces konfiguracji.Zobacz Konfigurowanie i dostosowywanie narzędzi planowania Agile do projektu zespołowego.

Informacji o strukturze pliku XML kategorie, zobacz Odwołania do elementu XML kategorii.

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: myCategories.xml

  • Domyślnym kodowaniem: UTF-8

Lista kategorii

Następujące polecenie wyświetla listę zdefiniowanych dla projektu AdventureWorks kategorii typu elementu pracy.

witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks 

Dodaj kategorię do ukryte typy kategorii

Możesz dodać kategorię do kategorii ukryte typy do usunięcia pomocy technicznej dla użytkowników utworzyć typy elementów roboczych w tej kategorii.

  1. Eksportuj plik definicji dla kategorii dla swojego projektu zespołowego.

    witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml 
    
  2. Otwórz plik kategorie w edytorze tekstu preferowaną, a następnie zlokalizuj CATEGORY elementu dla "Hidden Types Category".

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
       <DEFAULTWORKITEMTYPE name="Code Review Request" />
       <WORKITEMTYPE name="Code Review Response" />
       <WORKITEMTYPE name="Feedback Request" />
       <WORKITEMTYPE name="Feedback Response" />
       <WORKITEMTYPE name="Shared Steps" />
    </CATEGORY>
    
  3. Dodaj WORKITEMTYPE element, który określa przyjazną nazwę typu elementu roboczego, które mają zostać dodane.

    Na przykład następującej składni dodaje typ elementu pracy niestandardowe "Tworzenie integracji" ukryte typy kategorii.

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
       <DEFAULTWORKITEMTYPE name="Code Review Request" />
       <WORKITEMTYPE name="Code Review Response" />
       <WORKITEMTYPE name="Feedback Request" />
       <WORKITEMTYPE name="Feedback Response" />
       <WORKITEMTYPE name="Shared Steps" />
       <WORKITEMTYPE name="Integration Build" />
    </CATEGORY>
    
  4. Importuj plik definicji dla kategorii do projektu zespołowego.

    witadmin importcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml 
    

Zobacz też

Koncepcje

Konfigurowanie i dostosowywanie narzędzi planowania Agile do projektu zespołowego

Inne zasoby

Używanie kategorii do grupowania typów elementów pracy