Udostępnij za pośrednictwem


Zdefiniuj wartość domyślną lub skopiuj wartość do pola

Można określić wartość domyślną dla pola lub możesz skopiować wartości z innego pola lub wartości zdefiniowanej przez system. Pole wartości domyślne to reguły określające sposób automatycznego przypisywania wartości pola. Można przypisać domyślne pola przy użyciu jednego z następujących elementów: COPY, DEFAULT, i SERVERDEFAULT. Te elementy można określić jako elementy podrzędne FIELD elementu (definicja) lub FIELD elementu (przepływu pracy).

Definicja typu elementu roboczego (ZEZWÓ) dodanie tych elementów. Aby dowiedzieć się więcej, zobacz Modyfikowanie lub dodawanie dostosowanego typu elementu pracy.

COPY i DEFAULT elementy wypełnić wartości w momencie rozpoczęcia edycji, ale SERVERDEFAULT reguła wypełnia wartość, gdy element roboczy jest zaangażowana w bazie danych. Ta akcja występuje, gdy użytkownik zapisuje zmiany do elementu pracy, a użytkownik nie można zastąpić wartości. Takie pola zazwyczaj są wyświetlane jako tylko do odczytu w formularzu elementu pracy. SERVERDEFAULT Reguła jest używana w przypadku pól, takich jak "Ostatnio zmieniona przez" i "Ostatni zmieniła się na" do obsługi bezpiecznego audytu.

Składnia

Można użyć COPY, DEFAULT, i SERVERDEFAULT elementy, z którego są kopiowane wartości z jednego pola do drugiego, skopiuj serwera wartość w polu lub określ wartość domyślną, aby zdefiniować dla pola.

Uwaga

Jeśli element roboczy został zmieniony, COPY lub DEFAULT zasada elementów może wybrać bieżącego lub poprzedniego wartość w polu źródła.

  • Można określić wartość można skopiować z innego pola, wartość zegara lub nazwa bieżącego użytkownika. W przypadku określenia value lub field dla from atrybutu, należy określić value lub field atrybutu. Gdy użytkownik zmieni lub tworzy element roboczy, COPY reguła wypełnia wartość pola bez względu na każdą wartość, która jest już w tym polu.

    <COPY for="userGroupName" not="userGroupName"  from="value | field | clock | currentuser" value="valueToCopy" field="fieldReferenceName/>
    
  • Można określić wartość domyślną dla pola przy użyciu DEFAULT reguły. Gdy użytkownik tworzy lub edytuje element pracy DEFAULT reguła wypełnia wartość, jeśli to pole jest puste. Można określić wartość można skopiować z innego pola, daty i godziny sygnatury, który rekordów zegara serwera lub nazwa bieżącego użytkownika. Jeśli pole ma już wartość, ta zasada jest ignorowana.

    <DEFAULT for="userGroupName" not="userGroupName" from="value | field | clock | currentuser" value="defaultValue" field="fieldReferenceName" />
    
  • Można określić wartość do skopiowania z serwera do pola podczas zapisywania elementu pracy. Gdy użytkownik zmienia stan elementu pracy SERVERDEFAULT zasada określenie wartości można skopiować do bieżącego pola z wartość, która jest tworzony na podstawie składnika serwera. DEFAULT i COPY elementy wypełnić wartości, gdy użytkownik otworzy elementem pracy, aby zmodyfikować, ale SERVERDEFAULT reguła wypełnia wartość, gdy element roboczy jest zaangażowana w bazie danych. Ta akcja występuje, gdy użytkownik zapisuje element pracy. Użytkownik nie może zastąpić wartość. Te pola zazwyczaj są wyświetlane jako tylko do odczytu w formularzu. SERVERDEFAULT Reguła jest używana w przypadku pól, takich jak "Ostatnio zmieniona przez" i "Ostatni zmieniła się na" do obsługi bezpiecznego audytu.

    <SERVERDEFAULT for="userGroupName" not="userGroupName" from="clock | currentuser" />
    

Każdy z tych elementów reguły określa from= "fromType" atrybut, który identyfikuje źródło wartości. W zależności od fromType wartości, może być wymagane dodatkowe atrybuty. W poniższej tabeli opisano wszystkie atrybuty który COPY, DEFAULT, i SERVERDEFAULT reguły odwołania elementów.

