Szabályok és szabályok kiértékelése

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

A szabályok érték-hozzárendelések beállítására vagy munkatételmezőre való korlátozására szolgálnak. Egy folyamathoz vagy projekthez két fő szabálytípus van meghatározva: automatikusan létrehozott szabályok és egyéni szabályok. Az automatikusan létrehozott szabályok minimálisra csökkentik az egyéni szabályok hozzáadásának szükségességét azokhoz a területekhez, amelyeknek szabványos módon kell működniük.

Egyéni szabályokat határoz meg az üzleti használati esetek támogatásához. A mező adattípusától függően különböző korlátozásokat állíthat be arra vonatkozóan, hogy milyen adatokat lehet beírni ebbe a mezőbe. Megadhat értékeket választólistához (legördülő menü), beállíthat alapértelmezett értékeket, törölhet bejegyzéseket, vagy korlátozhatja a módosításokat. Feltételes szabályokkal a különböző mezők értékei közötti függőségeken alapuló szabályokat alkalmazhat egy mezőre. Azt is korlátozhatja, hogy ki módosíthat egy mezőt, vagy meghatározhatja egy szabály hatókörét úgy, hogy az csak egy csoportra vonatkozzon.

Olvassa el ezt a cikket a következők megértéséhez:

• Hogyan alkalmazza a rendszer az automatikusan létrehozott szabályokat?
• A rendszermezőkre vonatkozó egyéni szabályok definíciójára vonatkozó korlátozások
• Az egyéni szabályok különböző típusai
• Szabályok kiértékelése
• Az öröklési folyamathoz definiált szabályok és a helyszíni XML-folyamatok közötti különbség
• Miért érdemes minimalizálni a definiált egyéni szabályok számát?

Az egyéni szabályok meghatározása előtt olvassa el az Azure Boards konfigurálása és testreszabása című cikket, amelyből átfogó képet kaphat arról, hogyan szabhatja testre az Azure Boardst az üzleti igényeinek megfelelően.

Tipp.

A WIT-hez definiált szabályok számának minimalizálása. Bár több szabályt is létrehozhat a WIT-hez, az összeadási szabályok negatív hatással lehetnek a teljesítményre, ha egy felhasználó munkahelyi elemeket ad hozzá és módosít. Amikor a felhasználók mentik a munkatételeket, a rendszer érvényesíti a munkatételtípus mezőihez tartozó összes szabályt. Bizonyos feltételek mellett a szabályérvényesítési kifejezés túl összetett ahhoz, hogy az SQL kiértékelje.

Automatikusan létrehozott szabályok

Az automatikusan létrehozott szabályok minimálisra csökkentik az egyéni szabályok hozzáadásának szükségességét azokhoz a területekhez, amelyeknek szabványos módon kell működniük.

Állapotáttrasztálási szabályok

Az örökölt folyamatok dinamikusan hozzák létre az állapotváltási szabályok teljes készletét minden egyéni munkaelem-típushoz és a munkafolyamathoz hozzáadott egyéni állapothoz. Bármely állapotról bármely állapotra való áttérés érvényes.

Helyszíni XML-folyamatok esetén meg kell adnia az érvényes áttűnéseket a WORKFLOW munkaelem-típusdefiníció szakaszában.

Állapotáttűnések és dátum/dátum mezőszabályok

A By/Date mezők a Created By/Date, az Activated By/Date, a Resolved By/Date és a Closed By/Date mezőknek felelnek meg.

Öröklődő folyamatok esetén ezek a mezők automatikusan be vannak állítva vagy törlődnek, amikor egy munkaelemet egyik állapotból a másikba helyez át. A Módosított dátum/dátum mezők nem jelennek meg, mivel minden munkaelem mentésekor frissülnek, és nem kapcsolódnak az állapotáttűnésekhez.

Az alábbi mezőket szabályozó alapértelmezett szabályok és viselkedések a következők:

1. A Lezárt állapot mindig a Kész állapot kategóriában található.
2. A Kész állapot kategória nem konfigurálható, és egy és csak egy állapothoz van társítva.
3. Ez a zárt állapot mindig zárva van az Agile- és CMMI-folyamatokhoz, és mindig Kész a Scrum- és alapszintű folyamatokhoz.
4. A szabályok automatikus létrehozását a területi beállítások befolyásolják, mivel a szabályfeltétel tartalmazza a honosított államnevet. A rendszer különböző szabályokat hoz létre a különböző területi beállításokhoz.
5. Ezekhez a mezőkhöz az automatikusan létrehozott szabályok csak a mezőket tartalmazó munkaelem-típusok esetében vannak megadva. Előfordulhat, hogy egy munkaelemtípus nem tartalmaz egy vagy több ilyen mezőt.
6. Ezekre a szabályokra akkor van szükség, ha egy munkaelemtípus egyéni állapotokkal rendelkezik, vagy a munkaelem típusa egyéni munkaelem-típus.
7. Ezek a szabályok csak az örökölt folyamatokra vonatkoznak; ezek soha nem jönnek létre a üzemeltetett XML- vagy helyszíni XML-folyamatokhoz.

A munkafolyamat-állapotok állapotkategóriákkal vannak társítva, hogy támogassák a munkafolyamatot a Kanban-táblákon. További információ: A munkafolyamat-állapotok és az állapotkategóriák használata a hátralékokban és a táblákban.

Állapotváltozás dátuma mezőszabályai

Ezek a szabályok technikailag sokkal egyszerűbbek, mint a Lezárt dátum/Záró dátum szabályok, mivel nem függnek semmilyen adott állapottól. Minden munkaelem-típus esetében ugyanazok a szabályok fognak működni. Ezeket automatikusan létre kell hozni, mert egyes OOB munkaelemtípusok nem tartalmazzák az Állapotváltozás dátuma mezőt, ezért amikor a felhasználó hozzáadja ezt a mezőt egy egyéni munkaelem-típushoz, ezeket a szabályokat is automatikusan létre kell hozni. Itt is ugyanazok az alapelvek érvényesek a lezárt/lezárt dátumra vonatkozó szabályokra.

Egyéni szabályok

