Přizpůsobení hostovaného procesu XML

Azure DevOps Services

Azure DevOps podporuje přidávání a aktualizaci procesů prostřednictvím prostředí pro správu, které je webovým procesem import. Když přidáte proces, můžete z něj vytvořit jeden nebo více projektů. Proces můžete kdykoli aktualizovat opětovným importem. Změny provedené v šabloně procesu se pak použijí u všech projektů, které tento proces používají.

Důležité

S modelem hostovaného procesu XML přizpůsobíte sledování práce aktualizací vybraných definičních souborů XML šablony procesu. Tato funkce je dostupná jenom v případě, že se data migrují do služby Azure DevOps Services pomocí nástroje pro migraci dat Azure DevOps. Pokud používáte model procesu dědičnosti, můžete přizpůsobit sledování práce prostřednictvím uživatelského rozhraní vytvořením procesu dědičnosti. Pokud používáte místní model procesu XML, můžete přizpůsobit šablonu procesu, viz nahrání nebo stažení šablony procesu a přizpůsobení šablony procesu.

Další informace o přizpůsobení a procesních modelech naleznete v tématu Přizpůsobení sledování práce.

Proces je soubor ZIP, který obsahuje sadu vzájemně závislých souborů. Tyto soubory definují stavební bloky systému sledování pracovních položek a dalších subsystémů v Azure DevOps. Některé stavební bloky aktualizují existující projekty, zatímco jiné platí jenom pro nové projekty. Úplný seznam stavebních bloků najdete v následující tabulce:

Používá se při importu nebo aktualizaci procesu.	Používá se při vytváření nového projektu.	Nahrazeno výchozími nastaveními systému	Ignorováno
Sledování pracovních položek	Oblasti a iterace	Sestavení	Mapování Microsoft Project
Typy pracovních položek (WIT)	Správa testů	Lab Management	Sestavy
Kategorie	Pracovní položky	Správa verzí	Portál (produkty SharePoint)
Konfigurace procesu	Dotazy na pracovní položky

Požadavky

Pokyny k přizpůsobení Azure Boards tak, aby odpovídaly vašim konkrétním obchodním požadavkům, najdete v tématu Konfigurování a přizpůsobení Azure Boards.

Kategorie	Požadavky
oprávnění	- Chcete-li vytvořit, odstranit nebo upravit proces: Musíte být členem skupiny správců kolekce projektů nebo mít specifická oprávnění na úrovni kolekce, jako je Vytvořit proces, Odstranit proces, Upravit proces, nebo Odstranit pole z organizace s nastavením na Povolit. Další informace naleznete v tématu Přizpůsobení zděděného procesu. – Pro aktualizaci panelů: buď správce týmu nebo člen skupiny Projektoví správci.
Přístup	- I když máte základní nebo nižší přístup, můžete proces změnit, pokud vám někdo udělí oprávnění. - Chcete-li aktualizovat a změnit typ stávajících pracovních položek: Člen projektu.
Model procesu projektu	– Mít model procesu dědičnosti pro projektovou kolekci obsahující projekt. – Pokud chcete migrovat data do služby Azure DevOps Services, použijte službu Team Foundation Server Database Import Service.
znalosti	- Znalost modelů přizpůsobení a procesů.

Přizpůsobení procesu

Přizpůsobení procesu je efektivnější, když začnete s dobře definovaným procesem, nikoli vytvořením úplně od začátku.

Pokud aktualizujete existující proces dříve používaný s Azure DevOps Server, ujistěte se, že dodržuje omezení požadovaná pro import šablony, aby se zabránilo chybám ověřování během procesu importu.

Export a import procesu

Při importu nebo exportu procesu proveďte následující kroky:

1. Přihlaste se ke své organizaci (https://dev.azure.com/{Your_Organization}).

2. Vyberte nastavení organizace.

   

3. Vyberte možnost Proces.

   

   Důležité

   Pokud proces nevidíte, pracujete ve starší verzi, kde není stránka Proces podporovaná. Použijte funkce podporované pro místní model procesu XML.

4. Výběrem tří teček (...) otevřete místní nabídku pro hostovaný proces XML, který chcete exportovat. Exportovat můžete pouze hostované procesy XML.

   

   Uložte soubor ZIP a extrahujte z něj všechny soubory.

5. Proces přejmenujte v souboru ProcessTemplate.xml umístěném v kořenovém adresáři.

   Proces pojmenujte, abyste ho odlišili od existujících.

   <name>MyCompany Agile Process </name>

   Změňte typ verze, hlavní a druhotná čísla. Zadejte jedinečný identifikátor GUID pro typ jako v tomto příkladu:

   <version type="F50EFC58-C2FC-4C66-9814-E395D90778A3" major="1" minor="1"/>

6. Použijte podporovaná přizpůsobení.

7. Vytvořte soubor ZIP všech souborů a složek v kořenovém adresáři.

8. Importujte soubor ZIP vlastního procesu.

Podporovaná přizpůsobení

Pro svůj proces můžete použít následující přizpůsobení:

• Přidání, odebrání nebo úprava WIT
• Přidání nebo úprava pole
• Přidejte až pět backlogů portfolia
• Úprava konfigurace procesu
• Přidání globálních seznamů

Rozdíly

Azure DevOps Služby a Azure DevOps Server používají různé modely pro související projekty a procesy:

• V Azure DevOps Server slouží šablony procesů jako výchozí body pro projekty a přizpůsobení se vztahuje na jednotlivé projekty.
• V Azure DevOps Services se procesy sdílejí napříč více projekty a definují prostor pro přizpůsobení.

Struktura a syntaxe pro definování šablon procesů jsou většinou konzistentní, pouze menší rozdíly mezi šablonami navrženými pro Azure DevOps Services a Azure DevOps Server.

Poznámka:

Migrace z hostovaného XML na zděděný model je podporována pouze ve službách Azure DevOps, nikoli v Azure DevOps Server.

Omezení

Do služby Azure DevOps Services můžete importovat až 32 procesů. Vaše vlastní procesy musí odpovídat všem následujícím souhrnným pravidlům. Jinak se při importu mohou objevit chybové zprávy ověření.

Nepodporovaná přizpůsobení a nespřažené soubory plug-in modulů

Jakýkoli odkaz na následující objekty v některém ze souborů definic XML způsobí chybu ověření při importu:

• Vlastní ovládací prvky ve formulářích pracovních položek
• Vlastní typy propojení
• Globální pracovní postup
• Podpora týmu
• Pravidla pro a ne
• Podpora pravidel shody

Následující moduly plug-in a jejich přidružené soubory se nepoužívají k definování procesu ani k aktualizaci existujících projektů: Při vytváření nového projektu se ale používají k vytváření objektů nebo artefaktů.

• Klasifikace
• Dotazy na pracovní položky definované pomocí syntaxe jazyka WIQL (Work Item Query Language)
• Správa testů
• Pracovní položky

Poznámka:

Délka WIQL nesmí překročit 32-K znaků. Systém neumožňuje vytvářet nebo spouštět dotazy, které tuto délku překračují.

Následující moduly plug-in a jejich přidružené soubory jsou nahrazeny systémovými výchozími hodnotami.

• Sestavení
• Skupiny a oprávnění
• Laboratoř
• Správa verzí

Následující moduly plug-in a jejich přidružené soubory jsou ignorovány:

• Mapování Microsoft Project
• Sestavy
• Windows SharePoint Services

Vlastní moduly plug-in nejsou podporované.

Limity objektů

Při přizpůsobení šablony procesu pro import omezte počet objektů, které definujete v omezeních objektů sledování práce.

Šablona procesu

Soubor ProcessTemplate.xml musí splňovat syntaxi a pravidla následující podmínky:

• Omezuje počet definovaných typů pracovních položek na 64.
• Obsahuje pouze jeden definiční soubor Categories.xml.
• Obsahuje pouze jeden definiční soubor ProcessConfiguration.xml.
• Používá jedinečné uživatelsky přívětivé názvy pro všechna pole a definice WIT.

Váš proces také musí projít následujícími ověřovacími kontrolami:

• Názvy procesů jsou jedinečné a obsahují maximálně 155 znaků Unicode.
  • Šablona se stejným názvem a identifikátorem GUID verze jako existující proces tento proces přepíše.
  • Šablona se stejným názvem, ale jiným identifikátorem GUID verze vygeneruje chybu.
  • Názvy procesů nemohou obsahovat následující speciální znaky: . , ; ' ` : / \ * | ? " & % $ ! + = ( ) [ ] { } < >.
    Další omezení najdete v tématu Omezení pojmenování .
• Složky procesů neobsahují žádné soubory .exe. I když můžete importovat proces, který obsahuje soubor .exe, vytvoření projektu se nezdaří.
• Celková velikost procesu je maximálně 2 GB. V opačném případě se vytvoření projektu nezdaří.

Konfigurace procesu

Definiční soubor ProcessConfiguration.xml musí odpovídat syntaxi a pravidlům popsaným v odkazu elementu XML ProcessConfiguration. Musí také splňovat následující podmínky:

• Určuje všechny TypeFields prvky.
• Je omezený na pět backlogů portfolia.
• Obsahuje pouze jeden neparentovaný backlog portfolia.
• Určuje pouze jeden nadřazený portfolio backlog pro každý podřízený portfolio backlog.
• Obsahuje požadovaná mapování stavu pracovního postupu na metastate a neodkazuje na nepodporované metastate.

Kategorie

Definiční soubor Categories.xml musí odpovídat syntaxi a pravidlům popsaným v odkazu na elementy Xml Categories. Musí také splňovat následující podmínky:

• Je omezena na 32 kategorií.
• Definuje všechny kategorie odkazované v definičním souboru ProcessConfiguration.xml.

Typy pracovních položek

Prvek WITD a jeho podřízené elementy musí odpovídat syntaxi a pravidlům popsaným v odkazu na element XML technologie WITD. Musí také splňovat následující podmínky:

• V rámci jednoho WIT je maximálně 1 024 polí a ve všech WITech je maximálně 1 024 polí.
• Popisný název a požadovaný atribut refname přiřazený k WIT jsou jedinečné v rámci sady definičních souborů WIT.
• Požadovaná refname hodnota atributu neobsahuje nepovolené znaky ani nevyužívá nepovolené prostory System.Name a Microsoft.Name názvů.
• Názvy odkazů obsahují alespoň jednu tečku (.) a všechny ostatní znaky jsou písmena bez mezer.
• Element WITD obsahuje FORM element, který definuje WebLayout element odpovídající syntaxi uvedené v elementech WebLayout a Control.

Pole pracovních položek

Prvek FIELDS a jeho podřízené prvky musí odpovídat syntaxi a pravidlům popsaným v odkazu na element FIELD XML. Musí také splňovat následující podmínky:

• Popisný název a požadovaný atribut refname přiřazený k WIT jsou jedinečné v rámci sady definičních souborů WIT.
• Požadovaná refname hodnota atributu neobsahuje nepovolené znaky ani nevyužívá nepovolené prostory System.Name a Microsoft.Name názvů.
• Názvy odkazů obsahují alespoň jednu tečku (.) a všechny ostatní znaky jsou písmena bez mezer.

Prvek FIELD a jeho podřízené prvky mohou obsahovat GLOBALLIST prvek.

Omezit restrikce

• Prvek FIELDS je omezen na 1 024 polí.
• Typ pracovní položky je omezen na 64 polí jmen osob. Pole jméno osoby je jedno s atributem a hodnotou syncnamechanges=true.
• Prvek ALLOWEDVALUES nebo SUGGESTEDVALUES je omezen na 512 prvků LISTITEM.
• Pole je omezeno na 1 024 pravidel.

Povinná pole

Kategorie	Pole, která se mají zadat
Backlog konfigurace procesu	Pole používaná pro atributy a hodnoty type=Team a type=Order
Pravidelné backlogy nebo backlog portfolia	Pole použité pro type=Effort
TaskBacklog	- Pole použité pro type=RemainingWork – Pole použité pro type=Activity - ALLOWEDVALUES pravidlo pro pole použité pro type=Activity

Omezení pravidel

Omezení	Podrobnosti
Prvky pravidla pole nemohou specifikovat atributy for a ne.	Tyto atributy nejsou povoleny v prvcích pravidel polí.
FIELD elementy nemohou obsahovat prvky pravidla pro podřízené objekty CANNOTLOSEVALUE, NOTSAMEAS, MATCH a PROHIBITEDVALUES.	Tyto prvky podřízeného pravidla nejsou v rámci FIELD prvků podporovány.
FIELD definice pro System.Name pole nemohou obsahovat pravidla polí s výjimkou konkrétních polí.	Konkrétní pravidla můžou obsahovat pouze určitá pole, jak je uvedeno v tomto článku.
System.Title	Může obsahovat pravidla REQUIRED a DEFAULT.
System.Description	Může obsahovat pravidla REQUIRED a DEFAULT.
System.AssignedTo	Může obsahovat pravidla REQUIRED, DEFAULT, ALLOWEXISTINGVALUEa VALIDUSER.
System.ChangedBy	Může obsahovat pravidla REQUIRED, DEFAULT, ALLOWEXISTINGVALUEa VALIDUSER.

Konzistentní názvy a atributy

V rámci procesu nebo kolekce projektů , name, typea další atributy, které FIELD element definuje, musí být stejné ve všech definicích WIT.

Pole identit

Pole identit odpovídají polím používaným k zahrnutí názvů účtů, uživatelů nebo skupin. Následující základní systémová pole jsou pevně zakódovaná jako pole identity:

Název pole	Název odkazu
Přiřazený pro	System.AssignedTo
Autorizovaný jako	System.AuthorizedAs
Změněno kým	System.ChangedBy
Vytvořil	System.CreatedBy
Aktivoval(a)	Microsoft.AzureDevOps.Common.ActivatedBy
Uzavřeno	Microsoft.AzureDevOps.Common.ClosedBy
Vyřešeno kým	Microsoft.AzureDevOps.Common.ResolvedBy

Přidání vlastního pole identity

Řetězcové pole se rozpozná jako pole identity při zadání atributu syncnamechanges jako True.

Omezení podle pravidel pro pole identity

Pro aktuální verzi importu procesů nezadávejte žádná z následujících pravidel v rámci FIELD definice.

• SUGGESTEDVALUES
• Pravidla obsahující neidentické hodnoty.

Správný příklad

Chcete-li omezit názvy účtů platné v poli identity, zadejte VALIDUSER prvek s atributem název skupiny.

    <FIELD name="Project Manager" refname="Fabrikam.ProgramManager" type="String" reportable="dimension" syncnamechanges="true">
        <ALLOWEXISTINGVALUE />
        <VALIDUSER group="[PROJECT]\Program Manager Group" />
        <HELPTEXT>The program manager responsible for signing off on the user story.</HELPTEXT>
    </FIELD>

Před importem procesu se ujistěte, že jste vytvořili skupinu v projektech, které proces aktualizuje.

Nesprávný příklad

Následující příklad není platný, protože určuje:

• Prvek ALLOWEDVALUES.
• Prvek DEFAULT, který určuje neidentický řetězec value="Not Assigned".

    <FIELD name="Project Manager" refname="Fabrikam.ProgramManager" type="String" reportable="dimension" syncnamechanges="true">
        <ALLOWEXISTINGVALUE />
        <ALLOWEDVALUES>
          <LISTITEM value="[PROJECT]\Program Manager Group" />
          <LISTITEM value="Not Assigned" />
        </ALLOWEDVALUES>
        <DEFAULT from="value" value="Not Assigned" />
        <VALIDUSER />
        <HELPTEXT>The program manager responsible for signing off on the user story.</HELPTEXT>
    </FIELD>

Workflow

Prvek WORKFLOW a jeho podřízené prvky musí odpovídat syntaxi a pravidlům popsaným v odkazu na element XML pracovního postupu. Musí také splňovat následující podmínky:

• Omezuje jednotlivé stavy pracovních postupů na 16 pracovních postupů.
• Definuje všechny stavy pracovního postupu mapované na metastate v definičním souboru ProcessConfiguration.xml.
• Definuje přechod mezi všemi stavy pracovního postupu namapovanými na kategorii navrhovaného stavu a stavy pracovního postupu namapované na kategorii stavu InProgress.
• Definuje přechod mezi všemi stavy pracovního postupu namapovanými na kategorii stavu InProgress a stavy pracovního postupu namapované na kategorii Dokončeno.

Popis kategorie stavu a mapování naleznete v části Stavy pracovního postupu a kategorie stavů.

Globální seznamy

Pro model hostovaného procesu XML se při importu globálního seznamu umístí následující omezení:

• K dispozici je maximálně 64 globálních seznamů.
• Na seznamu je maximálně 1 024 položek.
• Přibližně 10 000 položek lze celkově definovat mezi všemi globálními seznamy zadanými ve všech typech pracovních položek.

Rozložení formuláře

Prvek FORM a jeho podřízené prvky musí odpovídat syntaxi a pravidlům popsaným v odkazu elementu FORM XML.

Prvek Control nemůže zadat vlastní ovládací prvek. Vlastní ovládací prvky nejsou podporované.

Související obsah

• Import a export hostovaných procesů XML
• Vyhodnocení pravidel a jejich chování
• Změna projektů z hostovaného XML na zděděné procesy
• Klonování hostovaných procesů XML do zděděných procesů