Použití pravidla pro pole pracovní položky

Článek
09/11/2015

V závislosti na typu dat pole můžete nastavit různé omezení na jaká data lze zadat do tohoto pole. Můžete určit hodnoty pro rozevírací seznam (rozevírací nabídka), nastavení výchozích hodnot, zrušte zaškrtnutí položky nebo omezit změny. S podmíněné právními předpisy můžete použít pravidla pro pole založenou na závislosti mezi hodnotami různých polí. Také můžete omezit, kdo může měnit pole nebo oboru pravidlo, které platí pouze pro skupiny.

Všechny tyto prvky pravidlo může být definován v rámciFIELDdefinici pracovní položky typu (s inst) v definici, mohou některéomezení pro systémová pole. A, s výjimkou produktůHELPTEXTmůžete zadat tato pravidla, která se má provést mít vliv na během přechodu pracovního postupu nebo jako podřízené prvky v rámciFIELDelement (globální pracovního postupu).

Work item tracking XML element field rules

Pole, omezující můžete definovat libovolnou kombinaci pravidla, jak je popsáno v tomto tématu.

Text nápovědy: Zadejte tip nástroje textu v formuláře pracovních položek pro pole.

Rozevírací seznam: Zadejte rozevírací nabídky nebo vyberte seznam povolených, navrhované nebo zakázané hodnoty.

Přiřadit hodnotu pravidla: definovat runtime chování spouštění a omezení:

Vymazat, nastavit výchozí, kopírování hodnoty nebo vynutit hodnoty, aby odpovídaly maskou
Vyžadovat, jen pro čtení a omezit hodnoty přiřazené k poli
Omezení, který můžete vytvořit nebo upravit pracovní položky

Pravidla podmíněného: Určete, kdy budou použity sadu pravidel na nadřazeného pole.

Nastavit podmínky, na základě role uživatele: použití pravidel na základě kdo je vytvoření nebo úprava pracovní položku.

Použití tokenů k zadání skupiny: Zadejte doménu nebo rozsah skupiny pomocí tokenu doprava.

Jaká jsou pravidla lze použít k polím systému?

Jak lze zabránit chyby ověření u polí jméno osoby?

Existuje způsob, jak definovat vícenásobného výběru rozevírací seznam?

Pokud by měl použít pravidlo pro pole?

Jakým způsobem jsou vyhodnoceny pravidla? Jakém pořadí se použije?

Stisknutí klávesy položky ve formě vliv pravidlo hodnocení?

Jak mohu změnit pole Stav a důvod?

Jak lze vytvořit pole obsahovat hodnotu, která je součtem dvě další pole?

Pokud by definovat pomocí pracovních postupů v globální pravidla pro pole?

Pravidla pro pole jsou jedné součásti, je nutné přizpůsobením sledování pracovních položek. Další informace naleznete v tématuPřizpůsobení objektů pro sledování práce na podporu týmových procesů.

Informace o úpravu pole nebo přidání pravidla pro pole na soubor definice ŽÁ, naleznete vModify or add a field to support queries, reports, and workflow.

Text nápovědy

Můžete upravit text nápovědy nebo text popisu tlačítka, která se zobrazí při umístění ukazatele na pole, které se zobrazí ve formuláři pracovní položku. Můžete přizpůsobit a lokalizovat text nápovědy pro stejné pole, které se zobrazí v různých WITs a jiné týmové projekty. Text nápovědy je omezen na 255 znaků Unicode.

Následující příklad ukazuje přiřazení text nápovědy k vlastnímu poli obchodního oprávnění:

<FIELD name=”Business Justification” refname="Fabrikam.BusinessJustification" type="String">
<HELPTEXT>Only required when you set the Urgencyfield to Need Immediately. </HELPTEXT>
</FIELD>

Chcete-li uživatelům poskytnout pokyny, které překračuje limit 255 znaků, naleznete v částiProvide help text, hyperlinks, or web content on a work item form.

Poznámka