Az egyéni szabályok megadása nem kötelező. Öröklődő folyamat esetén egy feltételből és műveletből álló szabályt kell megadnia. Helyszíni XML-folyamat esetén egy mezőre vagy a munkafolyamatra vonatkozó szabályokat kell megadnia.

A két folyamat között nincs egy-az-egyhez leképezés. Bizonyos esetekben az XML-elem szabálya az örökölt folyamat Szerkesztés párbeszédpaneljén van definiálva, nem szabályként. Más XML-elemek, például FROZENa NOTSAMEAS, MATCHnem támogatottak az örökölt folyamatban.

Vegye figyelembe a következőket:

• A szabályok mindig érvénybe lépnek, nem csak akkor, ha az űrlapot használja, hanem más eszközökkel való együttműködéskor is. Egy mező írásvédettként való beállítása például nem csak a munkaelem űrlapján alkalmazza a szabályt, hanem az API és az Excel Azure DevOps Server bővítményén keresztül is.
• Az örökölt folyamatbejegyzések feltételeket és műveleteket határoznak meg a teljes szabály létrehozásához. Az XML-elemek nem tesznek különbséget.
• A mezőszabályok nem támogatják olyan értékek hozzárendelését, amelyek két másik mező összegét képezik, vagy más matematikai számításokat hajtanak végre. Előfordulhat azonban, hogy a TFS Aggregator (Web Service) Marketplace bővítményen keresztül olyan megoldást talál, amely megfelel az igényeinek. Lásd még a munka és más mezők összesítését.
• További megoldásokat találhat az egyéni szabályok Marketplace-bővítményeket használó mezőkre való alkalmazására, például a Munkaelem űrlap vezérlőtárbővítményére.

Szabályösszeállítás

Öröklési folyamat

Az örökölt folyamatok esetében minden szabály két részből áll: feltételekből és műveletekből. A feltételek határozzák meg azokat a körülményeket, amelyeknek teljesülniük kell a szabály alkalmazásához. A műveletek határozzák meg a végrehajtandó műveleteket. A legtöbb szabály esetében legfeljebb két feltételt és szabályonként 10 műveletet adhat meg. Az egyéni szabályok futtatásához minden feltételnek teljesülnie kell.

Például kötelezővé teheti a mezőt az állapothoz rendelt érték és egy másik mező alapján. Példa:

   (Condition) When a work item State isAktív
   (Condition) And when the value ofValue Area = Business
   (Action) Then make requiredTörténeti pontok

Feljegyzés

Az állapotváltási szabályok jelenleg csak egy feltételt támogatnak. Ha állapotalapú szabályokat alkalmaz, olvassa el a Szabályok alkalmazása munkafolyamat-állapotokra című témakört.

Az alábbi táblázat összefoglalja a kiválasztott feltételekkel elérhető műveleteket.

Feltétel

Támogatott műveletek

Mezőérték beállítása, kötelezővé vagy írásvédetté tétele

Áttűnés korlátozása állapot alapján

Felhasználó- vagy csoporttagság alapján állítsa be a mezőattribútumot, vagy korlátozza az állapotáttűnést

Helyszíni XML-folyamat

A helyszíni XML-folyamat XML-elemeket használó szabályokat határoz meg. Ezen szabályelemek mindegyike definiálható a FIELD munkaelem-típusdefiníciók definíciója alapján. Az elem kivételével megadhatja ezeket a HELPTEXT szabályokat, amelyek hatással lehetnek a munkafolyamat-áttűnések során, vagy gyermekelemként egy FIELD (globális munkafolyamat) elemen belül.

Feljegyzés

A VALIDUSER TFS 2018 és újabb verziók nem támogatják az elemet.

Mezőszabály alkalmazási helye

Ha azt szeretné, hogy egy szabály a munkaelem teljes élettartama alatt érvényes legyen egy mezőre, adja meg a FIELD szakaszon belül. Például egy új és aktív hiba esetén kötelező mező a hiba bezárásáig szükséges marad. Ellenkező esetben, ha az állapot, az ok vagy az áttűnés módosítása alapján szeretné alkalmazni, adja meg a WORKFLOW szakaszon belül.

Az Állapot (System.State) és az Ok (System.Reason) mezők a WORKFLOW szakaszban vannak definiálva. Az állapotváltozás, az ok kiválasztása vagy egy adott áttűnés során a mezőkre alkalmazandó legtöbb mezőszabályt megadhatja. További információ: Munkaelem-típus munkafolyamatának módosítása.

Ellenkező esetben adjon meg egy szabályt, amely csak az állapotváltozás során értékelhető ki. Ezek a szabályok az WORKFLOW , REASONvagy TRANSITION elemek alatti STATEszakaszban vannak definiálva. A (Munkafolyamat) elemen kívül FIELD minden szabály HELPTEXTalkalmazható.

A mezőszabályok additívak. Vagyis négy szabálykészletet adhat meg ugyanahhoz a mezőhöz, amelyeket a szabálymotor kiértékel.

• A munkaelem típusspecifikus szabályai a munkaelem állapotmodellben elfoglalt helyétől függetlenül érvényesek. Egy szabály például <REQUIRED \> a következő ellenőrzést hajtja végre:

  "MyField Value" != NULL

• Az állapotspecifikus szabályok hatóköre egy munkaelem-példányra terjed ki, ha az adott állapotban van. Az állapotspecifikus szabály akkor lesz érvényesítve, ha a következő feltétel teljesül:

  State field value == "MyState" && "MyField Value" != NULL

• Az adott áttűnéshez megadott áttűnési szabályok hatóköre egy adott áttűnésen átesett munkaelemre terjed ki. Ezek a szabályok a következő feltételek teljesülése esetén lesznek érvényesítve:

  State field value == "ToState" &&
"Previous State Before Edit/New" == "FromState"
&& "MyField Value" != NULL

• Az adott okból megadott okspecifikus szabályok egy adott áttűnés adott okára vonatkoznak. A feldolgozásuk a következő feltételek teljesülése esetén történik:

  Reason field == "MyReason" &&
State field value == "ToState" &&
"Previous State Before Edit/New" == "FromState" && "MyField Value" != NULL

