Ukázkové scénáře vlastních pravidel

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Tento článek obsahuje příklady definic vlastních pravidel. Všechna vlastní pravidla jsou definována pro typ pracovní položky. Příklady jsou k dispozici pro zděděné i místní modely procesů XML.

Před přidáním vlastních pravidel si přečtěte pravidla a vyhodnocení pravidel a přidejte pravidlo do typu pracovní položky (proces dědičnosti).

Definování závislého požadovaného pole

Můžete určit, že pole je povinné pouze v případě, že jiné pole obsahuje určitou hodnotu. Když zákazník v následujícím příkladu hlásí problém, je vlastní pole Hlášeno zákazníkem nastaveno na Hodnotu True a pole Závažnost se vyžaduje. Pokud zákazník problém neohlásil, není vyžadována hodnota pole Závažnost .

Proces dědičnosti

Místní proces XML

V části definice typu pracovní položky zadáte WHEN příkaz pravidla pro definici FIELDS pole.

XML

<FIELDS>
   ...
   <FIELD refname="MyCorp.Severity" name="Customer Severity" type="String">  
       <ALLOWEDVALUES>  
           <LISTITEM value="Blocking" />  
           <LISTITEM value="Major" />  
           <LISTITEM value="Minor" />  
       </ALLOWEDVALUES>  
       <WHEN field="MyCorp.CustomerReported" value="true">  
           <REQUIRED />  
       </WHEN>  
   </FIELD> 
   ...
</FIELDS>     

Vymazání hodnoty závislého pole

Následující příklad znázorňuje definování vlastního pravidla, které vymaže hodnotu bodů textu při změně počátečního data.

Proces dědičnosti

Místní proces XML

V části definice typu pracovní položky zadáte WHENCHANGED příkaz pravidla pro definici FIELDS pole.

XML

<FIELDS>
 ...
   <FIELD name="Story Points" refname="Microsoft.VSTS.Scheduling.StoryPoints" type="Double" reportable="measure" formula="sum">
       <HELPTEXT>The size of work estimated for implementing this user story</HELPTEXT>
       <WHENCHANGED field="Microsoft.VSTS.Scheduling.StartDate">  
           <EMPTY />  
       </WHENCHANGED>
   </FIELD>
   ...
</FIELDS>     

Nastavení hodnoty závislého pole

Následující příklady ukazují, jak mapovat hodnoty pole Velikost v závislosti na hodnotě vybrané pro vlastní pole Tee-Shirt Size pole.

Proces dědičnosti

Výběr velikosti trička Tee-Shirt Size se skládá ze čtyř hodnot Small, Medium, Large a X-Large. Čtyři vlastní pravidla jsou definována pro přiřazení pole Velikost při změně pole Velikost Tee-Shirt Size na konkrétní hodnotu. Pro zjednodušení použití je výchozí hodnota velikosti trička Tee-Shirt Small.

Dialogové okno Upravit pole pro Tee-Shirt Size (Velikost trička)

Vlastní pravidlo

Čtyři vlastní pravidla

Místní proces XML

Hodnotu pole Velikost zadáte v FIELDS části definice typu pracovní položky. K mapování použijete řadu WHEN příkazů pravidla a nastavíte hodnotu pole Velikost pomocí COPY value="value" pravidla.

XML

<FIELDS>
   ...
   <FIELD name="Tee-Shirt Size" refname="Fabrikam.TShirt.Size" type="String">
        <HELPTEXT>Estimate of overall size for work to be done; Small (2), Medium (6), Large (18), X-Large (30).</HELPTEXT>
        <ALLOWEDVALUES expanditems="true">
          <LISTITEM value="Large" />
          <LISTITEM value="Medium" />
          <LISTITEM value="Small" />
          <LISTITEM value="X-Large" />
        </ALLOWEDVALUES>
   </FIELD> 
   <FIELD name="Size" refname="Fabrikam.Size" type="Integer">
        <HELPTEXT>Integer estimate of overall size for work to be done; Automatically fill in based on Tee-Shirt Size. Allow any value.</HELPTEXT>
        <WHEN field="Fabrikam.TShirt.Size" value="Small">
          <COPY value="2" />
        </WHEN>
        <WHEN field="Fabrikam.TShirt.Size" value="Medium">
          <COPY value="6" />
        </WHEN>
        <WHEN field="Fabrikam.TShirt.Size" value="Large">
          <COPY value="18" />
        </WHEN>
        <WHEN field="Fabrikam.TShirt.Size" value="X-Large">
          <COPY value="30" />
        </WHEN>
   </FIELD>
   ...
 </FIELDS> 

Vyžadování hodnoty pole při změnách stavu

Následující příklad ukazuje, jak můžete vyžadovat specifikaci pole Zbývající práce, když se stav pracovního postupu úkolu změní na Aktivní.

Proces dědičnosti

Místní proces XML