PřítomnostHELPTEXTpřidá na velikost dat uložených a může ovlivnit škálovatelnost.Používání Omezujte pokud podporují několika stovek týmové projekty v rámci jedné instance sady TFS,HELPTEXTpravidla.

Vyberte seznam pravidla

Výběr seznamu pravidla definují hodnoty, které může uživatel nebo nelze vybrat pro pole řetězce. Hodnoty definované v rozevírací seznam se objeví na formuláře pracovních položek a editor dotazů. Umožňuje sloučit seznamy a rozbalit nebo sbalit seznamy. Můžete také použítforanotatributůpoužití nebo Ignorovat tato pravidlazaložená na který je úprava pracovní položku.

Pravidlo	Využití
ALLOWEDVALUES	Omezení hodnoty, které může uživatel vybrat podle zadané hodnoty.
ALLOWEXISTINGVALUE	Umožňuje pole, které chcete zachovat existující hodnotu, i když je již v seznamu výběr. Toto pravidlo včetně je vhodné při změně hodnoty pole v seznamu Výběr nebo pro seznamů pro výběr, které obsahují jméno osoby.
GLOBALLIST	Určuje název globální seznam, který obsahuje hodnoty udržovat pro týmový projekt nebo kolekce projektu.
PROHIBITEDVALUES	Brání přiřazeny zadanými hodnotami. Pracovní položku nelze uložit, je-li toto pole obsahuje zakázané hodnoty.
SUGGESTEDVALUES	Definuje seznam hodnot, které můžete vybrat z uživatelů, ale není omezen na výběr. Uživatelé mohou určit hodnoty, které nejsou uvedeny v tomto seznamu.

Příklady použití výběr seznamy, naleznete v tématuDefine pick lists.

Přiřadit hodnotu pravidla

Přiřadíte hodnotu, kterou pravidla definují runtime chování spouštění a omezení, jako je například určení výchozí hodnoty, vymažte obsah polí, že vyžaduje, aby polí, která mají být definován a další. Je možnépoužití nebo Ignorovat tato pravidlapodle, který provádí změny v pracovní položky pomocíforanotatributy.

Vymazat, nastavit výchozí, kopírování hodnoty nebo vynutit hodnoty, aby odpovídaly maskou

Tato pravidla podporu výchozí nastavení, kopírování hodnoty z jednoho pole, nebo vynucování hodnotu pole pro vyhledání předepsanou vzor.

Pravidlo	Využití
COPY	Kopíruje zadanou hodnotu do pole když uživatel vytvoří nebo upraví pracovní položku.
DEFAULT	Určuje hodnotu pro pole, které je prázdný, když uživatel vytvoří nebo upraví pracovní položku. Pokud pole již má hodnotu,DEFAULTpravidlo ignorováno.
EMPTY	Vymaže pole Libovolná hodnota obsahuje a následně vytváří pole jen pro čtení, když uživatel uloží pracovní položku. Neměli byste používatEMPTYsREADONLY. EMPTYpoužívá se předevšímběhem přechod stavuzrušte pole, které se vztahují na stav, na kterou je přechod položky.
MATCH	Vynutí zápisy pole řetězce shodu seurčitý vzor znaků či čísel.
SERVERDEFAULT	Zkopíruje aktuální uživatelské jméno nebo hodnotu clock na serveru na pole, když uživatel uloží pracovní položku. Tato pole se obvykle vyskytují jen pro čtení ve formuláři.

Struktura syntaxe a příklady naleznete v tématuDefine a default value or copy a value to a field.

Vyžadovat, jen pro čtení a omezit hodnoty přiřazené k poli

Tato pravidla určit omezení na zadání nebo změna hodnoty pole.