Az alábbi példa korlátozza az ügyfél súlyossági mezőjének módosítását, ha a munkaelem aktív állapotban van.

<STATE name="Active">
      <FIELDS>
      <FIELD refname="MyCorp.Severity" >
         <READONLY />
      </FIELD>
      </FIELDS>
</STATE>

Mi történik, ha túl sok szabály van definiálva

Projektenként egyetlen SQL-kifejezés van definiálva a munkaelemek ellenőrzéséhez, amikor azok létrejönnek vagy frissülnek. Ez a kifejezés a projekthez definiált összes munkaelem-típushoz megadott szabályok számával növekszik. A mezőhöz megadott viselkedési minősítők az alkifejezések számának növekedését eredményezik. A beágyazott szabályok, a csak áttűnésekre vagy más mezők értékére kondicionált szabályok további feltételeket adnak egy utasításhoz IF . Ha a kifejezés eléri a kívánt méretet vagy összetettségét, az SQL nem tudja többé kiértékelni, és hibát okoz. Néhány WIT eltávolítása vagy néhány szabály megszüntetése megoldhatja a hibát.

Megadhat értékeket választólistához (legördülő menü), beállíthat alapértelmezett értékeket, törölhet bejegyzéseket, vagy korlátozhatja a módosításokat. Feltételes szabályokkal a különböző mezők értékei közötti függőségeken alapuló szabályokat alkalmazhat egy mezőre. Azt is korlátozhatja, hogy ki módosíthat egy mezőt, vagy meghatározhatja egy szabály hatókörét úgy, hogy az csak egy csoportra vonatkozzon.

A munkaelem-szabályok nem léteznek egyetlen gyűjteményként. A szabályok valójában dinamikusan jönnek létre és egyesülnek különböző adatforrásokból. Az egyesítési logika egyszerű, azonos szabályokat összesít, de nem vágja ki az ütköző szabályokat.

Szabályok megkerülése

Általában az összes munkaelemet ellenőrzi a szabálymotor, amikor a felhasználók módosítják a munkaelemet. Bizonyos forgatókönyvek támogatásához azonban a munkaelem-frissítések megkerülő szabályaihoz hozzárendelt felhasználók projektszintű engedélyekkel menthetik a munkaelemeket a szabályok kiértékelése nélkül.

A szabályok kétféleképpen megkerülhetők. Az első a Munkaelemeken keresztül történik – frissítse a REST API-t , és állítsa a paramétert a bypassRules következőre true: . A második az ügyfélobjektum-modellen keresztül történik, a bypassrules módban való inicializálással (inicializálva WorkItemStore ezzel WorkItemStoreFlags.BypassRules).

Rendszermezők és egyéni szabályok

A rendszermezők rendszerszintűek.Névhivatkozások nevei, például System.Title és System.State.

A következő rendszermezőknek rendelkezniük kell értékkel: Területazonosító, Módosított dátum, Létrehozás dátuma, Létrehozás dátuma, Állam és Ok.

A szabálymotor a beállítási feltételeket vagy műveleteket a rendszermezőkre korlátozza, kivéve az alábbiakat:

• Az Állapot és ok mezők írásvédetté alakíthatók.
• A legtöbb szabályt alkalmazhatja a Cím, a Hozzárendelt, a Leírás és a Módosítva mezőkre.

Ha nem jelenik meg egy mező az öröklési folyamat szabály felhasználói felületének legördülő menüjében, akkor ez az oka. Ha például a Terület elérési útját (System.AreaPath) egy feltétel alapján írásvédetté szeretné tenni, a Terület elérési útja mező nem választható ki. Még ha meg is tud adni egy rendszermezőt, a szabálymotor korlátozhatja a szabály mentését.

Alapértelmezett és másolási szabályok

Az alapértelmezett és másolási szabályok módosítják a munkaelemmezők értékeit. Meghatároznak futásidejű viselkedést és korlátozásokat, például az alapértelmezett értékek megadását, a mezők törlését, a mezők definiálását és egyebeket.

Ezeknek a szabályoknak az alkalmazását az aktuális felhasználó csoporttagsága alapján korlátozhatja a felhasználói vagy csoporttagsági szabályokra vonatkozó korlátozásokban leírtak szerint.

Öröklési folyamat

A szabályműveletek többsége bármely feltétel kiválasztásával alkalmazható.

Örökölt folyamatművelet

Leírás

Copy the value from...

Egy másik mezőt ad meg, amely az aktuális mezőbe másolni kívánt értéket tartalmaz.

Clear the value of...

Törli a benne található értékek mezőjét.

Use the current time to set the value of ...

Egy mező idejét az aktuális felhasználó időbeállítása alapján állítja be.

Helyszíni XML-folyamat

Ezek a szabályok támogatják az alapértelmezett beállításokat, az értékek egyik mezőről a másikra való másolását, vagy egy mező értékének kikényszerítését az előírt mintának megfelelően. A szintaxis szerkezetével és példáival kapcsolatban lásd : Alapértelmezett érték definiálása vagy érték mezőbe másolása.

XML-elem

Használat

COPY

Ha egy felhasználó létrehoz vagy módosít egy munkaelemet, másol egy megadott értéket egy mezőbe.

<FIELD refname="MyCorp.Status" name="Status" type="String">  
   <COPY from="value" value=" " />  
</FIELD> 

DEFAULT

Olyan mező értékét adja meg, amely üres, amikor egy felhasználó létrehoz vagy módosít egy munkaelemet. Ha egy mező már rendelkezik értékkel, a DEFAULT szabály figyelmen kívül lesz hagyva. Az alapértelmezett szabályok csak akkor futnak, ha a Is mező értéke jelenleg üres. A támogatott értékek közé tartozik az aktuális idő (from = "clock"), az aktuális felhasználó (from = "currentuser"), a literális érték (from = "value" value = "literal") vagy egy másik mező (from = field field = "referenceNameField") értéke.

<FIELD refname="MyCorp.Priority" name="Priority" type="String" 
<HELPTEXT>Specify the severity of the problem</HELPTEXT 
   <ALLOWEDVALUES 
      <LISTITEM value="P1"/ 
      <LISTITEM value="P2"/ 
      <LISTITEM value="P3"/ 
   </ALLOWEDVALUES 