Atrybut

Opis

for

Parametr opcjonalny. Określa nazwę użytkownika lub grupy w Team Foundation do której jest stosowana reguła. Prawidłowe nazwy składają się z ciągu tekstowego, który zawiera od 1 do 255 znaków.

Wartość do wzorca: ^ [^ \\] + \\ [^ \\] + $

Przykład wartość wzorzec: domeny\UserID

not

Parametr opcjonalny. Określa nazwę użytkownika lub grupy w Team Foundation do kogo zasadę nie ma zastosowania. Prawidłowe nazwy składają się z ciągu tekstowego, który zawiera od 1 do 255 znaków.

Wartość do wzorca: ^ [^ \\] + \\ [^ \\] + $

Przykład wartość wzorzec: domeny\UserID

from

Parametr wymagany. Określa, czy można skopiować wartość domyślną z value atrybutu, field atrybutu, zegara systemowego lub bieżącego użytkownika. W przypadku określenia value lub field dla from atrybutu, należy określić value lub field atrybutu odpowiednio. Można określić następujące wartości:

  • clock: Kopiuje czas z zegara systemowego. Używa bieżącą datę i godzinę jako wartość. Żadne dodatkowe atrybuty są wymagane. Dla COPY i DEFAULT zasady, wartość jest pobierana z zegara komputera lokalnego. Dla SERVERDEFAULT reguły, wartość jest pobierana z zegara serwer w momencie zatwierdzania. Prawidłowy tylko w przypadku pól daty i godziny.

  • currentuser: Kopiuje nazwa zalogowanego użytkownika. Użyj krótką nazwę bieżącego użytkownika jako wartość. Żadne dodatkowe atrybuty są wymagane. Prawidłowy tylko w przypadku pól ciągów.

  • field: Kopiuje wartość, która jest zdefiniowana dla field atrybut, który określisz. Wymaga field="abc" atrybutu. Domyślnie jeśli określony "od" pole jest puste, nic nie jest wykonywane. field Atrybut jest używany tylko w przypadku COPY i DEFAULT reguł.

  • value: Kopiuje wartość z określonym value atrybutu.

value

Parametr opcjonalny. Określa wartość do skopiowania na pole po value jest określone dla from atrybutu. Prawidłowe wartości składają się z ciągu tekstowego, który zawiera od 1 do 255 znaków.

Wartość do skopiowania może być pusta.

field

Parametr opcjonalny. Określa nazwę pola, którego wartość ma na celu skopiowane do pola po field jest określone dla from atrybutu. Jeśli musisz zdefiniować ten atrybut from ma atrybut "pola" jako jego wartość.

Nazwa odwołania pola do skopiowania. Nazwa odwołania musi odpowiadać nazwie odwołania, zgodnie z definicją w FIELD elementu (definicja). Aby uzyskać więcej informacji, zobacz Element FIELD (Definition) — Odwołanie.

Wartość do wzorca: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [ a-zA-Z0-9_] +) + $

Wzorzec wartość przykład: Company.Division.IssueType

Powrót do początku

Definiowanie wartości domyślnej

Poniższy przykład przedstawia P3, domyślnie dla pola priorytetu.

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

Usuń zaznaczenie pola automatycznie

W poniższym przykładzie jest zaznaczone pole Stan.

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

Zapisz wartość pola

W poniższym przykładzie nazwa użytkownika, który zmienił elementu pracy najbardziej ostatnio są zapisywane.

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

Określ zegara jako domyślny

W poniższym przykładzie bieżąca data jest używana wartość pola, ale użytkownicy mogą zmienić tę wartość.

<FIELD refname="MyCorp.FoundOn" name="Found On" type="DateTime">
    <HELPTEXT>Defines when a bug was found.</HELPTEXT>
    <DEFAULT from="clock" />
</FIELD>

Uwaga

Wartości, które zawierają apostrofu, takich jak "Nie do naprawienia" należy użyć znaki cudzysłowu w kodzie XML, jak w poniższym przykładzie przedstawiono:

<LISTITEM value="Won’t Fix"/>

Zobacz też

Koncepcje

Wszystkie elementy XML All FIELD — Odwołanie

Inne zasoby

Zastosowanie reguły do pola elementu roboczego

Modyfikowanie lub dodawanie pola do obsługi zapytań, raportów i przepływu pracy