Pravidlo	Využití
CANNOTLOSEVALUE	Zabraňuje uživatelům pole hodnoty poté, co byla zadána hodnota.
FROZEN	Zabrání uživatelům změnit hodnotu pole, poté, co obsahuje hodnotu. Jakmile uživatel uloží pracovní položku s hodnotou v daném poli, lze upravit již hodnotu.
NOTSAMEAS	Brání pole nejsou přiřazeny stejnou hodnotu jako, který byl přiřazen k jiné pole.
READONLY	Brání upravován na všechna pole. Můžete chtít použít toto pravidlo za určitých podmínek. Například po zavření pracovní položky chcete provést pole jen pro čtení pro zachování dat pro účely generování sestav. NepoužívejteREADONLYsEMPTYelementu vzhledem k tomu,EMPTYtaké usnadňuje pole jen pro čtení. Pokud kombinujete tyto prvky, budou výsledky nekonzistentní. Kromě toho můžete provést na pole se zobrazí jen pro čtení z pomocí formuláře pracovní položkaControlelementReadOnlyatributu. Pole může být proveden zápis jinými klienty, nikoli však prostřednictvím formulář pracovní položky.
REQUIRED	Vyžaduje, aby uživatele k zadání hodnoty pro pole. Uživatele nelze uložit pracovní položky, dokud jejich přiřadili hodnoty všechna povinná pole.

Strukturu syntaxi naleznete v částiAll FIELD XML elements reference.

Omezení, který můžete vytvořit nebo upravit pracovní položky

Můžete určit, který můžete vytvořit nebo upravit pracovní položka použitímVALIDUSERelementu, který chcete pole jméno osoby. Pokud zadáte tento element, znamená to, který uživatel nebo skupina uživatelů, může být přiřazen jako hodnotu pro pole. Můžete nastavit tento element pro podporu volitelnéhogroupatribut, který vyžaduje, aby osoba, která je přiřazena k poli musí být členem skupiny, který zadáte přímý nebo nepřímý. Ve výchozím nastavení mají všichni členovéTeam Foundation platné uživateleskupinu lze zadat do pole.

VALIDUSERElement je platný pouze pro typy pole řetězců. Je možnéPovolit nebo zakázat, zda se pravidlo vztahuje na uživatele, který provádí změny v pracovní položcezadáním uživatele nebo skupiny profornebonotatributy v uvedeném pořadí.

<VALIDUSER group="groupName" for="userName" not="userName" />

Můžete použítVALIDUSERpravidla pouze v případě, že můžete odkazovat na pole jméno osoby. Tato systémová pole jsou příklady pole s názvem osoby:

Aktivoval (System.ActivatedBy)
Přiřazeno (System.AssignedTo)
Autorizovaná jako (System.AuthorizedAs)
Změněn uživatelem (System.ChangedBy)
Ukončená (System.ClosedBy)
Autor (System.CreatedBy)

Kromě systémová pole můžete vytvořit vlastní textové pole a použít jako pole s názvem osoby. Vlastní pole s názvem osoby také lze synchronizovat se službou Active Directory (zadejtesyncnamechanges="true").

Pole pracovních položek nerozlišují identity uživatelů v různých doménách. Proto "Fabrikam\ctsoapo" a "Contoso\ctsoapo" jsou považovány za stejný uživatel při jejich zadání do pole, které používáVALIDUSERpravidlo.

Podmíněné pravidla

Pravidla podmíněného umožňují zadat v případě, že budou použity sadu pravidel na nadřazeného pole. Můžete také nastavit podmínky, které jsou založeny na jiné pole je přiřazena (nebo nejsou přiřazeny) zadanou hodnotu, nebo když jiné pole změní (nebo nezmění). Můžete zahrnout rozevírací seznam a přiřadit hodnotu pravidla v rámci elementu pravidlo podmíněného.

Pravidlo	Využití
WHEN	Určuje pravidla, která má být použita pro nadřazeného pole, je-li jiné pole přiřazen zadanou hodnotu.
WHENNOT	Určuje pravidla, která má být použita pro nadřazeného pole, pokud jiné pole není přiřazen zadanou hodnotu.
WHENCHANGED	Určuje pravidla, která má být použita pro nadřazeného pole při změně hodnoty zadané pole.
WHENNOTCHANGED	Určuje pravidla, která má být použita pro nadřazeného pole, pokud hodnota zadaná pole se nezmění.

