Sdílet prostřednictvím


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:

  • clock: Kopíruje čas z systémové hodiny. Použije aktuální datum a čas jako hodnotu. Je vyžadováno žádné další atributy. Pro COPY a DEFAULT pravidla, hodnota je načtena z hodiny v místním počítači. Pro SERVERDEFAULT pravidla, hodnota je načtena z server clock v době potvrzení. Platné pouze pro pole data a času.

  • currentuser: Kopie jméno uživatele, který je přihlášen. Použijte krátký uživatelské jméno aktuálního uživatele jako hodnotu. Je vyžadováno žádné další atributy. Platný pouze u polí s řetězcem.

  • field: Zkopíruje hodnotu, která je definována pro field atribut, který určíte. Vyžaduje, aby field="abc" atributu. Ve výchozím nastavení Pokud zadaný "od" pole je prázdné, nic se provádí. field Atribut se používá pouze pro COPY a DEFAULT pravidla.

  • value: Zkopíruje hodnotu zadaného value atributu.

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