Import and export process configuration [witadmin]

Přizpůsobení procesu konfigurace k úpravě zobrazení agilní plánování stránky nástroje, které můžete zobrazit prostřednictvím portálu webového serveru Team Foundation Server (TFS). Několik dalších nástroje vyžadují mapování stavy pracovního postupu na metastate mapování.

Přehled přizpůsobení agilní plánování stránky nástroje naleznete v tématu Configure and customize Agile planning tools for a team project.

Poznámka

Pokud se zobrazí chybová zpráva TF400917, neplatná konfigurace došlo k chybě.Znovu importovat konfiguračního souboru procesu pomocí týmový projekt witadmin importprocessconfig.Získáte zprávy, že které potřebujete k vyřešení chyby.

Chcete-li spravovat konfiguraci procesu pro týmový projekt, použijte witadmin nástroj příkazového řádku pro export a import souboru XML definice procesu konfigurace. Další informace o procesu konfigurace naleznete v tématu Referenční dokumentace elementu XML konfigurace procesu.

• exportprocessconfig: Exportuje definici procesu konfigurace do souboru XML nebo okno příkazového řádku.

• importprocessconfig: Importuje soubor XML definice procesu konfigurace.

witadmin Nástroj příkazového řádku lze použít pouze při spuštění proti TFS místně. Chcete-li spustit nástroj, otevřete okno příkazového řádku kde buď Visual Studio nebo Průzkumník týmových projektů je nainstalován a zadejte:

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

Na 32bitovou verzi systému Windows, nahradit %programfiles(x86)% s %programfiles%.

Požadavky

• Pokud chcete exportovat definice procesu konfigurace, musí být platným uživatelem týmového projektu nebo kolekce.

• Abyste mohli importovat definice procesu konfigurace, musíte být členem následujících skupin zabezpečení: Správci serveru Team Foundation nebo Správci projektů.

Další informace naleznete v tématu Oprávnění v prostředí Team Foundation Server.

witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName [/f:FileName] [/e:encoding] 

witadmin importprocessconfig /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:encoding] [/v]

Parametry

Parametr	Popis
/collection:CollectionURLx	Požadováno. Určuje adresu URL kolekce. Identifikátor URI je třeba zadat v následujícím formátu: http://název_serveru: port/název_virtuálního_adresáře/CollectionName Pokud nezadáte virtuální adresář, je nutné zadat identifikátor URI v následujícím formátu: http://Název_serveru: port / CollectionName.
/p:ProjectName	Požadováno. Určuje týmového projektu, pro kterou chcete exportovat nebo importovat konfigurace procesu. Tento týmový projekt musí být definovány v kolekci, která jste zadali pomocí parametru/Collection. Není nutné zadat týmového projektu, v případě, že určíte /v Přepnout.
/f:FileName	Cesta a název souboru XML definice pro konfiguraci procesu pro export a import. Poznámka Pokud je spuštěna v klientském počítači Windows Vista, nemáte oprávnění k určitým složkám.Pokud se pokusíte globální seznam exportovat do umístění, kde nemáte oprávnění, virtualizačních technologiích registru automaticky přesměruje exportovaný soubor a uloží jej do virtuálního úložiště.Další informace naleznete na následujících stránkách na webu společnosti Microsoft: Virtualizace registru a běžné problémy s virtualizací souborů a registru v systému Windows Vista.Chcete-li předejít toto přesměrování, můžete exportovat soubor do umístění, ve které máte oprávnění.
/e:Encoding	Volitelné. Název .NET Framework 2.0 Formát kódování. Uvedené kódování se použije k exportu nebo importu dat XML. Můžete například /e utf-7 Určuje kódování Unicode (UTF-7). Je-li tento parametr vynecháte witadmin se pokusí zjistit, kódování a používá UTF-8, pokud se nezdaří detekce.
/v	Volitelné. Ověří kód XML, který definuje konfiguraci procesu však neproběhne import souboru definice.
/? nebo help	Zobrazí nápovědu o příkaz v okně příkazového řádku.

Poznámky