Můžete zadat více pravidel podmíněného za pole. Však lze zadat pouze jedno pole řízení za pravidlo podmíněného. Pravidla podmíněného nelze vnořit. Struktura syntaxe a příklady naleznete v tématuAssign conditional-based values and rules.

Použití nebo Ignorovat pravidla založená na který je vytváření nebo úprava pracovní položky

Můžete provést výběr, seznamu nebo přiřadit pravidlo hodnoty použít nebo nelze použít u skupiny uživatelů s použitímfornebonotatributy. Rozsah pravidlo ke skupině. Chcete-li pravidlo zaměřená na více skupin, musí vytvořit skupinu nadřazené sady TFS, která zahrnuje sady skupin, které chcete použít.

Označit pole jako povinné pouze pro zadané skupině:

Použitípropoužít pravidlo ke skupině. V tomto příkladu vyžaduje, aby všechny uživatele ve skupině nižší analytici dokončete druhý schvalovatele pole.
```
<FIELD name="Second Approver">
<REQUIRED for="Example1\Junior Analysts"/>
</FIELD>
```
Omezte úpravy pole do skupiny uživatelů:

Použitíneník vyloučení z pravidla. Tento příklad definuje pole Popis rozhodné jen pro čtení pro všechny uživatele s výjimkou tito uživatelé ve skupině rozhodné výbor.
```
<FIELD name="Triage Description">
<READONLY not="[Project]\Triage Committee" />
</FIELD>
```
Označit pole jako povinné pro některé uživatele a nikoli pro ostatní uživatele:

Použijte kombinaciproanenísoučasně použít pravidlo na některé a nikoli pro ostatní uživatele. Tento příklad definuje závažnosti jako povinné pole pro uživatele ve skupině Členové projektu, ale nikoli pro objekty ve skupině Administrátoři projektu.
```
<FIELD name="Severity">
<REQUIRED for="[Project]\Project Members" not="[Global]\Project Admins"/>
</FIELD>
```
ProtožeDenypřednost předAllowpokud je uživatel v skupin, příkaz "Ne" by vynucována i by být požadovaná pole.

Použít tokeny, které chcete referenční skupiny

Pokud pravidlo omezíte ke skupině, je třeba určit doménu nebo rozsah skupiny. U některých hodnot můžete použít tokenů.

Jméno osoby pole může přijmout hodnoty, které odkazují na uživatelů a skupin. Pole pro atributy a nevztahuje na skupiny. Při určování hodnoty pro tyto položky, můžete použít následující tokeny.

Obor do týmového projektu – [projekt]:

[Project]Token slouží k určení skupiny, který je definován pro týmový projekt. To by mohla odpovídat týmu, předdefinované skupiny sady TFS, například skupina \Contributors [projekt], vlastní sady TFS skupiny, které vytvoříte na úrovni projektu nebo skupiny systému Windows, který jste přidali do skupiny sady TFS. Příklad:
- Tým:[Project]\Fabrikam Team
  
  Při vytváření týmu, je vytvořena skupina sady TFS, která obsahuje členy týmu přiřazen.
- Týmový projekt skupina:[Project]\Contributors
- Přidat do týmového projektu skupiny systému Windows:[Project]\ Triage Committee
**Tip:**můžete zobrazit seznam platný skupin podleotevírání stránce zabezpečenív kontextu správy Team Web Access (TWA).
Rozsah do kolekce projektu – [CollectionName]:

Použití [CollectionName] k odkazování vymezenou kolekce sady TFS skupinu, například skupinu Správci kolekce projektu nebo skupiny systému Windows můžete přidat do kolekce. Příklad:
```
<FIELD name="Title">
<READONLY for="[DefaultCollection]\Project Collection Valid Users"/>
</FIELD>
```
Rozsah k instanci serveru – [GLOBAL]:

Použití[GLOBAL]token odkazu na skupinu s oborem serveru TFS, jako je například předdefinované skupiny nebo skupiny systému Windows přidáte do skupiny úrovni serveru. Příklad:
```
<FIELD name="Title">
<READONLY for="[Global]\Team Foundation Valid Users"/>
</FIELD>
```
Zadejte účet domény kvalifikovány nebo skupina:

Název účtu domény kvalifikovaný, jako je ten, který je znázorněno v následujícím příkladu lze použít k odkazování uživatel či skupina domény. Všimněte si, že některá pravidla podporují pouze skupiny a provést není podpora odkazující uživatele domény.
```
<LISTITEM value="FABRIKAM\Christie Church’s Direct Reports"/>
```

Všichni uživatelé a skupiny musí být určen jedním z těchto tokenů. Například následující kód XML není platná vzhledem k tomu, že ji ještě vyfiltrování zadané skupině s platným tokenem.

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

Dotazy a odpovědi

D: Jaká jsou pravidla lze použít k polím systému?

**O:**systémová pole mít režim.Názevodkazovat na názvy, například System.Title a System.State. Sady TFS omezuje přizpůsobení z těchto polí, s výjimkou těchto případech:

HELPTEXTpravidlo lze přiřadit k všechna pole.
READONLYpravidlo lze přiřadit k polím stav a důvod.
Většinu pravidel lze přiřadit k polím Title, přiřazeno, popis nebo změnit pomocí systému.

D: jak vyhnete chyby ověření u polí jméno osoby

O:a vyhnout se tak chyby ověření, které by jinak dojít v případě členy zůstat týmu a jsou již není zaregistrován jako přispěvatelé projektu, zahrnoutALLOWEXISTINGVALUEelement pro pole Přiřazeno.

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

D: existuje způsob, jak definovat vícenásobného výběru rozevírací seznam?

**O:**tato funkce není podporována nativně, nicméně je možné přizpůsobit uvedené v tomto projektu webu CodePlex zdrojový kód: Vlastní ovládací prvky pro sady TFS sledování pracovních položek.

D: Jak mohu změnit pole Stav a důvod?

**O:**The stav a důvod pole jsou definována v rámci oddílu pracovního postupu s inst definice. Můžete zadat většina pole pravidla platná pro pole při změně stavu, výběr z důvodu nebo pro určité přechod. Další informace naleznete v tématuChange the workflow for a work item type.

D: kde by měl použít pravidlo pro pole?

O:když chcete, aby pravidlo, které se vztahují na pole po celou dobu životnosti pracovní položky, zadejte ji v rámciFIELDdefinice. Můžete například zůstane požadované pole, která je požadována pro chyby, které je nové a aktivní, dokud této chyby je uzavřen.

Jinak zadejte pravidlo, které se má vyhodnotit pouze během změnu stavu. Tato pravidla jsou definovány v rámciWORKFLOWv oddíluSTATEREASONneboTRANSITIONelementy. Všechna pravidla, s výjimkouHELPTEXTmohou být použity v rámciFIELDelement (pracovní postup).

Pravidla pro pole jsou přičítáním. To znamená můžete určit čtyři sady pravidel pro stejné pole, které se všechny vyhodnotí pravidlo-modul pracovní položku.

Pracovní položka konkrétní typpravidla platí bez ohledu na umístění pracovní položku v jeho stav modelu. Můžete například<REQUIRED />pravidlo provádí následující kontroly:

"MyField Value" != NULL
Specifické stavupravidla jsou zaměřeny na instanci pracovní položky, pokud je v určitých stavu. Pravidlo specifické pro stav v situacích, kdy je splněna následující podmínka:

State field value == "MyState" && "MyField Value" != NULL
Specifické pro přechodpravidla, která zadáte pro konkrétní přechod jsou zaměřeny na pracovní položky, které probíhá určité přechod. Tato pravidla jsou uplatněna, pokud jsou splněny následující podmínky:

State field value == "ToState" &&

"Previous State Before Edit/New" == "FromState"

&& "MyField Value" != NULL
Specifický důvodpravidla, která zadáte pro konkrétní důvod, proč jsou zaměřeny na konkrétní důvod, proč konkrétní přechod. Jsou zpracovávány při platí následující podmínky:

Reason field == "MyReason" &&

State field value == "ToState" &&

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

