Použití pravidla pro pole pracovní položky
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, vymažte nebo omezit změny.Pravidla s podmíněného právními předpisy, můžete použít pole podle závislostech mezi hodnoty různých polí.Také můžete omezit, kdo může měnit pole nebo oboru pravidlo, které se vztahuje pouze na skupinu.
Všechny tyto prvky pravidlo lze definovat v rámci FIELD definice definici typu (ŽÁ) pracovní položky mohou některé omezení pro systémová pole.A, s výjimkou produktů HELPTEXT, můžete zadat tato pravidla můžete ovlivnit během přechodu pracovního postupu nebo jako podřízené prvky v rámci FIELD element (globální pracovního postupu).
.png "Pracovní položka sledování pravidla pole element XML")
Pole, omezující můžete definovat libovolnou kombinaci pravidla, jak je popsáno v tomto tématu.
Text nápovědy: Zadejte popis tlačítka textu v formuláře pracovních položek pro pole. Výběr seznamu: Zadejte rozevírací nabídce, nebo vyberte seznam povolených, navrhované nebo zakázané hodnoty. |
Přiřadit hodnotu pravidla: definovat runtime chování spouštění a omezení:
|
Pravidla podmíněného: Určete, kdy budou použity na sadu pravidel na nadřazené pole. Nastavit podmínky, na základě role uživatele: použít pravidla na základě kdo je vytvoření nebo úprava pracovní položku. Slouží k určení skupina tokeny: Zadejte doménu nebo rozsah skupiny pomocí správné tokenu. |
Jaká jsou pravidla lze použít na systémová pole? Jak lze zabránit chyby ověření na jméno osoby polí? Je k dispozici 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 pravidla vyhodnocena? Jejich pořadí je použito? Jaký vliv stisknutí klávesy položky ve formuláři pravidlo hodnocení? |
Jak mohu změnit pole Stav a důvod? Jak lze vytvořit pole obsahovat hodnotu, která je součtem těchto dvou ostatních polí? Pokud by definovat pravidla pro pole pomocí globální pracovního postupu? |
Pravidla pro pole jsou jedné součásti, je nutné přizpůsobením sledování pracovních položek.Další informace naleznete v tématu Přizpůsobení objektů pro sledování práce na podporu týmových procesů.
Informace o úpravy polí nebo přidání pravidla pro pole na soubor definice ŽÁ, naleznete v Úprava nebo přidání pole na podporu dotazů, sestav a pracovních postupů.
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í na formuláře pracovních položek.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í odůvodně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řekročí limit 255 znaků, naleznete v části Poskytnutí textu nápovědy, hypertextových odkazů nebo webového obsahu ve formuláři pracovní položky.
[!POZNÁMKA]
Přítomnost HELPTEXT přidá velikost dat uložených a může mít vliv na škálovatelnost.Používání Omezujte pokud podporují několika stovek týmové projekty v rámci jedné instance sady TFS, HELPTEXT pravidla.
Výběr seznamu pravidla
Výběr seznamu pravidla definují hodnoty, které může uživatel, nebo nelze vybrat 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žít for a not atributů použití nebo Ignorovat tato pravidlazaložená na který je upravíte pracovní položku.
Pravidlo |
Použití |
|---|---|
ALLOWEDVALUES |
Omezení hodnoty, které může uživatel podle zadané hodnoty. |
ALLOWEXISTINGVALUE |
Umožňuje pole, které chcete zachovat existující hodnotu, i když je již na rozevírací seznam.Toto pravidlo včetně doporučujeme 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, které udržuje pro týmový projekt nebo kolekce projektu. |
PROHIBITEDVALUES |
Zabrání přiřazený zadanými hodnotami.Pracovní položka nelze uložit, je-li toto pole obsahuje zakázané hodnoty. |
SUGGESTEDVALUES |
Definuje seznam hodnot, které můžete vybrat z uživatelů, ale nejsou omezeny 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 části Definování rozevíracích seznamů.
Přiřadit hodnotu pravidla
Přiřadíte hodnotu, kterou pravidla definují runtime chování spouštění a omezení, například zadání výchozí hodnoty, vymazání pole, vyžadující polí, která mají být definovány a další.Je možné použití nebo Ignorovat tato pravidla podle, který provádí změny pracovní položky pomocí for a not atributy.
Vymazat, nastavení výchozí, Kopírovat hodnotu nebo vynutit hodnoty, aby odpovídaly vzor
Tato pravidla podporu výchozí nastavení, kopírování hodnoty z jednoho pole nebo prosazování hodnotu pole pro vyhledání stanovené vzor.
Pravidlo |
Použití |
|---|---|
COPY |
Kopíruje zadanou hodnotu pole, když uživatel vytvoří nebo upraví pracovní položku. |
DEFAULT |
Určuje hodnotu pole, které je prázdný, když uživatel vytvoří nebo upraví pracovní položku.Pokud je pole již má hodnotu, DEFAULTpravidlo ignorováno. |
EMPTY |
Vymaže pole libovolnou hodnotu obsahuje a následně vytváří pole jen pro čtení, když uživatel uloží pracovní položku.Neměli byste používat EMPTY s READONLY. EMPTYpoužívá se především během přechod stavu zrušte polí, která se vztahují na stav, do kterého je položka přechod. |
MATCH |
Vynutí zápisy pole řetězce pro zajištění souladu určitý vzor znaků či čísel. |
SERVERDEFAULT |
Zkopíruje jméno aktuálního uživatele nebo hodnotu clock na serveru do pole, když uživatel uloží pracovní položku.Tato pole obvykle zobrazují jen pro čtení ve formuláři. |
Struktura syntaxe a příklady naleznete v tématu Definování výchozí hodnoty nebo zkopírování hodnoty do pole.
Vyžadovat, jen pro čtení a omezit hodnoty, které jsou přiřazeny pole
Tato pravidla stanovit omezení zadání nebo změnit hodnotu pole.
Pravidlo |
Použ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žka s hodnotou v daném poli, lze upravit již hodnotu. |
NOTSAMEAS |
Zabrání přiřazený stejnou hodnotu, která byla přiřazena jiná pole pole. |
READONLY |
Zabrání pole na všech měnit.Můžete použít toto pravidlo za určitých podmínek.Například po zavření pracovní položka má tak, aby pole jen pro čtení pro zachování dat pro účely generování sestav. Nepoužívejte READONLY s EMPTY element protože EMPTY také usnadňuje pole jen pro čtení.Pokud se můžete spojit tyto prvky, budou vyhledány nekonzistentní. Kromě toho můžete provést pole se zobrazí jen pro čtení z pomocí formuláře pracovní položka Control element ReadOnly atributu.Pole může být proveden zápis jinými klienty, nikoli však prostřednictvím formulář pracovní položky. |
REQUIRED |
Vyžaduje uživatele k zadání hodnoty pro pole.Uživatelé nelze uložit pracovní položky, dokud se přiřadili hodnoty všech požadovaných polí. |
Syntaxe strukturu, naleznete v části Referenční dokumentace všech elementů XML FIELD.
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ím VALIDUSER elementu, který chcete polí jméno osoby.Pokud zadáte tento prvek, znamená to, který uživatel či skupina uživatelů může být přiřazen jako hodnotu pro pole.Můžete nastavit tento prvek pro podporu volitelného group atribut, který vyžaduje, aby osoba, která je přiřazena pole musí být členem skupiny, který zadáte přímo či nepřímo.Ve výchozím nastavení mají všichni členové Team Foundation platné uživatele skupinu lze zadat do pole.
VALIDUSER Element 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žce zadáním uživatele nebo skupiny pro for nebo not atributy v uvedeném pořadí.
<VALIDUSER group="groupName" for="userName" not="userName" />
Můžete použít VALIDUSER pravidlo 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:
Aktivováno (System.ActivatedBy)
Přiřazená (System.AssignedTo)
Autorizovaná jako (System.AuthorizedAs)
Změněn uživatelem (System.ChangedBy)
Uzavřeno (System.ClosedBy)
Autor (System.CreatedBy)
Kromě systémová pole můžete vytvořit vlastní textové pole a použít jako pole s názvem osobě.Můžete také synchronizovat vlastní pole s názvem osoby se službou Active Directory (zadejte syncnamechanges="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á VALIDUSER pravidlo.
Pravidla podmíněného
Pravidla podmíněného umožňují určit při sadu pravidel, budou použity na nadřazené pole.Můžete také nastavit podmínky na základě jiného pole je přiřazena (nebo není přiřazen) zadané hodnotě nebo jiného pole změní (či nezmění).Můžete zahrnout rozevírací seznam a přiřadit hodnotu pravidla v rámci elementu pravidlo podmíněného.
Pravidlo |
Použití |
|---|---|
WHEN |
Určuje pravidla, která se vztahují na nadřazeného pole Přiřazeno jiného pole se zadanou hodnotou. |
WHENNOT |
Určuje pravidla, která mají být použity nadřazeného pole při jiného pole není přiřazen zadanou hodnotu. |
WHENCHANGED |
Určuje pravidla, která se vztahují na pole Nadřazený při změně hodnoty zadané pole. |
WHENNOTCHANGED |
Určuje pravidla při hodnotu zadaného pole nezmění použito pro nadřazeného pole. |
Můžete zadat více pravidel podmíněného za pole.Však můžete zadat pouze jedno pole řízení za pravidlo podmíněného.Nelze vnořit pravidla podmíněného.Struktura syntaxe a příklady naleznete v tématu Přiřazení podmíněných hodnot a pravidel.
Použití nebo Ignorovat pravidla založená na který je vytváření nebo úprava pracovní položky
Můžete provést výběr, seznam nebo přiřadit pravidlo hodnoty použít nebo nelze použít pro skupinu uživatelů pomocí for nebo not atributy.Rozsah pravidlo ke skupině.Chcete-li pravidlo zaměřená na více skupin, musíte vytvořit skupinu nadřazené sady TFS, která zahrnuje více skupin, které chcete použít.
Označit pole jako povinné pouze pro zadané skupině:
Použití pro použít pravidlo ke skupině.Tento příklad vyžaduje libovolný uživatel ve skupině nižší analytici dokončete druhý schvalovatele pole.
<FIELD name="Second Approver"> <REQUIRED for="Example1\Junior Analysts"/> </FIELD>Omezte úpravy pole skupiny uživatelů:
Použití není k vyloučení z pravidla.Tento příklad definuje pole Popis rozhodné jen pro čtení pro všechny tyto uživatele 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 kombinaci pro a není současně použít pravidlo na některé a nikoli pro ostatní uživatele.Tento příklad definuje závažností jako povinné pole uživatelé projektu členy skupiny, ale nikoli pro objekty ve skupině Administrátoři projektu.
<FIELD name="Severity"> <REQUIRED for="[Project]\Project Members" not="[Global]\Project Admins"/> </FIELD>Protože Deny přednost Allow, pokud je uživatel v skupin, prohlášení "není" by být vynucené i pole nebude vyžadováno.
Použít tokeny, které chcete referenční skupiny
Pokud pravidlo omezíte ke skupině, je třeba určit domény nebo rozsah skupiny.U některých hodnot můžete použít tokeny.
Jméno osoby pole může přijmout hodnoty, které odkazují uživatelů a skupin.Pole pro atributy a nevztahuje na skupiny.Při zadá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í skupině, která je definována pro týmový projekt.To by mohla odpovídat týmu, integrované sady TFS skupiny, 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ým je vytvořen TFS skupiny, který obsahuje členy týmu přiřazen.
Skupina projektu týmu:[Project]\Contributors
Skupina Windows přidány do týmového projektu:[Project]\ Triage Committee
Tip: můžete zobrazit seznam platné skupiny podle otevření stránky zabezpečení v rámci správy týmu Web Access (TWA).
Rozsah do kolekce projektu – [Název_kolekce]:
Použití [Název_kolekce] k odkazování celou kolekci TFS skupinu, například skupinu Správci kolekce projektu nebo skupinu uživatelů systému Windows můžete přidat do kolekce.Příklad:
<FIELD name="Title"> <READONLY for="[DefaultCollection]\Project Collection Valid Users"/> </FIELD>Obor k instanci serveru – [GLOBAL]:
Použití [GLOBAL] token odkazu na skupinu obor serveru TFS, například předdefinované skupiny nebo skupinu uživatelů systému Windows přidáte do skupiny na úrovni serveru.Příklad:
<FIELD name="Title"> <READONLY for="[Global]\Team Foundation Valid Users"/> </FIELD>Zadejte účet domény kvalifikovaný nebo skupiny:
Název účtu domény kvalifikovaný, jako jsou například databáze znázorněno v následujícím příkladu slouží k odkazování uživatel či skupina domény.Všimněte si, že některá pravidla podporují pouze skupiny a nechcete podpory odkazující uživatele domény.
<LISTITEM value="FABRIKAM\Christie Church’s Direct Reports"/>
Pomocí jedné z těchto tokeny musí být kvalifikovány všech uživatelů a skupin.Například následující kód XML není platná vzhledem k tomu, že ji nebude vyfiltrování zadané skupině s tokenem platný.
<FIELD name="Title">
<READONLY for="Dev Team"/>
</FIELD>
Dotazy a odpovědi
D: Jaká jsou pravidla lze použít na systémová pole?
O: pole systému mají systému.Název odkazovat na názvy, například System.Title a System.State.TFS omezuje přizpůsobení těchto polí, s výjimkou těchto případech:
HELPTEXTpravidlo lze přiřadit u všech polí.
READONLYpravidlo lze přiřadit k pole Stav a důvod.
Většinu pravidel lze přiřadit k názvu, přiřazeno, pole Popis nebo změnit pomocí systému.
O: jak vyhnete chyby ověření u polí jméno osoby
O: a vyhnout se tak chyby ověření, které by jinak dojít, pokud členy týmu zůstat a již registrována jako přispěvatele projektu, zahrnout ALLOWEXISTINGVALUE element pro pole Přiřazeno uživateli.
<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 zdrojového kódu, které jsou k dispozici v tomto projektu CodePlex: vlastní ovládací prvky pro sady TFS pracovní položka sledování.
D: Jak mohu změnit pole Stav a důvod?
O: stavu a důvod polí jsou definovány v části pracovní postup ŽÁ 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 konkrétní přechodu.Další informace naleznete v tématu Změna pracovního postupu pro typ pracovní položky.
D: kde platit pravidlo pro pole
O: když chcete pravidlo použít pro pole po celou dobu pracovní položky, zadejte ji v rámci FIELD definice.Například zůstane požadované pole, která je požadována pro chyby, které je nové a aktivní, dokud nezavřete této chyby.
Jinak zadejte pravidlo vyhodnocované pouze během změnu stavu.Tato pravidla jsou definovány v rámci WORKFLOW v oddílu STATE, REASON, nebo TRANSITION prvky.Všechna pravidla, s výjimkou HELPTEXT, je možné použít v rámci FIELD element (pracovní postup).
Pravidla pro pole jsou přidávat.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í typ pravidla 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
Stav specifické pravidla jsou zaměřeny na instanci pracovní položky, kdy v určitých stavu.Pravidlo specifické pro stav v situacích, kdy platí následující podmínky:
State field value == "MyState" && "MyField Value" != NULL
Přechod na konkrétní pravidla, která zadáte pro konkrétní přechodu jsou zaměřeny na pracovní položku, která probíhá určité přechod.Tato pravidla jsou uplatněna, pokud platí následující podmínky:
State field value == "ToState" &&
"Previous State Before Edit/New" == "FromState"
&& "MyField Value" != NULL
Důvod specifické pravidla, která zadáte z určitého důvodu jsou zaměřená na konkrétní důvod, proč konkrétní přechodu.Jejich zpracování 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 pravidla vyhodnocena?Jejich pořadí je použito?
O: pravidla jsou obvykle zpracovány v pořadí, ve kterém jsou uvedeny.Nicméně při použití WHEN*, DEFAULT, a COPY prvky, uplatnit 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 pravidla vyhodnocena není zcela deterministický.Tato část popisuje očekávané chování a interakce při použití WHEN*, DEFAULT, a COPY pravidla.
Následující postup, 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ů, týmu Web Access nebo Team Explorer Everywhere─ uživatel vytváří novou pracovní položku nebo upravuje existující pracovní položky.
Zadejte výchozí hodnoty pole.U všech polí žádné použít DEFAULT pravidla, která jsou mimo WHEN* pravidla.
Zkopíruje hodnoty pole.U všech polí žádné použít COPY pravidla, která jsou mimo WHEN* doložky.
U všech polí s WHEN pravidla, nejprve proveďte shody, DEFAULT a následně COPY pravidla v rámci.
U všech polí s WHENNOT pravidla, nejprve proveďte shody, DEFAULT a následně COPY pravidla v rámci.
Vždy zpracovává sady TFS WHEN pravidla před WHENNOT pravidla.
U všech polí, která mají jejich hodnoty změnil od kroku 1 a které obsahují WHENCHANGED pravidla, nejprve proveďte DEFAULT a následně COPY pravidla v rámci.
Povolit uživatelům začít upravovat.
Uživatel změní hodnotu pole a poté přesune vstup z pole.
Vyvolání jakékoli WHEN pravidla pro toto pole, které odpovídají novou hodnotu.
Vyvolání jakékoli WHENNOT pravidla pro toto pole, které odpovídají novou hodnotu.
Vyvolání jakékoli WHENCHANGED pravidla pro toto pole, které odpovídají novou hodnotu.
Vrátí možnost úprav uživateli.
Uživatel uloží změny do databáze.
U všech polí provádět SERVERDEFAULT operace, které jsou definovány pro pole buď přímo či nepřímo v části WHEN nebo WHENNOT pravidlo.
D: stisknutí klávesy položky ve formě vliv pravidlo hodnocení?
O: 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 situace může nastat neočekávaně vždy, když pravidlo nezbytná podmínek.
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 těchto dvou ostatních polí?
O: tato funkce není v současné době nativně podporovány.
D: Pokud by definovat pravidla pro pole pomocí globální pracovního postupu?
O: použití globální pracovního postupu pouze v případě, že jsou úkol správu mnoho 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ématu Přizpůsobení globálního pracovního postupu.
Viz také
Koncepty
Referenční dokumentace všech elementů XML WITD
Další zdroje
Úprava nebo přidání pole na podporu dotazů, sestav a pracovních postupů