Define a default value or copy a value to a field
Můžete zadat výchozí hodnotu pro pole, nebo můžete zkopírovat hodnotu z jiného pole nebo hodnota definovaná systémem. Výchozí hodnoty pole jsou pravidla, která řídí, jak jsou automaticky přiřazeny hodnoty polí. Výchozí pole můžete přiřadit pomocí jednoho z následujících elementů: COPY, DEFAULT, a SERVERDEFAULT. Tyto prvky můžete určit jako podřízené prvky FIELD element (definice) nebo na FIELD element (pracovní postup).
Tyto prvky přidat do definice pro typ pracovní položky (ŽÁ). Další informace naleznete v tématu Úprava nebo přidání vlastního typu pracovní položky (WIT).
COPY a DEFAULT elementů vyplňte hodnoty na začátku úpravy, ale SERVERDEFAULT pravidlo vyplní hodnotu, pokud byla pracovní položka je potvrzené do databáze. Tato akce nastane, když uživatel uloží změny k pracovní položce a uživatel nemůže přepsat hodnotu. Taková pole se obvykle vyskytují jen pro čtení ve formuláři pracovní položky. SERVERDEFAULT Pravidlo se používá pro pole, jako je například "Poslední změnit podle" a "Naposledy změněno na" pro podporu zabezpečeného auditovat stopy.
Syntaxe
Můžete použít COPY, DEFAULT, a SERVERDEFAULT elementů ke kopírování hodnoty z jednoho pole do druhého, Kopírovat hodnotu serveru do pole nebo zadejte výchozí hodnotu, aby byla definována pro pole.
Poznámka
Jestliže se změnil pracovní položka COPY nebo DEFAULT elementy pravidlo může vybrat aktuální nebo předchozí hodnotu z pole zdroje.
Můžete zadat hodnotu zkopírovat z jiného pole, hodnota hodin nebo název aktuálního uživatele. Pokud zadáte v poli value nebo field pro from atributu, je třeba zadat value nebo field atributu. Když uživatel změní nebo vytváří pracovní položku COPY pravidlo vyplní hodnotu pole bez ohledu na libovolné hodnoty, která je již v tomto poli.
<COPY for="userGroupName" not="userGroupName" from="value | field | clock | currentuser" value="valueToCopy" field="fieldReferenceName/>
Pomocí můžete zadat výchozí hodnotu pro pole DEFAULT pravidlo. Když uživatel vytvoří nebo upraví pracovní položka DEFAULT pravidlo vyplní hodnotu, pokud je toto pole prázdné. Můžete určit hodnotu zkopírovat z jiného pole, datum a čas razítka, který záznamy clock serveru nebo název aktuálního uživatele. Pokud pole již má hodnotu, toto pravidlo je ignorován.
<DEFAULT for="userGroupName" not="userGroupName" from="value | field | clock | currentuser" value="defaultValue" field="fieldReferenceName" />
Můžete zadat hodnotu ke zkopírování ze serveru do pole, když je uložen s pracovní položkou. Jestliže uživatel změní stav pracovní položky SERVERDEFAULT pravidlo určuje hodnotu, která zkopírovat do aktuální pole z hodnotu, která je odvozena ze součásti serveru. DEFAULT a COPY elementů vyplnit hodnoty, když uživatel otevře pracovní položky můžete upravit, ale SERVERDEFAULT pravidlo vyplní hodnotu, pokud byla pracovní položka je potvrzené do databáze. Tato akce k tomuto dojde, když uživatel uloží pracovní položku. Uživatel nemůže přepsat hodnotu. Tato pole se obvykle vyskytují jen pro čtení ve formuláři. SERVERDEFAULT Pravidlo se používá pro pole, jako je například "Poslední změnit podle" a "Naposledy změněno na" pro podporu zabezpečeného auditovat stopy.
<SERVERDEFAULT for="userGroupName" not="userGroupName" from="clock | currentuser" />
Každý z těchto elementů pravidlo určuje from= "fromType" atribut, který identifikuje zdroj hodnoty. V závislosti na fromType hodnotu, další atributy může být vyžadováno. V následující tabulce jsou uvedeny všechny atributy, COPY, DEFAULT, a SERVERDEFAULT pravidla elementů odkazu.
Atribut |
Popis |
---|---|
for |
Volitelné. Určuje název uživatele nebo skupinu v Team Foundation do kterého bude pravidlo použito. Platný název se skládá z řetězce text, který obsahuje mezi 1 až 255 znaků. Hodnota vzorku: ^ [^ \\] + \\ [^ \\] + $ Příklad hodnoty vzor: domény/UserID |
not |
Volitelné. Určuje název uživatele nebo skupinu v Team Foundation na kterému pravidlo nevztahuje. Platný název se skládá z řetězce text, který obsahuje mezi 1 až 255 znaků. Hodnota vzorku: ^ [^ \\] + \\ [^ \\] + $ Příklad hodnoty vzor: domény/UserID |
from |
Požadováno. Určuje, zda se má kopírovat výchozí hodnota z value atribut, field atributu, systémových hodin nebo aktuálního uživatele. Pokud zadáte v poli value nebo field pro from atributu, je třeba zadat value nebo field atribut v uvedeném pořadí. Můžete zadat následující hodnoty:
|
value |
Volitelné. Určuje hodnota, kterou chcete zkopírovat do pole při value je určena pro from atributu. Platné hodnoty jsou tvořeny řetězec textu, který obsahuje mezi 1 až 255 znaků. Hodnota, kterou chcete zkopírovat může být prázdný. |
field |
Volitelné. Určuje název pole, jehož hodnota je zkopírovat do pole při field je určena pro from atributu. Pokud je třeba definovat tento atribut from atribut má "pole" jako hodnotu. Odkaz na název pole, které chcete kopírovat. Název odkazu musí odpovídat názvu referenční informace, jak jsou definovány v FIELD element (definice). Další informace naleznete v tématu FIELD (Definition) element reference. Hodnota vzorku: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [ -zA-Z0-9_] +) + $ Příklad hodnoty vzor: Company.Division.IssueType |
Zpět na začátek
Definovat výchozí hodnotu
Následující příklad ilustruje P3 jako výchozí pro pole Priorita.
<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>
Zrušte zaškrtnutí políčka pole automaticky
V následujícím příkladu je pole Stav zrušeno.
<FIELD refname="MyCorp.Status" name="Status" type="String">
<COPY from="value" value="" />
</FIELD>
Uložit hodnotu pole
V následujícím příkladu je uložen na jméno uživatele, který nedávno změnil pracovní položku.
<FIELD refname="System.Last Changed By" name="Last Changed By" type="String">
<HELPTEXT>The name of the user who most recently modified this bug</HELPTEXT>
<VALIDUSER group="[Project]\MyProjectMembers" />
<SERVERDEFAULT from="currentuser" />
</FIELD>
Zadejte hodiny jako výchozí
V následujícím příkladu hodnota pole používá aktuální datum, ale uživatelé mohou změnit tuto hodnotu.
<FIELD refname="MyCorp.FoundOn" name="Found On" type="DateTime">
<HELPTEXT>Defines when a bug was found.</HELPTEXT>
<DEFAULT from="clock" />
</FIELD>
Poznámka
Pro hodnoty, které obsahují apostrof, jako je například "Není možné opravit" musí používat dvojité uvozovky v souboru XML, jako ukazuje následující příklad:
<LISTITEM value="Won’t Fix"/>
Viz také
Koncepty
All FIELD XML elements reference
Další zdroje
Použití pravidla pro pole pracovní položky
Modify or add a field to support queries, reports, and workflow