<DEFAULT from="value" value="P3"/ 
</FIELD 

SERVERDEFAULT

Megadja a kiszolgáló óráját vagy az aktuális felhasználót egy mezőérték meghatározásához.

<TRANSITION from="New" to="Active">  
   <ACTIONS>  
      <ACTION value="Microsoft.VSTS.Actions.StartWork" />  
   </ACTIONS>  
   <REASONS>  
      <DEFAULTREASON value="Work started" />  
   </REASONS>  
   <FIELDS>  
      <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">  
            <COPY from="currentuser" />  
            <VALIDUSER />  
            <REQUIRED />  
      </FIELD>  
      <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">  
         <SERVERDEFAULT from="clock" />  
      </FIELD>  
      <FIELD refname="System.AssignedTo">  
      <DEFAULT from="currentuser" />  
      </FIELD>  
   </FIELDS>  
</TRANSITION>  

Kényszerszabályok

A korlátozási szabályok korlátozzák egy mező értékének módosítását. A munkaelem érvényes állapotát határozzák meg. Minden kényszer egyetlen mezőn működik. A rendszer kiértékeli a kényszereket a munkaelem-mentés kiszolgálóján, és ha bármilyen korlátozást megsért, a mentési műveletet a rendszer elutasítja.

Ezeknek a szabályoknak az alkalmazását az aktuális felhasználó csoporttagsága alapján korlátozhatja a felhasználói vagy csoporttagsági szabályokra vonatkozó korlátozásokban leírtak szerint.

Öröklési folyamat

A szabályműveletek többsége bármely feltétel kiválasztásával alkalmazható.

Örökölt folyamatművelet

Leírás

Hide the field...
Csak akkor érhető el, ha egy csoporttagsági feltétel van kiválasztva.

Megadja, hogy ne jelenjen meg a mező a munkaeleműrlapon, ami lényegében nem teszi lehetővé az aktuális felhasználó számára a mező értékének módosítását.

Make read-only

Megakadályozza, hogy egy mező egyáltalán módosuljon. Előfordulhat, hogy ezt a szabályt bizonyos feltételek mellett szeretné alkalmazni. Egy munkaelem bezárása után például írásvédett mezőt szeretne létrehozni az adatok jelentéskészítési célokra való megőrzéséhez.
A mező alapértelmezett írásvédett értékének megadásához adja meg a Mező szerkesztése párbeszédpanel Beállítások lapján.

Make required

A felhasználónak meg kell adnia egy értéket a mezőhöz. A felhasználók csak akkor menthetnek munkaelemet, ha az összes kötelező mezőhöz hozzárendeltek értékeket.
A mező alapértelmezett értékének megadásához adja meg a Mező szerkesztése párbeszédpanel Beállítások lapján.

Helyszíni XML-folyamat

XML-elem

Használat

ALLOWEDVALUES

A mező engedélyezett értékeinek listáját határozza meg. Az engedélyezett értékek olyan értékek, amelyek kiválaszthatóak a munkaelem-űrlapok mezőlistájában és a lekérdezésszerkesztőben. Az alábbi értékek közül kell választania.

CANNOTLOSEVALUE

Megakadályozza, hogy a felhasználók az érték megadása után töröljenek egy értékmezőt. Ez az elem megtartja az aktuális mezőértéket, és nem törölhető és nem lehet üressé tenni.

<FIELD refname="MyCorp.Priority" name="Management Priority" type="String">  
    <CANNOTLOSEVALUE /> 
</FIELD> 

FROZEN

Megakadályozza, hogy a felhasználók módosítják egy mező értékét, ha az tartalmaz egy értéket. Amint egy felhasználó menti a munkaelemet az adott mezőben lévő értékkel, az érték már nem módosítható. A véglegesített mezők nem módosíthatók nem üres értékre a módosítások véglegesítése után. Manuálisan azonban törölheti a mezőt, mentheti a munkaelemet, majd megadhat egy másik értéket.

<FIELD refname="MyCorp.Priority" name="Management Priority" type="String">  
    <FROZEN not="[Project]\Management Team" /> 
</FIELD> 

EMPTY

Törli a mező tartalmát, majd írásvédetté teszi a mezőt, amikor egy felhasználó menti a munkaelemet. Ne használja EMPTY a következőt READONLY: .
EMPTYaz állapotváltás során elsősorban az elem áttűnésének állapotára vonatkozó mezők törlésére szolgál.

<FIELD refname="MyCorp.SubStatus" />  
   <WHEN field="MyCorp.Status" value="Approve" >  
     <EMPTY />
   </WHEN>  
</FIELD>  

MATCH

A sztringmezőbe írt bejegyzésekre kényszeríti a megadott karakter- vagy számmintának való megfelelést. Ha több MATCH elemet határoz meg, az érték érvényesnek minősül, ha megfelel a megadott minták bármelyikének. Ha legalább egy elem sikeres, a mező érvényes értékkel rendelkezik.

<FIELD refname="MyCorp.GitHubURL" name="GitHub URL" type="String">  
   <MATCH pattern="https:\/\/github\.com\/\S+[\.md|\.yml]$"/>  
</FIELD>

NOTSAMEAS

Megakadályozza, hogy egy mező ugyanazzal az értékkel legyen hozzárendelve, mint amelyet egy másik mezőhöz rendeltek.

<FIELD refname="MyCorp.Status" name="Status" type="String">  
    <NOTSAMEAS field="MyCorp.SubStatus" /> 
</FIELD> 

PROHIBITEDVALUES

A mező tiltott értékeinek listáját határozza meg. Ha egy adott mezőre több ALLOWEDVALUES és/vagy PROHIBITEDVALUES szabály vonatkozik, az érvényes értékek teljes listája az összes engedélyezett értéklista metszéspontja – vagy minden, ha nincsenek engedélyezett értéklisták – mínusz– azaz különbség beállítása – az összes tiltott értéklista egyesítését jelenti.

READONLY