Po instalaci nejnovější verze sady TFS upgradován stávající týmové projekty. Při aktualizaci upgradovanou týmového projektu, naleznete v části Configure features after a TFS upgrade.

Pokud dojde k problémům s přístupem k existující testovacích plánů nebo testovací sady po provedení upgradu, naleznete v části Update a team project manually to support test management.

Příklady

V obou příkladech platí následující hodnoty:

• Adresa URL pro kolekci: http://AdventureWorksServer:8080, tfs/DefaultCollection

• Týmový projekt: Contoso

• Web server číslo portu: 8080

Chcete-li přidat na panel Rychlé přidat pole

Pole můžete přidat do libovolného panelu pro rychlé přidávání. Například v následujícím příkladu přidá obchodní hodnotu do panelu nevyřízených položek produktu.

Panel zobrazuje pouze pole, které jsou součástí FIELDS oddíl s inst definice pro ŽÁ vybrána. Například pokud vyberete chybu s inst, pak pouze zobrazuje název, jako obchodní hodnotu není definován pro chyby. Chcete-li přidat jiné ŽÁ do panelu, můžete ho přidat do kategorie požadavky jak je popsáno zde.

1. Pokud nemáte oprávnění správce pro váš týmový projekt je získat tak.

2. Otevřete okno příkazového řádku, kde je nainstalována buď aplikace Visual Studio, nebo Průzkumník týmových projektů, a zadejte:

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

   Na 32bitovou verzi systému Windows nahraďte % ProgramFiles % programfiles %. Je možné Stáhnout průzkumníka týmových projektů zdarma.

3. Exportujte soubor konfigurace procesu.

   witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
   

   Příklad CollectionURL je http://MyServer:8080, tfs/TeamProjectCollectionName.

4. Přidejte odkaz na název pole do AddPanel oddílu.

   Například následující syntaxe přidá Priority element do panelu.

   <AddPanel>
      <Fields>
         <Field refname="System.Title" />
         <Field refname="Microsoft.VSTS.Common.BusinessValue" />
      </Fields>
   </AddPanel>
   

   Tips:

   • Můžete vyhledat název odkazu pro pole, které používá to index.

   • Přidáte všechna povinná pole pro pracovní položky typy definované pro požadavky na kategorii. Tímto způsobem můžete předejít otevřete formulář pracovní položky k vyplnění při přidání nevyřízených položek prostřednictvím panelu.

5. Importujte soubor konfigurace procesu.

   witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
   

6. Aktualizujte stránku nevyřízených položek a zobrazit aktualizované panelu.

Aktualizovat metastate mapování pro podporu Test Manager

Pokud upravíte WORKFLOW části testovacího plánu nebo testovací sady, musí být namapován stavy metastates.

V následujícím příkladu pracovní postup testovacího plánu byl aktualizován, aby použít návrh, testování a podepsán vypnout samostatně. Pro podporu zpětné kompatibility TestPlanWorkItems bude přidán do ProjectProcessConfiguration oddílu konfigurace definice procesu.

PRACOVNÍ POSTUP

Metastate mapování

<WORKFLOW>       <STATES>         <STATE value="Design" />         <STATE value="Testing" />         <STATE value="Signed Off" />       </STATES>       <TRANSITIONS>         <TRANSITION from="" to="Design">           <REASONS>             <DEFAULTREASON value="New test plan" />           </REASONS>         </TRANSITION>      <TRANSITION from="Design" to="Testing">           <REASONS>             <DEFAULTREASON value="Authoring complete" />           </REASONS>         </TRANSITION>             <TRANSITION from="Testing" to="Signed Off">           <REASONS>             <DEFAULTREASON value="Signed Off testing" />           </REASONS>         </TRANSITION>         <TRANSITION from="Signed Off" to="Design">           <REASONS>             <DEFAULTREASON value="Reactivating to authoring phase" />           </REASONS>         </TRANSITION>         <TRANSITION from="Signed Off" to="Testing">           <REASONS>             <DEFAULTREASON value="Reactivating to run tests" />           </REASONS>         </TRANSITION>         <TRANSITION from="Testing" to="Design">           <REASONS>             <DEFAULTREASON value="Back to authoring" />           </REASONS>         </TRANSITION>       </TRANSITIONS>     </WORKFLOW>

