Exempel på scenarier med anpassade regler

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

Den här artikeln innehåller exempel på anpassade regeldefinitioner. Alla anpassade regler definieras för en typ av arbetsuppgift. Exempel tillhandahålls för både den ärvda och lokala XML-processmodellen.

Innan du lägger till anpassade regler läser du Regler och regelutvärdering och Lägg till en regel i en typ av arbetsobjekt (arvsprocess).

Definiera ett beroende obligatoriskt fält

Du kan ange att ett fält endast krävs när ett annat fält innehåller ett visst värde. I följande exempel, när en kund rapporterar ett problem, är det anpassade fältet Kundrapporterat inställt på Sant och fältet Allvarlighetsgrad krävs. Om problemet inte rapporteras av en kund krävs inget värde för fältet Allvarlighetsgrad .

Arvsprocess

Lokal XML-process

Du anger en WHEN regelsats för fältdefinitionen FIELDS i avsnittet i definitionen av arbetsobjekttyp.

<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>     

Rensa värdet för ett beroende fält

I följande exempel visas hur du definierar en anpassad regel för att rensa värdet för Story Points när en ändring görs i startdatumet.

Arvsprocess

Lokal XML-process

Du anger en WHENCHANGED regelsats för fältdefinitionen FIELDS i avsnittet i definitionen av arbetsobjekttyp.

<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>     

Ange ett beroende fältvärde

Följande exempel illustrerar hur du mappar värdena för fältet Storlek beroende på det värde som valts för det anpassade fältet, fältet Tee-Shirt Size(Storlek på t-shirt).

Arvsprocess

Listrutan Tee-Shirt Size består av fyra värden Small, Medium, Large och X-Large. Fyra anpassade regler definieras för att tilldela fältet Storlek när fältet Storlek på t-shirt ändras till ett specifikt värde. För att förenkla användningen är standardvärdet för tee-shirtstorlekenliten.

Dialogrutan Redigera fält för fältet Storlek på t-shirt

Anpassad regel

Fyra anpassade regler

Lokal XML-process

Du anger värdet för fältet Storlek i FIELDS avsnittet i definitionen av arbetsobjekttyp. Du använder en serie WHEN regelinstruktioner för att göra mappningen och anger värdet för fältet Storlek med hjälp av COPY value="value" regeln.

<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> 

Kräv ett fältvärde vid tillståndsändringar

I följande exempel visas hur du kan kräva specifikation av fältet Återstående arbete när uppgiftsarbetsflödets tillstånd ändras till Aktiv.

Arvsprocess

Lokal XML-process

När värdet för fältet Tillstånd för ett arbetsobjekt har angetts till Aktiv och arbetsobjektet sparas, anges värdena för fälten Aktiverad av och Tilldelad till automatiskt till namnet på den aktuella användaren. Användaren måste vara medlem i gruppen Giltiga användare för Team Foundation Server. Värdet för fältet Aktiverat datum anges också automatiskt. I följande exempel visas de element som tillämpar den här regeln:

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

Rensa värdet för ett fält vid stängningstillstånd

Om du vill automatisera rensningen av fältet Återstående arbete när du stänger en aktivitet definierar du en anpassad regel som anges.

Arvsprocess

Lokal XML-process

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

Begränsa skapandet av arbetsuppgifter efter grupp

En anpassad regel som begränsar övergången till kategorin Föreslaget tillstånd för en arbetsobjekttyp tillåter i praktiken inte att arbetsobjekt av den typen skapas. Genom att tillämpa regeln på en viss grupp tillåter du i praktiken inte den gruppen från att skapa arbetsobjekt av den typen.

Arvsprocess

Följande anpassade regel begränsar ett projektteam från att skapa arbetsobjekt när kategorin Föreslaget tillstånd mappas till tillståndet Nytt arbetsflöde.

Lokal XML-process

Följande anpassade regel begränsar Fabrikam-granskningsteamet (för attribut) från att skapa arbetsobjekt genom att inte tillåta övergången till tillståndet Nytt arbetsflöde.

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

Begränsa ändringar av arbetsuppgifter efter grupp

För en arvsprocess kan du förhindra att användare ändrar ett arbetsobjekt genom att ange neka-behörigheten för en grupp på en områdessökväg. För en lokal XML-process kan du begränsa varje arbetsflödestillstånd för en grupp som hindrar dem från att spara arbetsobjektet i alla tillstånd.

Arvsprocess

Det går inte att definiera en anpassad regel som begränsar ändringar av arbetsobjekt av en viss typ. Du kan bara ange begränsning efter tillstånd. Om användaren inte ändrar tillståndet kan de ändra andra fält, såvida inte alla fält görs skrivskyddade för gruppen.

Om du i stället vill begränsa en grupp användare från att ändra valda arbetsobjekt av någon typ kan du tilldela dessa arbetsobjekt till en områdessökväg. Definiera en säkerhetsgrupp och ange sedan begränsningar för redigering av arbetsobjekt för den områdessökvägen för gruppen enligt följande bild. Mer information finns i Ange behörigheter och åtkomst för arbetsspårning, Skapa underordnade noder och ändra arbetsobjekt under en områdessökväg

Lokal XML-process

Följande anpassade regel begränsar Fabrikam-granskningsteamet (för attribut) från att ändra användarberättelser genom att inte tillåta alla arbetsflödestillstånd som definierats för arbetsobjekttypen för användarberättelsen. Eftersom inget arbetsflödestillstånd är giltigt för det specifika teamet hindras medlemmar i det teamet från att spara arbetsobjektet med ändringar.