Megakadályozza, hogy egy mező egyáltalán módosuljon. Előfordulhat, hogy ezt a szabályt bizonyos feltételek mellett szeretné alkalmazni. Egy munkaelem bezárása után például írásvédett mezőt szeretne létrehozni az adatok jelentéskészítési célokra való megőrzéséhez.
Ne használja READONLY az elemet, EMPTY mert EMPTY a mező írásvédetté is válik. Az elemek kombinálása inkonzisztens eredményeket eredményezhet.
Emellett az elemattribútum ReadOnly használatával írásvédettként is megjelenítheti a mezőt a Control munkaelem-űrlapon. A mezőt más ügyfelek is megírhatják, de a munkaelem űrlapon nem.

<FIELD refname="MyCorp.Status" name="Status" type="String">  
    <READONLY />  
</FIELD> 

REQUIRED

A felhasználónak meg kell adnia egy értéket a mezőhöz. A felhasználók csak akkor menthetnek munkaelemet, ha az összes kötelező mezőhöz hozzárendeltek értékeket.

<FIELD refname="MyCorp.Status" name="Status" type="String">  
    <REQUIRED />  
</FIELD> 

Listák kiválasztása

A kiválasztási listák határozzák meg azokat az értékeket, amelyeket egy felhasználó sztring vagy egész szám mezőhöz választhat vagy nem. A kiválasztó listában definiált értékek egy munkaeleműrlapon és a lekérdezésszerkesztőben jelennek meg.

Öröklési folyamat

Örökölt folyamat esetén a listaválasztók a Szerkesztés párbeszédpanelen vannak definiálva.

Mező szerkesztése párbeszédpanel

Leírás

Egy picklist mező Definíció lapja

A mező engedélyezett értékeinek listáját határozza meg. Az engedélyezett értékek olyan értékek, amelyek kiválaszthatóak a munkaelem-űrlapok mezőlistájában és a lekérdezésszerkesztőben. Az alábbi értékek közül kell választania.

A Beállítások lapon jelölje be a Saját értékek megadásának engedélyezése a felhasználók számára jelölőnégyzetet, hogy a felhasználók saját bejegyzéseket adjanak meg

A mező javasolt értékeinek listáját határozza meg. A javasolt értékek olyan értékek, amelyek kiválaszthatóak a munkaelem-űrlapok mezőlistájában és a lekérdezésszerkesztőben. A listában szereplő értékek mellett más értékeket is megadhat.

Helyszíni XML-folyamat

A pick listákat az alábbi táblázatban felsorolt XML-elemek használatával határozhatja meg. A szintaxis szerkezetét és példáit a listaválasztási listák definiálása című témakörben találhatja meg.

Egyesítheti a listákat, kibonthatja vagy összefűzheti a listákat. Ezen szabályok alkalmazását az aktuális felhasználó csoporttagsága alapján is korlátozhatja a felhasználó vagy a csoporttagságra vonatkozó szabályok korlátozásaiban leírtak szerint.

XML-elem

Leírás

ALLOWEDVALUES

A mező engedélyezett értékeinek listáját határozza meg. Az engedélyezett értékek olyan értékek, amelyek kiválaszthatóak a munkaelem-űrlapok mezőlistájában és a lekérdezésszerkesztőben. Az alábbi értékek közül kell választania.

ALLOWEXISTINGVALUE

A meglévő értékek engedélyezéséhez definiálja a mezőt. Ez az elem lehetővé teszi a már létező mezőértékek használatát, még akkor is, ha érvénytelenek. Minden új mezőértéknek érvényesnek kell lennie.

PROHIBITEDVALUES

A mező tiltott értékeinek listáját határozza meg.

SUGGESTEDVALUES

A mező javasolt értékeinek listáját határozza meg. A javasolt értékek olyan értékek, amelyek kiválaszthatóak a munkaelem-űrlapok mezőlistájában és a lekérdezésszerkesztőben. A listában szereplő értékek mellett más értékeket is megadhat.

Identitásmezők és érvényesítési hibák

Annak érdekében, hogy elkerülje azokat az érvényesítési hibákat, amelyek egyébként akkor fordulnak elő, amikor a tagok elhagyják a csapatot, és már nem regisztráltak projekt-közreműködőként, adja meg a Hozzárendelt mező ALLOWEXISTINGVALUE elemét.

<FIELD name="Assigned To" refname="System.AssignedTo" type="String" syncnamechanges="true" reportable="dimension">
      <HELPTEXT>The user who is working on this work item</HELPTEXT>
      <ALLOWEXISTINGVALUE />
      <VALIDUSER />
      <ALLOWEDVALUES expanditems="true" filteritems="excludegroups">
      <LISTITEM value="Active" />
      <LISTITEM value="[project]\Contributors" />
      </ALLOWEDVALUES>
      <DEFAULT from="field" field="System.CreatedBy" />
</FIELD>

Feltételes mezőértékek vagy -módosítások

A feltételes szabályok olyan műveletet határoznak meg, amely egy adott értéket egyenlő vagy nem egyenlő mező értéke alapján határoz meg, vagy ha egy adott mező értékének módosítása történt vagy nem történt meg. A feltételes szabályok általában először a feltétel nélküli szabályokra vonatkoznak. Ha több feltételes szabály értéke igaz, a végrehajtás sorrendje a következő: Mikor, Mikor, Mikor, Kihangosított, MikorNotChangolt.

Öröklési folyamat

Mezőnként több feltételes szabályt is megadhat. Feltételes szabályonként azonban csak egyetlen vezetési mezőt adhat meg.

Örökölt feltétel

Leírás

The value of ... (equals) [Mikor]

Egy vagy több, az aktuális mezőre alkalmazandó szabályt ad meg, ha egy másik mező adott értékkel rendelkezik.

A change was made to the value of ... [Kihangosított]

Egy vagy több szabály alkalmazása az aktuális mezőre egy adott mező értékének módosításakor.

The value of ... (not equals) [WhenNot]

Egy vagy több szabályt alkalmaz az aktuális mezőre, ha egy másik mező nem rendelkezik adott értékkel.

No change was made to the value of ... [MikorNotChanged]

Egy vagy több szabály alkalmazása az aktuális mezőre, ha egy adott mező értéke nem módosul.

Örökölt művelet

Leírás

