Přizpůsobení hostovaného procesu XML

  • Článek

Azure DevOps Services

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 procesů hostovaného XML můžete přizpůsobit sledování práce aktualizací definičních souborů XML vybrané šablony procesu. Tato funkce je dostupná pouze v případě, že se data migrují do Azure DevOps Services pomocí služby importu databáze Team Foundation Serveru.

Další informace o modelech přizpůsobení a zpracování 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

Ignorováno

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í Microsoft Projectu

Sestavy

Portál (SharePoint Products)

Podporované moduly plug-in a objekty procesu pro import procesů

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

Přizpůsobení procesu

Když si přizpůsobíte proces, je zahájení s dobře definovaným procesem jednodušší než vytvoření nového procesu.

Pokud aktualizujete existující proces, který jste použili s místním Team Foundation Serverem, ujistěte se, že splňuje omezení nastavená na šablony pro import.

Otevřít proces nastavení>

Procesy můžete vytvářet, spravovat a provádět jejich přizpůsobení z nastavení>organizace Proces.

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

    Otevřít nastavení organizace

  2. Pak zvolte Zpracovat.

    Nastavení organizace, stránka Procesu

    Důležité

    Pokud možnost Proces nevidíte, pracujete z TFS-2018 nebo starší verze. Stránka Proces není podporovaná. Musíte použít funkce podporované pro místní model procesů 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. Můžete exportovat pouze hostované procesy XML.

    Možnost nabídky Export hostovaného procesu XML na stránce > procesu

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

  2. Přejmenujte proces v souboru ProcessTemplate.xml umístěném v kořenovém adresáři.

    Pojmenujte proces, abyste ho odlišili od existujících.

    <name>MyCompany Agile Process </name>

    Změňte typ verze a změňte hlavní číslo a číslo 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 se všemi soubory a složkami v kořenovém adresáři.

  5. Importujte soubor zip vlastního procesu.

Podporované kustomizace

Ve svém procesu můžete použít následující vlastní nastavení:

V následující části jsou uvedena 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í.

Šablona procesu

Soubor ProcessTemplate.xml musí odpovídat syntaxi a pravidlům popsaným v tématu Referenční informace k elementu XML ProcessTemplate. Musí také splňovat následující podmínky:

  • Omezí počet definovaných wit 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 ve všech polích a definicích 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ů nesmí 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 tématu Referenční informace o 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 metastavy a neodkazuje na nepodporované metastavy.

Kategorie

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

  • Je omezený na 32 kategorií.
  • Definuje všechny kategorie, na které odkazuje soubor 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 elementy XML witd. Musí také splňovat následující podmínky:

  • V rámci jedné witové položky je maximálně 512 polí a ve všech witech 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 nepoužívá nepovolené obory názvů System. Název a Microsoft. Název.
  • Názvy odkazů obsahují alespoň jednu tečku (.) a všechny ostatní znaky jsou písmena bez mezer.
  • WiTD element obsahuje FORM element, který definuje WebLayout element odpovídající syntaxi zadané v WebLayout a Control elementy.

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 nepoužívá nepovolené obory názvů System. Název a Microsoft. Název.
  • Názvy odkazů obsahují alespoň jednu tečku (.) a všechny ostatní znaky jsou písmena bez mezer.

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

Omezení omezení

  • Prvek FIELDS je omezen na 512 polí.
  • Typ pracovní položky je omezen na 64 polí se jménem osoby. Pole s názvem osoby je pole s atributem a hodnotou syncnamechanges=true.
  • Element ALLOWEDVALUES nebo SUGGESTEDVALUES je omezen na elementy 512 LISTITEM .
  • Pole je omezeno na 1 024 pravidel.

Povinná pole

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

  • Pro všechny WIT v kategorii, která definuje backlog konfigurace procesu, zadejte pole použitá pro atributy a hodnoty type=Team a type=Order.
  • Pro všechny wity v kategorii, která definuje běžný backlog nebo portfoliový backlog, zadejte pole použité pro type=Effort.
  • Pro všechny WIT v kategorii, která definuje 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 pole se vynucují následující omezení:

  • Elementy pravidel pole nemůžou určit atributy for a ne .
  • Elementy FIELD nemohou obsahovat prvky podřízeného pravidla CANNOTLOSEVALUE, NOTSAMEAS, POZVYHLEDAT a ZAKÁZANÉ HODNOTY.
  • Kromě následujících polí jsou definice POLÍ 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 projektů musí být název, typ a další atributy, které element FIELD definuje, stejné ve všech definicích WIT.

Pole identity

Pole identit odpovídají polím používaným k tomu, aby obsahovala názvy úč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)
  • Authorized As (System.AuthorizedAs)
  • Změněno uživatelem (System.ChangedBy)
  • Vytvořil (System.CreatedBy)
  • Aktivoval (Microsoft.VSTS.Common.ActivatedBy)
  • Uzavřeno uživatelem (Microsoft.VSTS.Common.ClosedBy)
  • Resolved By (Microsoft.VSTS.Common.ResolvedBy)
Přidání pole vlastní identity

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

Omezení pravidel pro pole identit

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

  • SUGGESTEDVALUES
  • Pravidla, která obsahují hodnoty neidentity.
Správný příklad

Chcete-li omezit názvy účtů, které jsou platné v poli identity, zadejte VALIDUSER prvek s atributem názvu 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 řetězec value="Not Assigned"neidentity .
    <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>

Pracovní postup

Element WORKFLOW a jeho podřízené prvky musí odpovídat syntaxi a pravidlům popsaným v odkazu na elementy XML PRACOVNÍHO POSTUPU. Musí také splňovat následující podmínky:

  • Omezuje každou wit na 16 stavů pracovního postupu.
  • Definuje všechny stavy pracovního postupu, které jsou mapovány na metastavy v definičním souboru ProcessConfiguration.
  • Definuje přechod mezi všemi stavy pracovního postupu namapovanými na kategorii stavu Navrhované 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 mapované na kategorii stavu Dokončeno.

Popis kategorií stavu a mapování najdete v tématu Stavy pracovního postupu a kategorie stavů.

Globální seznamy

Pro model hostovaného procesu XML jsou při importu globálního seznamu uložena následující omezení:

  • Existuje maximálně 64 globálních seznamů.
  • Seznam obsahuje maximálně 512 položek.
  • Celkem lze definovat přibližně 10 000 položek ze všech globálních seznamů, které jsou zadány ve všech wit.

Rozložení formuláře

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

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