<TestPlanWorkItems category="Microsoft.TestPlanCategory" pluralName="Test Plans" singularName="Test Plan">     <States>       <State type="InProgress" value="Design" />       <State type="InProgress" value="Testing" />       <State type="Complete" value="Signed Off" />     </States>   </TestPlanWorkItems> <TestSuiteWorkItems category="Microsoft.TestSuiteCategory" pluralName="Test Suites" singularName="Test Suite">     <States>       <State type="Proposed" value="In Planning" />       <State type="InProgress" value="In Progress" />       <State type="Complete" value="Completed" />     </States>   </TestSuiteWorkItems>

Pokud změníte pracovní postup testovacího sady, je třeba vytvořit podobné aktualizace, pokud chcete namapovat nové stavy. Bude nutné jej v rámci přidat TestSuiteWorkItems oddílu. Podívejte se na téma Referenční dokumentace elementu XML konfigurace procesu.

Dotazy a odpovědi

D: jaké úpravy lze provádět a nadále používat funkce Průvodce konfigurací aktualizace svůj týmový projekt po upgradu sady TFS?

O: panel Rychlé přidat lze přizpůsobit. Průvodce konfigurací funkce aktualizujeme týmové projekty a získáte přístup k nejnovější funkce.

Ostatní změny může být nutné provést některé ručně prováděné operace při aktualizaci vašeho týmového projektu. Chcete-li zjistit, o které úpravy bezpečně můžete provést, a který neměli byste, naleznete v části Přizpůsobit pracovní Sledování zkušeností: dříve, než můžete přizpůsobit, pochopit, údržbu a upgrade důsledky.

D: Pokud je nutné namapovat stavy pracovního postupu k metastates?

O: -li přidat nebo odebrat stavy pracovního postupu pro následující WITs, měli byste zvážit aktualizace konfigurace procesu můžete přidat nebo odebrat odpovídající metastate mapování.

• WITs, které náleží do kategorie požadavku nebo kategorie úlohy: Metastate mapování podporují zobrazení agilní nástroje pro plánování.

• WITs, které patří do kategorie chyb: Metastate mapování pro podporu Moje práce nástroj (agilní a na základě CMMI týmové projekty).

• Testovací plán a testovací sady: aktualizace do pracovního postupu z těchto WITs musí být namapována pouze v případě, že podporují připojování k TFS z verze správce Test, který je založen na Visual Studio 2013.2 nebo dřívější verze členy týmu.

  Aktualizovat metastate mapování, pokud obdržíte aplikace zjistila neočekávané chyby Chyba při připojení k týmovému projektu.

  

Jak lze vyřešit chyby konfigurace procesu?

O: Pokud provedete jedním z těchto změn do týmového projektu, bude nutné aktualizovat definice pro ŽÁ, kategorie nebo konfigurace procesu. Aby nedocházelo k chybám, vždy proveďte požadované změny v tomto pořadí: WITs (1), (2) kategorie a konfigurace procesu (3)...