Clear the value of ...
Copy the value from ...
Make read-only ...
Make required ...
Set the value of ...
Use the current time to set the value of ...
Use the current user to set the value of ...

Egy adott mezőn végrehajtandó műveletet adja meg.

Helyszíni XML-folyamat

A rendszer a következő XML-elemeket használja a más szabályok kiértékelésének feltételeinek beállításához. Mezőnként több feltételes szabályt is megadhat. Feltételes szabályonként azonban csak egyetlen vezetési mezőt adhat meg. Feltételes szabályok nem ágyazhatók be. Az egyes folyamatmodellekhez támogatott műveletek közé tartoznak az alábbi táblázatban felsorolt műveletek.

Szintaxisstruktúra és példák: Feltételes értékek és szabályok hozzárendelése. Ezeknek a szabályoknak az alkalmazását az aktuális felhasználó csoporttagsága alapján korlátozhatja a felhasználói vagy csoporttagsági szabályokra vonatkozó korlátozásokban leírtak szerint.

XML-elem

Használat

WHEN

Egy vagy több, az aktuális mezőre alkalmazandó szabályt ad meg, ha egy másik mező adott értékkel rendelkezik. A szülőelem határozza meg az aktuális mezőt.
Ha a megadott mező rendelkezik a megadott értékkel, az elem szabályai az aktuális mezőre lesznek alkalmazva.

WHENCHANGED

Megadja azt a feltételt, amely alapján egy vagy több szabályt kell alkalmazni az aktuális mezőre. A szabályok akkor vonatkoznak az aktuális mezőre, ha egy másik mező értékét egy munkaelemre módosítják egy változatban. A szülőelem határozza meg az aktuális mezőt.

WHENNOT

Megadja azt a feltételt, amely alapján egy vagy több szabályt kell alkalmazni az aktuális mezőre. A szabályok az aktuális mezőre vonatkoznak, amikor egy másik mező értéke megváltozik. A szülőelem határozza meg az aktuális mezőt.
Ha a megadott mező nem tartalmazza a megadott értéket, az elem szabályai az aktuális mezőre lesznek alkalmazva.

WHENNOTCHANGED

Megadja azt a feltételt, amely alapján egy vagy több szabályt kell alkalmazni az aktuális mezőre. A szabályok akkor vonatkoznak az aktuális mezőre, ha egy másik mező értéke nem módosul a munkaelemre vonatkozó változatban. A szülőelem határozza meg az aktuális mezőt.

Felhasználói vagy csoporttagsági szabályok korlátozásai

Egy szabály alkalmazását az aktuális felhasználó tagsága alapján korlátozhatja. Azt javasoljuk, hogy a szabályt egy Azure DevOps biztonsági csoportra és ne egyetlen felhasználóra terjedje ki, bár az utóbbit megadhatja. Ahhoz, hogy a szabály hatóköre több csoportra terjedjen ki, létre kell hoznia egy szülő Azure DevOps-csoportot, amely tartalmazza a használni kívánt csoportokat.

Folyamat implementálása

Tipp.

Az esetlegesen felmerülő szabályértékelési problémák elkerülése érdekében adja meg az Azure DevOps biztonsági csoportjait, és ne a Microsoft Entra-azonosítót vagy az Active Directory biztonsági csoportokat. További információ: Alapértelmezett szabályok és a szabálymotor.

Öröklési folyamat

Az alábbi táblázatban leírtak szerint egy szabálynak az aktuális felhasználó tagsága alapján történő korlátozásához meg kell adnia az örökölt folyamat két feltételének egyikét. Ezek a szabályok aktívak az Azure DevOps 2020 és újabb verzióiban.

A következőkre vonatkozik

Szabály

Feltétel

Current user is a member of group ...
Current user is not member of group ...

Művelet

Hide the field ...
Make read-only ...
Make required ...
Restrict the transition to state ...

Helyszíni XML-folyamat

Ha egy szabályt az aktuális felhasználó tagsága alapján szeretne korlátozni, a szabályelemben meg kell adnia az attribútumokat vagy not az for attribútumokat. Megadhatja a szabály hatókörét. Ahhoz, hogy a szabály hatóköre több csoportra terjedjen ki, létre kell hoznia egy szülő Azure DevOps-csoportot, amely tartalmazza a használni kívánt csoportokat.

Forgatókönyv

Használat

Mező kötelezővé tétele csak egy adott csoporthoz

Szabály csoportra való alkalmazásához használható for . Ebben a példában a Junior Analysts csoport bármely felhasználójának be kell fejeznie a Második jóváhagyó mezőt.

<FIELD name="Second Approver">
<REQUIRED for="Example1\Junior Analysts"/>
</FIELD>

Mező módosításának korlátozása felhasználók csoportjára

Csoport not kizárása egy szabályból. Ez a példa a Triage Description mezőt írásvédettként határozza meg a Triage Bizottság csoportjában lévő felhasználók kivételével mindenki számára.

<FIELD name="Triage Description">
<READONLY not="[Project]\Triage Committee" />
</FIELD>

Egyes felhasználók számára kötelező mező létrehozása, mások számára nem

Használjon egy szabály kombinációját for , és not egyidejűleg alkalmazza a szabályt néhányra, másokra nem. Ez a példa a Súlyosságot a Projekttagok csoport felhasználói számára kötelező mezőként határozza meg, a Project Rendszergazda s csoportban lévők esetében azonban nem. Ha egy felhasználó mindkét csoportban szerepel, az for utasítás kényszerítve lesz, és a mezőre szükség lesz.

<FIELD name="Severity">
<REQUIRED for="[Project]\Project Members" not="[Global]\Project Admins"/>
</FIELD>

Jogkivonatok használata felhasználókra vagy csoportokra való hivatkozáshoz

Az identitás- vagy személyválasztó mezők elfogadhatnak olyan értékeket, amelyek a felhasználókra és a csoportokra egyaránt hivatkoznak. Ha egy szabályt egy csoportra korlátoz, a csoport tartományát vagy hatókörét kell megadnia. Bizonyos értékekhez jogkivonatokat is használhat.

Öröklési folyamat

A jogkivonatok például a következők:

• [ProjectName], például [Fabrikam], [FabrikamFiber], [MyProject]
• [OrganizationName], például [fabrikam], [myorganization]
• [CollectionName], például [fabrikam], [myorganization]

A projekt vagy a szervezet számára elérhető hatókörök megismeréséhez lépjen a Project Gépház> Permissions>Groups vagy Organization Gépház Permissions Groups (Szervezeti Gépház> Permissions>Groups) lapra, és szükség szerint szűrheti a listát. Az alábbi képen például az Azure DevOps alapján szűrt lista első négy bejegyzése látható. További információ: Projektszintű engedélyek módosítása vagy Projektcsoportszintű engedélyek módosítása.

Helyszíni XML-folyamat

A jogkivonatok például a következők:

• [Project], például [Projekt]\Közreműködők, [Projekt]\Fabrikam Team, [Project]\Project Jóváhagyók A [Projekt] jogkivonat egy projekthez definiált csoportot határoz meg. Ez megfelelhet egy csapatnak, egy alapértelmezett vagy egyéni biztonsági csoportnak, vagy egy, a projekthez hozzáadott Active Directory-csoportnak.
• [GLOBAL], ha gyűjtemény hatókörű csoportra szeretne hivatkozni, például: [GLOBAL]\Project Collection Rendszergazda istrators Use [GLOBAL], amely egy gyűjtemény hatókörű biztonsági csoportra hivatkozik, például a Project Collection Rendszergazda istrators csoportra vagy egy gyűjteményhez hozzáadott Windows-csoportra. Például:

  <FIELD name="Title">
      <READONLY for="[GLOBAL]\Project Collection Valid Users"/>
  </FIELD>
  

• [Team Foundation] egy kiszolgáló hatókörű csoportra való hivatkozáshoz, például: [Team Foundation]\Team Foundation Rendszergazda istrators A [Team Foundation] használatával hivatkozhat egy kiszolgáló hatókörű csoportra, például egy beépített csoportra vagy egy kiszolgálószintű csoporthoz hozzáadott Windows-csoportra. Például:

  <FIELD name="Title">
      <READONLY for="[Team Foundation]\Team Foundation Valid Users"/>
  </FIELD>
  

• A(z) [DomainName] egy kiszolgáló hatókörű csoportra való hivatkozáshoz használható, például a [Team Foundation]\Team Foundation Rendszergazda istrators tartománya által minősített fióknévre, például az alábbi példában láthatóra, egy tartományi felhasználóra vagy csoportra való hivatkozáshoz. Egyes szabályok csak a csoportokat támogatják, és nem támogatják a tartományfelhasználókra való hivatkozást.

  <LISTITEM value="FABRIKAM\Christie Church's Direct Reports"/>
  

Feljegyzés

A [Project], a [GLOBAL] és a [Team Foundation] is ugyanúgy használható. Nem cserélje le őket a projekt, a gyűjtemény vagy a kiszolgáló nevére.

A projekthez vagy gyűjteményhez elérhető hatókörökről a Project Gépház> Permissions>Groups vagy Collection Gépház> Permissions>Groups (Csoportcsoportok) lapon tájékozódhat. Szükség szerint szűrje a listát. Az alábbi képen például az Azure DevOps alapján szűrt lista első négy bejegyzése látható. További információ: Projektszintű engedélyek módosítása vagy Projektcsoportszintű engedélyek módosítása.

Az összes felhasználót és csoportot ezen jogkivonatok egyikének kell minősítenie. A következő XML például nem érvényes, mert nem minősíti a megadott csoportot érvényes jogkivonattal.

<FIELD name="Title">
    <READONLY for="Dev Team"/>
</FIELD>

Az alapértelmezett biztonsági csoportokkal kapcsolatos további információkért lásd: Engedélyek és csoportok

Szabály kiértékelése

A munkaelemet módosító felhasználó vagy csoporttagság alapján feltételt meghatározó szabályokat a rendszer kétféleképpen értékeli ki. A szabály kiértékelésekor az alkalmazásnak meg kell határoznia, hogy a szabály az aktuális felhasználóra vonatkozik-e, és ellenőrizze, hogy az adott felhasználó tagja-e a megadott csoportnak.

• Amikor módosítja a munkaelemet a webes portálról, a REST API-ból vagy az Azure Boards parancsból, a rendszer kérést küld a Microsoft Entra-azonosítóhoz vagy az Active Directoryhoz. A művelettel kapcsolatban nem történik probléma.
• Amikor a munkaelemet a Visual Studióból, az Excelből vagy más egyéni eszközből módosítja a WIT ügyfélobjektum-modellel, a tagság kiértékelésére irányuló kérés egy ügyfél-gyorsítótáron alapul. Az ügyfélgyorsítótár nem ismeri az Active Directory-csoportokat.

Feljegyzés

A GIT-t használó projektekhez készült Visual Studio 2019 Team Explorer rest API-k használatára lett újraírva.

A különböző ügyfelek munkaelemeinek frissítésével kapcsolatos problémák elkerülése érdekében az Active Directory-csoportok helyett adja meg az Azure DevOps biztonsági csoportjait. Egyszerűen létrehozhat egy Azure DevOps biztonsági csoportot, amely megfelel egy Active Directory-csoportnak. További információ: Felhasználók vagy csoportok hozzáadása vagy eltávolítása, biztonsági csoportok kezelése.

Feljegyzés

A WIT-ügyfél OM elavult. 2020. január 1-étől már nem támogatott az Azure DevOps Services és az Azure DevOps Server 2020 használata.

A szabályok kiértékelésének sorrendje

A szabályok általában abban a sorrendben vannak feldolgozva, amelyben szerepelnek. Az összes szabály kiértékelésének teljes sorozata azonban nem teljesen determinisztikus.

Ez a szakasz a feltételes, másolási és alapértelmezett szabályok alkalmazásakor várható viselkedést és interakciókat ismerteti.

Öröklési folyamat

Az alábbi lépések a megfelelő sorrendben mutatják be az Azure DevOps által és egy munkaelem-űrlap felhasználója által végrehajtott interakciókat. A felhasználó csak az 1., a 8. és a 13. lépést hajtja végre.