<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>

Begränsa tillståndsövergångar

För ärvda processer definieras alla-till-alla tillståndsövergångar automatiskt. Detta gör det möjligt för användare att avancera arbetsflödestillståndet från nytt till slutfört, men också att flytta bakåt om det behövs. När du definierar anpassade regler för att begränsa en övergång bör du tänka på att om en användare gör ett misstag när det gäller att uppdatera arbetsflödet kanske de inte kan korrigera det. De kan till exempel uppdatera statusen genom att flytta ett arbetsobjektkort till en senare fas på Kanban-tavlan, men inte flytta tillbaka det.

Dricks

Överväg att begränsa en tillståndsövergång för vissa men inte alla användare. På så sätt, om en användare gör ett misstag, kan de be en annan gruppmedlem att återställa state-värdet för att kringgå begränsningen.

Innan du definierar regler för tillståndsövergång läser du Regler och regelutvärdering, Automatiskt genererade regler och Hur arbetsflödestillstånd och tillståndskategorier används i kvarvarande uppgifter och tavlor.

Begränsa ändringar av stängda arbetsobjekt

Beroende på dina affärsprocesser kanske du vill förhindra att användare fortsätter att ändra eller uppdatera arbetsobjekt som har stängts eller slutförts. Du kan lägga till regler i arbetsobjektstyper för att förhindra att användare öppnar stängda arbetsobjekt igen.

Arvsprocess

För ärvd process kan du lägga till en regel som begränsar tillståndsövergången. Följande regel begränsar till exempel övergången från stängd till de andra två delstaterna New och Active.

Kommentar

Villkoret A work item state moved from ... är tillgängligt för Azure DevOps Server 2020 och senare versioner.

Kommentar

Beroende på vilken regelåtgärd du anger kan knappen Spara i arbetsobjektformuläret inaktiveras eller så visas ett felmeddelande när en begränsad användare försöker ändra arbetsobjektet.

Lokal XML-process

För lokala distributioner kan du lägga till regler i en typ av arbetsobjekt för att förhindra att ett arbetsobjekt öppnas igen när ett arbetsobjekt har stängts. Följande övergångsregler för arbetsflöden gör det till exempel möjligt för testare att öppna ett arbetsobjekt igen, men inte medlemmar i gruppen Utvecklare.

<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>

Dölj eller begränsa ändringar av ett fält baserat på en användare eller grupp

När du väljer Current user is a member of group... eller Current user is not a member of group...kan du dölja ett fält, göra ett fält skrivskyddat eller göra ett fält obligatoriskt.

Följande villkor anger till exempel att fältet Motivering är dolt för medlemmar som inte tillhör gruppen Fabrikam Fiber\Voice.

Kommentar

Arbetsobjekt omfattas av regler som tillämpas på dem. Villkorsregler som baseras på användar- eller gruppmedlemskap cachelagras för webbläsaren. Om du är begränsad till att uppdatera ett arbetsobjekt kan du ha stött på någon av dessa regler. Om du tror att du har stött på ett problem som inte gäller för dig läser du Problem med indexering av arbetsobjektsformulär för IndexDB.

Begränsa ändringar av valda fält baserat på en användare eller grupp

Du kan anpassa typer av arbetsobjekt för att begränsa vem som kan ändra ett visst fält för en arbetsobjektstyp.

Arvsprocess

Med något av följande två villkor kan du välja fält som krävs för en användare av en säkerhetsgrupp eller som inte är medlem i en säkerhetsgrupp.

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

Dricks

För att undvika problem med regelutvärdering som kan uppstå anger du Azure DevOps-säkerhetsgrupper och inte Microsoft Entra-ID eller Active Directory-säkerhetsgrupper. Mer information finns i Standardregler och regelmotorn.

Du kan till exempel göra fälten Rubrik eller Delstat skrivskyddade för utvalda användare eller grupper.

Fältet Prioritet för arbetsobjekttypen Användarberättelse blir till exempel skrivskyddat för medlemmar i gruppen Fabrikam Fiber\Voice. När en användare i den här gruppen öppnar en användarberättelse kan de inte ändra värdet i fältet Prioritet.

Lokal XML-process

För den lokala XML-processmodellen kan du anpassa arbetsobjekttyper för att stödja dessa begränsningsbegäranden:

• Begränsa vem som kan skapa eller ändra ett arbetsobjekt
• Begränsa vem som kan skapa specifika typer av arbetsobjekt, till exempel epos eller funktioner

Du kan till exempel begränsa ändringar av arbetsobjekt genom att lägga till en regel i arbetsobjekttypen, vanligtvis i avsnittet ARBETSFLÖDE .

Du begränsar åtkomsten till arbetsspårningsobjekt på något av två sätt:

• Ange en villkorsfältregel, en villkorsbaserad fältregel eller en kombination av de två som gäller för en grupp. Du kan begränsa ändringar från att göras till ett fält genom att ange en kvalificerande regel och göra så att den gäller för en viss grupp. Villkorsregler kan innehålla ELEMENTEN CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY och REQUIRED .
• Genom att lägga till WIT i gruppen Dolda kategorier kan du förhindra att de flesta projektdeltagare skapar dem. Du kan skapa en hyperlänk till en mall som öppnar arbetsobjektsformuläret och delar den länken med de gruppmedlemmar som du vill skapa dem.

Relaterade artiklar

• Tillämpa regler för arbetsflödestillstånd (arvsprocess)
• Regel- och regelutvärdering