Následující příklad omezuje změně pole závažnosti zákazníka při pracovní položka je v aktivním stavu.

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

O: jak jsou vyhodnoceny pravidla?Jakém pořadí se použije?

**O:**pravidla jsou obvykle zpracovány v pořadí, ve kterém jsou uvedeny. Nicméně při použitíWHEN*DEFAULTaCOPYprvky, mohou vztahovat další chování.

Můžete získat představu, jak jsou pravidla vyhodnocena při použití více pravidel pro pole. Jakým způsobem jsou vyhodnoceny pravidla není úplně deterministický. Tato část popisuje očekávané chování a interakce při použitíWHEN*DEFAULTaCOPYpravidla.

Následující kroky ukazují ve správném pořadí, interakce, které provádí sady TFS a uživatel formulář pracovní položky. Uživatel se provádí pouze kroky 1, 8 a 13.

Z produktu Team Foundation client─such jako sady Visual Studio, Průzkumníka týmových projektů, Team Web Access nebo Průzkumníka Everywhere─ týmu uživatel vytváří novou pracovní položku nebo upravuje existující pracovní položky.
Vyplňte pole výchozí hodnoty. U všech polí, použijte jakékoliDEFAULTpravidla, která jsou mimo**WHEN***pravidla.
Zkopíruje hodnoty pole. U všech polí, použijte jakékoliCOPYpravidla, která jsou mimo**WHEN***klauzule.
U všech polí sWHENpravidla, nejprve proveďte shody,DEFAULTa následněCOPYpravidla v rámci.
U všech polí sWHENNOTpravidla, nejprve proveďte shody,DEFAULTa následněCOPYpravidla v rámci.

Vždy zpracovává sady TFSWHENpravidla předWHENNOTpravidla.
U všech polí, která mají jejich hodnoty změnil od kroku 1 a které obsahujíWHENCHANGEDpravidla, nejprve proveďteDEFAULTa následněCOPYpravidla v rámci.
Povolit uživatelům zahájit úpravy.
Uživatel změní hodnotu pole a poté přesune vstup z pole.
Vyvolání jakékoliWHENpravidla pro toto pole, které odpovídají na novou hodnotu.
Vyvolání jakékoliWHENNOTpravidla pro toto pole, které odpovídají na novou hodnotu.
Vyvolání jakékoliWHENCHANGEDpravidla pro toto pole, které odpovídají na novou hodnotu.
Vrátí možnost úprav uživateli.
Uživatel uloží změny do databáze.
U všech polí, provádětSERVERDEFAULToperace, které jsou definovány pro pole buď přímo nebo nepřímo v částiWHENneboWHENNOTpravidlo.

D: stisknutí klávesy položky ve formě vliv pravidlo hodnocení?

**O:**v systému nastaví novou hodnotu pro pole pokaždé, když uživatel stiskne v rámci pole prostřednictvím formulář pracovní položka uživatelského rozhraní. To znamená, že pravidlo podmíněného se nemůže vyskytovat neočekávaně vždy, když jsou splněny požadované podmínky pravidla.

V následujícím příkladu XML, bude vyprázdněn podřízeného stavu při psaní "Znovu schválen" do pole Stav vzhledem k tomu**WHEN***pravidlo dojde ihned poté, co uživatel zadá písmeno "e" schváleno, i v případě, že zamýšlené konečná hodnota není "Schválit". Z tohoto důvodu byste pečlivě při použití pravidla podmíněného.

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

O: jak lze vytvořit pole obsahovat hodnotu, která je součtem dvě další pole?

**O:**tato funkce není v současné době nativně podporovány.

D: Pokud by definovat pomocí pracovních postupů v globální pravidla pro pole?

**O:**použití globální pracovního postupu pouze v případě, že jsou úkol při zachování velký počet polí se stejným definice a pravidla více týmových projektů. Podobně jako globální seznamy, pomocí globální pracovního postupu můžete minimalizovat pracovní vyžadováno, pokud je třeba aktualizovat definice polí. Další informace naleznete v tématuCustomize global workflow.

Sdílet prostřednictvím