1. Egy Azure DevOps-ügyfélből – például a webes portálról vagy a Visual Studio Team Explorerből – egy felhasználó létrehoz egy új munkaelemet, vagy szerkeszt egy meglévő munkaelemet.

2. A mezők alapértelmezett kitöltése. Minden mezőre alkalmazza a feltételes záradék részét nem képező mezőhöz rendelt alapértelmezett értékeket.

3. Mezőértékek másolása vagy beállítása. Minden mező esetében alkalmazzon bármilyen szabályt egy érték másolására vagy egy olyan mező értékének beállítására, amely nem része egy feltételes záradéknak.

4. Minden olyan mező esetében, amely egyezést eredményez a When feltételes szabálysal, alkalmazzon szabályokat egy mezőérték beállítására vagy másolására.

5. Ha nem egyező feltételes szabályt tartalmazó mezőket használ, alkalmazzon szabályokat a mezőértékek beállítására vagy másolására.

   A rendszer mindig a Mikor nem szabályok előtt dolgozza fel a Szabályokat.

6. Az 1. lépés óta módosított és a Módosítva szabályokat tartalmazó mezők esetében a mezőértékek beállításához vagy másolásához alkalmazzon szabályokat.

7. Engedélyezze a felhasználónak a szerkesztést.

8. A felhasználó módosít egy mezőértéket, majd áthelyezi a fókuszt a mezőből.

9. Az új értéknek megfelelő, az adott mezőre vonatkozó When-szabályok feldolgozása.

10. Dolgozza fel az új értéknek megfelelő, az adott mezőhöz tartozó When Not szabályokat.

11. Az új értéknek megfelelő mező módosított szabályainak feldolgozása.

12. Adja vissza a szerkesztési képességet a felhasználónak.

13. A felhasználó menti az adattár módosításait.

14. Minden mezőre alkalmazza a mezőhöz közvetlenül vagy közvetetten, egy feltételes szabály alapján definiált műveleteket Use the current time to set the value of ... .

Helyszíni XML-folyamat

A szabályok általában abban a sorrendben vannak feldolgozva, amelyben szerepelnek. A MIKOR, a DEFAULT és a COPY elemek használatakor azonban további viselkedések is alkalmazhatók. Az alábbi lépések a megfelelő sorrendben mutatják be az Azure DevOps által és egy munkaelem-űrlap felhasználója által végrehajtott interakciókat. A felhasználó csak az 1., a 8. és a 13. lépést hajtja végre.

1. Egy Azure DevOps-ügyfélből – például a webes portálról vagy a Visual Studio Team Explorerből – egy felhasználó létrehoz egy új munkaelemet, vagy szerkeszt egy meglévő munkaelemet.

2. A mezők alapértelmezett kitöltése. Minden mezőre alkalmazza a kívül vagy a MIKOR szabályokon kívül megadott ALAPÉRTELMEZETT szabályokat.

3. Mezőértékek másolása. Minden mezőhöz használjon a WHEN záradékokon kívül eső MÁSOLÁSi szabályokat.

4. Az összes olyan mezőnél, ahol egyezés van, először az ALAPÉRTELMEZETT, majd a MÁSOLÁS szabályt kell végrehajtani.

5. Az egyező WHENNOT-szabálysal rendelkező összes mező esetében először az ALAPÉRTELMEZETT, majd a MÁSOLÁS szabályokat kell végrehajtania.

   A rendszer mindig akkor dolgozza fel a WHEN-szabályokat, amikor a WHENNOT-szabályok előtt.

6. Az 1. lépés óta módosított és a WHENCHANGED szabályokat tartalmazó mezők esetében először az ALAPÉRTELMEZETT, majd a MÁSOLÁS szabályokat kell végrehajtani.

7. Engedélyezze a felhasználónak a szerkesztést.

8. A felhasználó módosít egy mezőértéket, majd áthelyezi a fókuszt a mezőből.

9. Az új értéknek megfelelő, a mezőhöz tartozó WHEN-szabályok emelése.

10. Az új értéknek megfelelő, a mezőhöz tartozó WHENNOT-szabályok megadása.

11. Az új értéknek megfelelő mezőhöz tartozó WHENCHANGED-szabályok megadása.

12. Adja vissza a szerkesztési képességet a felhasználónak.

13. A felhasználó menti az adatbázis módosításait.

14. Minden mező esetében hajtsa végre a Standard kiadás RVERDEFAULT műveleteket, amelyek a mezőhöz közvetlenül vagy közvetve egy WHEN vagy egy WHENNOT szabály alapján vannak definiálva.

Billentyűleütési bejegyzések és szabályértékelés

A rendszer minden alkalommal beállít egy új értéket egy mezőhöz, amikor egy felhasználó billentyűleütést ad meg egy mezőben a munkaelem űrlapon keresztül. Ez azt jelenti, hogy a feltételes szabály váratlanul előfordulhat, amikor a szabály előfeltételei teljesülnek.

A következő XML-példában a rendszer kiüríti a MyCorp.SubStatus értéket, amikor beírja a "Jóváhagyva újra" szöveget az Állapot mezőbe, mert a WHEN szabály akkor is bekövetkezik, amikor a felhasználó beírja az "e" betűt a Jóváhagyás mezőbe, még akkor is, ha a kívánt végső érték nem "Jóváhagyás". Ezért gondolja át alaposan, ha feltételes szabályokat használ.

<FIELD refname="MyCorp.SubStatus" />
   <WHEN field="MyCorp.Status" value="Approve" >
      <EMPTY />
   </WHEN>
</FIELD>

Kapcsolódó cikkek

• Példaszabály-forgatókönyvek
• Munkatétel mezőindex
• Munkaelemmezők és -attribútumok
• Projektszintű engedélyek módosítása
• Projektcsoportszintű engedélyek módosítása
• Engedélyek és csoportok
• Örökölt folyamat
  • Egyéni szabály hozzáadása munkaelem-típushoz
  • Szabályok alkalmazása munkafolyamat-állapotokra
• Helyszíni XML-folyamat
  • Alapértelmezett érték definiálása vagy érték másolása egy mezőre
  • Listaválasztási listák definiálása
  • Feltételes értékek és szabályok hozzárendelése