Přizpůsobení hostovaného procesu XML

Služby Azure DevOps

Služby Azure DevOps Services podporují přidávání a aktualizaci procesů prostřednictvím prostředí pro správu, které je webovým procesem importu. 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 Azure DevOps Services pomocí služby Import databáze Team Foundation Serveru.

Další informace o přizpůsobení a procesních modelech najdete 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 Services. 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

Ignorovaný

Sledování pracovních položek

Důvtip

Kategorie

Konfigurace procesu

Oblasti a iterace

Správa testů

Pracovní položky

Dotazy na pracovní položky

Sestavení

Správa testovacího prostředí

Správa verzí

Mapování aplikace Microsoft Project

Sestavy

Portál (SharePoint Products)

Mezi tím, co Azure DevOps Services podporuje, a tím, co místní Team Foundation Server podporuje, jsou rozdíly. Souhrn těchto rozdílů najdete v tématu Rozdíly přizpůsobení šablon procesů.

Přizpůsobení procesu

Když proces přizpůsobíte, začínáte dobře definovaným procesem, než když vytvoříte nový.

Pokud aktualizujete existující proces, který jste použili s místním Team Foundation Serverem, ujistěte se, že splňuje omezení umístěná v šablonách pro import.

Otevřít proces nastavení>

Vytváříte, spravujete a vytváříte vlastní nastavení procesů z procesu nastavení>organizace.

1. Zvolte logo Azure DevOps a otevřete projekty. Pak zvolte Nastavení organizace.

   

2. Pak zvolte Proces.

   

   Důležité

   Pokud proces nevidíte, pracujete v TFS-2018 nebo starší verzi. Stránka Proces není podporovaná. Musíte použít funkce podporované pro místní model procesu XML.

Export a import procesu

1. Na kartě Procesy vyberte tři tečky (...) a 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.

2. 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 a změňte hlavní a podverze. Zadejte jedinečný identifikátor GUID pro typ jako v tomto příkladu:

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

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

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

5. 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řidejte, odeberte nebo upravte wit.
• Přidejte nebo upravte pole.
• Přidejte až pět backlogů portfolia.
• Přidejte kategorie , které použijete v konfiguraci procesu.
• Upravte konfiguraci procesu.
• Přidejte globální seznamy.

Následující část uvádí omezení, která systém ukládá.

Omezení

Do 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 zobrazit chybové zprávy ověření.

• Přizpůsobení hostovaného procesu XML
  • Přizpůsobení procesu
    • Export a import procesu
  • Podporovaná přizpůsobení
  • Omezení
    • Šablona procesu
    • Konfigurace procesu
    • Kategorie
    • Typy pracovních položek
    • Pole pracovní položky
      • Omezení omezení
      • Povinná pole
      • Omezení pravidel
      • Konzistentní názvy a atributy
      • Pole identit
        • Přidání vlastního pole identity
        • Omezení pravidel pro pole identit
        • Správný příklad
        • Nesprávný příklad
    • Workflow (Pracovní postup)
    • Globální seznamy
    • Rozložení formuláře
  • Související články

Šablona procesu

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

• Omezuje počet definovaných pracovních míst na 64.
• Obsahuje pouze jeden definiční soubor Categories.xml.
• Obsahuje pouze jeden definiční soubor ProcessConfiguration.xml.
• Používá jedinečné popisné 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 prvky TypeFields .
• Je omezený na pět backlogů portfolia.
• Obsahuje pouze jeden neparentovaný backlog portfolia.
• Určuje pouze jeden nadřazený backlog portfolia pro každý podřízený backlog portfolia.
• 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 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 WITD XML. Musí také splňovat následující podmínky:

• Ve všech pracovních polích je maximálně 512 polí v rámci jedné wit a 512 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á hodnota atributu refname neobsahuje nepovolené znaky ani nepovolené obory názvů System.Název a Microsoft.Název.
• Názvy odkazů obsahují aspoň jedno tečky (.) a všechny ostatní znaky jsou písmena bez mezer.
• Prvek WITD obsahuje element FORM, který definuje element WebLayout odpovídající syntaxi zadané v elementech WebLayout a Control.

Pole pracovní položky

Element 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á hodnota atributu refname neobsahuje nepovolené znaky ani nepovolené obory názvů System.Název a Microsoft.Název.
• Názvy odkazů obsahují aspoň jedno tečky (.) a všechny ostatní znaky jsou písmena bez mezer.

Element FIELD a jeho podřízené prvky mohou obsahovat GLOBALLIST element.

Omezení omezení

• Prvek FIELDS je omezen na 512 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 elementů LISTITEM .
• Pole je omezeno na 1 024 pravidel.

Povinná pole

V souboru ProcessConfiguration.xml jsou zadána následující pole:

• U všech pracovních položek v kategorii, která definuje backlog konfigurace procesu, zadejte pole použitá pro atributy a hodnoty type=Team a type=Order.
• Pro všechny pracovní položky v kategorii, která definuje běžný backlog nebo backlog portfolia, zadejte pole použité pro type=Effort.
• Pro všechny pracovní položky v kategorii, které definují Element TaskBacklog , zadejte:
  • Pole použité pro type=RemainingWork.
  • Pole použité pro type=Activity.
  • Pravidlo ALLOWEDVALUES pro pole použité pro type=Activity.

Omezení pravidel

Kromě standardních omezení pravidel polí se vynucují následující omezení:

• Prvky pravidla pole nemůžou specifikovat vlastnosti for a nikoli atributy.
• Prvky POLE nemohou obsahovat prvky podřízeného pravidla CANNOTLOSEVALUE, NOTSAMEAS, POZVYHLEDAT a PROHIBITEDVALUES.
• S výjimkou následujících polí definice FIELD pro Systém.Pole názvů nemohou obsahovat pravidla polí.
  • 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, ALLOWEXISTINGVALUE a VALIDUSER.
  • System.ChangedBy může obsahovat pravidla REQUIRED, DEFAULT, ALLOWEXISTINGVALUE a VALIDUSER.

Konzistentní názvy a atributy

V rámci procesu nebo kolekce projektu, název, typ a další atributy, které prvek FIELD 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:

• Přiřazeno (System.AssignedTo)
• Autorizované jako (System.AuthorizedAs)
• Změněno uživatelem (System.ChangedBy)
• Vytvořil(System.CreatedBy)
• Aktivoval (Microsoft.VSTS.Common.ActivatedBy)
• Uzavřeno (Microsoft.VSTS.Common.ClosedBy)
• Vyřešeno uživatelem (Microsoft.VSTS.Common.ResolvedBy)

Přidání vlastního pole identity

Řetězcové pole se rozpozná jako pole identity, když zadáte atribut syncnamechanges jako True.

Omezení pravidel pro pole identit

Pro aktuální verzi importu procesu nezadávejte žádná z následujících pravidel v definici POLE .

• NAVRHOVANÉ HODNOTY
• Pravidla obsahující hodnoty nonidentity.

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 skupinu vytvořili 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 řetězec value="Not Assigned"nonidentity .

    <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

Element 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.
• 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í:

• Existuje maximálně 64 globálních seznamů.
• V seznamu je maximálně 1 024 položek.
• Přibližně 10 000 položek lze definovat celkem mezi všemi globálními seznamy zadanými ve všech pracovních místech.

Rozložení formuláře

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

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

Související články

• Import a export hostovaného procesu XML
• Pravidla a vyhodnocení pravidel
• Změna projektu z hostovaného XML na zděděný proces
• Klonování hostovaného procesu XML do procesu dědičnosti
• Podporované operace při přechodu z hostovaného procesu XML na zděděný proces