Vlastní nastavení	Aktualizovat nebo ověřit definici ŽÁ	Aktualizovat nebo ověřit definici konfigurace procesu
Přidat do kategorie požadavky kon (Kon mohou patřit do kategorií požadavky nebo kategorii úkolu, nikoli však obojí.)	Chcete-li zahrnout následující pole: Nevyřízené položky Priority (Scrum) nebo skládání pořadí (agilní nebo CMMI) (musí odpovídat pole Hodnota přiřazená k type=Order v konfiguračním souboru procesu) Práce (Scrum), body příběhů (agilní), nebo velikost (CMMI) (musí odpovídat pole Hodnota přiřazená k type=Effort v konfiguračním souboru procesu) Cesta k oblasti nebo pole Hodnota přiřazená k type=Team v konfiguračním souboru procesu Všechna pole, které jsou součástí AddPanel oddílu konfiguračního souboru procesu (pole musí být definován v rámci FIELDS oddílu, ale nemusí být zahrnuty v rámci FORM oddílu.	Tak, aby obsahovala nezbytné metastate mapování: Začátek každý stav pracovního postupu pro mapování type="Proposed" Každý stav mezilehlá pracovního postupu, který chcete mít zobrazit na kanbanové tabuli k mapování type="InProgress" Mapování na konec každého stav pracovního postupu, který má type="Complete" Může mít pouze jednoho stavu namapována na type="Complete" Obsahuje položku definovat barevné kódy přidružený ŽÁ. Příklad: <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" />
Změnit pracovní postup s inst v kategorii požadavky	N/A	Tak, aby obsahovala nezbytné metastate mapování, jak je popsáno výše pro přidání kon kategorie požadavky.
Přidat kon kategorie úlohy	Chcete-li zahrnout následující pole: Nevyřízené položky Priority (Scrum) nebo skládání pořadí (agilní nebo CMMI) Aktivita (Scrum nebo agilní) nebo oboru (CMMI) (musí odpovídat pole Hodnota přiřazená k type=Activity v konfiguračním souboru procesu) Zbývající práce (musí odpovídat pole Hodnota přiřazená k type=RemainingWork v konfiguračním souboru procesu) Cesta k oblasti nebo pole Hodnota přiřazená k type=Team v konfiguračním souboru procesu (Volitelné) Původní práce a dokončené práce (agilní a CMMI pouze)	Tak, aby obsahovala nezbytné metastate mapování: Začátek každý stav pracovního postupu pro mapování type="Proposed" Mapování každý stav mezilehlá pracovního postupu, který chcete mít zobrazit na panelu úkolů type="InProgress" Mapování na konec každého stav pracovního postupu, který má type="Complete" Může mít pouze jednoho stavu namapována na type="Complete" Obsahuje položku definovat barevné kódy přidružený ŽÁ. Příklad: <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />
Změnit pracovní postup s inst v kategorii úloh	N/A	Tak, aby obsahovala nezbytné metastate mapování, jak je popsáno výše pro přidání kon do kategorii úkolu.
Přidat kon kategorie chybu (agilní a CMMI pouze) Změnit pracovní postup s inst v kategorii chybu (agilní a CMMI pouze)	N/A	Tak, aby obsahovala nezbytné metastate mapování: Začátek každý stav pracovního postupu pro mapování type="Proposed" Mapování každý stav mezilehlá pracovního postupu, který chcete mít uveden pro mé práci type="InProgress" Mapa konec každý stav pracovního postupu type="Complete" Může mít pouze jednoho stavu namapována na type="Complete" Další informace naleznete v tématu Support bug update status using My Work.
Odebrat kon požadavky kategorie nebo kategorie úlohy	N/A	Chcete-li odebrat všechna metastate mapování, které jsou pouze přidružený k této ŽÁ
Odebrat kon z týmového projektu	Chcete-li odebrat kon ze souboru kategorií.	Chcete-li odebrat všechna metastate mapování, které jsou pouze přidružené k ŽÁ, který jste odstranili a WorkItemColor Odebrat element, který definuje barevné kódy pro kon.

D: Jak mohu přizpůsobit jiné funkce, které se zobrazují v nástrojích agilního plánování v TWA?

O: některé úpravy lze provést prostřednictvím uživatelského rozhraní. Jiná vyžadují úpravu konfigurace procesu nebo jiných objektů týmového projektu. Přehled naleznete v tématu Configure and customize Agile planning tools for a team project.

D: Chcete pracovat s nevyřízenými položkami dvou nebo více portfolií?

O: zkušenost výchozí podporuje jednu úroveň portfolia nevyřízených položek. Můžete přidat až pět úrovní, jak je popsáno v Add a backlog to Agile portfolio management.

D: Chcete přidat nebo změnit typy pracovních položek zobrazené na panelu úkolů nebo v nevyřízených položkách produktu?

O: Pokud jste přidali vlastní ŽÁ a chcete přidat, na tabuli buď nevyřízených položek nebo úlohu, můžete jej. Nemůžete ho zobrazit na obou místech. Zjistěte, jak načtením Přidávání typů pracovních položek do backlogů a na panely.