Pokud je hodnota pole Stát pro pracovní položku nastavena na Hodnotu Aktivní a pracovní položka je uložena, hodnoty polí Aktivováno a Přiřazeno jsou automaticky nastaveny na název aktuálního uživatele. Tento uživatel musí být členem skupiny Valid Users pro Team Foundation Server. Hodnota pole Aktivované datum je také nastavena automaticky. Následující příklad ukazuje prvky, které vynucuje toto pravidlo:

XML

<WORKFLOW>
. . .  
    <STATE value="Active">
        <FIELDS>
            <FIELD refname="Microsoft.VSTS.Scheduling.RemainingWork">
              <REQUIRED />
            </FIELD>
        </FIELDS>
    </STATE>
. . .  
</WORKFLOW>

Vymažte hodnotu pole po uzavření státu.

Pokud chcete automatizovat vymazání pole Zbývající práce při zavření úkolu, definujte vlastní pravidlo, jak je uvedeno.

Proces dědičnosti

Místní proces XML

XML

<WORKFLOW>
. . .  
      <STATE value="Closed">
          <FIELDS>
            <FIELD refname="Microsoft.VSTS.Scheduling.RemainingWork">
              <EMPTY />
            </FIELD>
          </FIELDS>
      </STATE>
. . .  
</WORKFLOW>

Omezení vytváření pracovních položek podle skupiny

Vlastní pravidlo, které omezuje přechod na kategorii Navrhované stavy typu pracovní položky, účinně zakáže vytváření pracovních položek daného typu. Použitím pravidla u konkrétní skupiny účinně zakážete, aby tato skupina vytvářela pracovní položky daného typu.

Proces dědičnosti

Následující vlastní pravidlo omezuje, aby projektový tým vytvářel pracovní položky jako kategorie Navrhované stavy se mapuje na nový stav pracovního postupu.

Místní proces XML

Následující vlastní pravidlo omezuje Fabrikam Review Team (pro atribut) vytváření pracovních položek tím, že zakáže přechod na nový stav pracovního postupu.

XML

<WORKFLOW>
... 
<TRANSITION from=" " to="New"  
   for="[Project]\Developers" 
   not="[Project]\Fabrikam Review Team"  
   . . .  
</TRANSITION> 
...  
</WORKFLOW>

Omezení úprav pracovních položek podle skupiny

V případě procesu dědičnosti můžete uživatelům zabránit v úpravě pracovní položky nastavením oprávnění odepření skupiny v cestě k oblasti. U místního procesu XML můžete u každé skupiny umístit omezení pro jednotlivé stavy pracovního postupu, které jim brání v uložení pracovní položky v libovolném stavu.

Proces dědičnosti

Vlastní pravidlo, které omezuje úpravy pracovních položek určitého typu, není možné definovat. Omezení můžete zadat pouze podle stavu. Pokud uživatel nezmění stav, může změnit další pole, pokud nejsou všechna pole pro skupinu určená jen pro čtení.

Pokud chcete omezit skupinu uživatelů v úpravách vybraných pracovních položek libovolného typu, můžete tyto pracovní položky přiřadit k cestě oblasti. Definujte skupinu zabezpečení a nastavte omezení pro úpravy pracovních položek pro danou skupinu, jak je znázorněno na následujícím obrázku. Další informace najdete v tématu Nastavení oprávnění a přístupu pro sledování práce, vytvoření podřízených uzlů a úpravy pracovních položek v cestě k oblasti.

Místní proces XML

Následující vlastní pravidlo omezuje tým kontroly společnosti Fabrikam (pro atribut) úpravu uživatelských scénářů tím, že zakáže všechny stavy pracovního postupu definované pro typ pracovní položky scénáře uživatele. Vzhledem k tomu, že pro konkrétní tým není platný žádný stav pracovního postupu, členové tohoto týmu nebudou mít možnost uložit pracovní položku se změnami.

XML

<WORKFLOW>
... 
 <STATE value="New">  
   not="[Project]\Fabrikam Review Team"  
</STATE>  
<STATE value="Active">  
   not="[Project]\Fabrikam Review Team"  
</STATE>  
<STATE value="Resolved">  
   not="[Project]\Fabrikam Review Team"  
</STATE>  
<STATE value="Closed">  
   not="[Project]\Fabrikam Review Team"  
</STATE>  
...  
</WORKFLOW>

Omezení přechodů stavu

U zděděných procesů se přechody stavu any-to-any definují automaticky. To umožňuje uživatelům upřesnit stav pracovního postupu od nového po dokončení, ale také se v případě potřeby posunout zpět. Při definování vlastních pravidel pro omezení přechodu mějte na paměti, že pokud uživatel provede chybu při aktualizaci pracovního postupu, nemusí být schopen jej opravit. Mohou například aktualizovat stav přesunutím karty pracovní položky do pozdější fáze na panelu, ale ne přesunout zpět.

Tip

Zvažte omezení přechodu stavu pro některé, ale ne pro všechny uživatele. Pokud uživatel udělá chybu, může požádat jiného člena týmu, aby resetoval hodnotu státu tak, aby toto omezení vynechal.

Před definováním pravidel přechodu stavu zkontrolujte pravidla a vyhodnocení pravidel, automaticky generovaná pravidla a způsob použití stavů a kategorií pracovních postupů v backlogech a panelech.

Omezení úprav uzavřených pracovních položek

V závislosti na obchodních procesech můžete chtít uživatelům zabránit v pokračování v úpravách nebo aktualizaci pracovních položek, které byly zavřené nebo dokončené. Do typů pracovních položek můžete přidat pravidla, která uživatelům zabrání v opětovném otevření uzavřených pracovních položek.

Proces dědičnosti

Pro zděděný proces můžete přidat pravidlo, které omezuje přechod stavu. Například následující pravidlo omezuje přechod z uzavření na ostatní dva státy, Nové a Aktivní.

Poznámka

Podmínka A work item state moved from ... je dostupná pro Azure DevOps Server 2020 a novější verze.

Poznámka

V závislosti na zadané akci pravidla může být buď tlačítko Uložit ve formuláři pracovní položky zakázané, nebo se zobrazí chybová zpráva, když se uživatel s omezeným přístupem pokusí upravit pracovní položku.

Místní proces XML

U místních nasazení můžete do typu pracovní položky přidat pravidla, která zabrání opětovnému otevření po zavření pracovní položky. Například následující pravidla přechodu pracovního postupu umožňují testerům znovu otevřít pracovní položku, ale ne členy skupiny Vývojáři.

XML

<WORKFLOW>
. . .  
<TRANSITION from="Closed" to="New"  
   for="[Project]\Testers"  
   not="[Project]\Developers" 
   . . .  
</TRANSITION 
<TRANSITION from="Closed" to="Active"  
   for="[Project]\Testers"  
   not="[Project]\Developers" 
   . . .  
</TRANSITION 
. . .  
</WORKFLOW>

Skrytí nebo omezení úprav pole podle uživatele nebo skupiny

Když vyberete Current user is a member of group... pole nebo Current user is not a member of group..., můžete pole skrýt, nastavit pole jen pro čtení nebo ho nastavit jako povinné.

Například následující podmínka označuje, že pole Odůvodnění je skryté pro členy, kteří nepatří do skupiny Fabrikam Fiber\Voice.

Poznámka

Pracovní položky se na ně vztahují pravidla. Podmíněná pravidla založená na členství uživatele nebo skupiny se ukládají do mezipaměti pro webový prohlížeč. Pokud zjistíte, že jste omezili aktualizaci pracovní položky, možná jste narazili na jedno z těchto pravidel. Pokud se domníváte, že jste narazili na problém, který se na vás nevztahuje, přečtěte si téma Problémy s ukládáním do mezipaměti indexdb formuláře pracovní položky.

Omezení úprav vybraných polí podle uživatele nebo skupiny

Typy pracovních položek můžete přizpůsobit, abyste omezili, kdo může změnit konkrétní pole pro typ pracovní položky.

Proces dědičnosti

Pomocí jedné z následujících dvou podmínek můžete vybrat pole požadovaná pro uživatele skupiny zabezpečení nebo pro uživatele, kteří nejsou členem skupiny zabezpečení.

• current user is a member of a group...
• current user is not a member of a group...

Tip

Pokud se chcete vyhnout problémům s vyhodnocením pravidel, které mohou nastat, zadejte skupiny zabezpečení Azure DevOps, a ne skupiny zabezpečení Microsoft Entra NEBO Active Directory. Další informace najdete v tématu Výchozí pravidla a modul pravidel.

Můžete například nastavit pole Název nebo Stát jen pro čtení pro vybrané uživatele nebo skupiny.

Například pole Priorita pro typ pracovní položky uživatelského scénáře se stane jen pro členy skupiny Fabrikam Fiber\Voice. Když uživatel této skupiny otevře uživatelský scénář, nemůže změnit hodnotu v poli Priorita.

Místní proces XML

U místního modelu procesu XML můžete přizpůsobit typy pracovních položek tak, aby podporovaly tyto požadavky na omezení:

• Omezení, kdo může vytvořit nebo upravit pracovní položku
• Omezení, kdo může vytvářet konkrétní typy pracovních položek, jako jsou náměty nebo funkce

Úpravu pracovních položek můžete například omezit přidáním pravidla do typu pracovní položky, obvykle v části PRACOVNÍ POSTUP .

Přístup k objektům sledování práce omezíte jedním ze dvou způsobů:

• Nastavte pravidlo pole podmínky, pravidlo pole založené na podmínce nebo kombinaci těchto dvou pravidel, které platí pro skupinu. Změny v poli můžete omezit zadáním opravňujícího pravidla a jeho použitím pro konkrétní skupinu. Podmíněná pravidla mohou zahrnovat elementy CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY a REQUIRED .
• Přidáním pracovních položek do skupiny Skryté kategorie můžete většině přispěvatelů projektů zabránit v jejich vytváření. Můžete vytvořit hypertextový odkaz na šablonu , která otevře formulář pracovní položky a nasdílí tento odkaz členům týmu, kteří je chtějí vytvořit.

Související články

• Použití pravidel na stavy pracovního postupu (proces dědičnosti)
• Pravidla a vyhodnocení pravidel