Definir um valor padrão ou copiar um valor para um campo

Você pode especificar um valor padrão para um campo, ou você pode copiar o valor de outro campo ou um valor definido pelo sistema. Padrões de campo são regras que controlam como os valores de campo são atribuídos automaticamente. Você pode atribuir um padrão de campo usando um dos seguintes elementos: COPY, DEFAULT, e SERVERDEFAULT. Você pode especificar esses elementos como elementos filhos do FIELD elemento (definição) ou o FIELD elemento (fluxo de trabalho).

Você pode adicionar esses elementos para a definição de um tipo de item de trabalho (WIT). Para saber mais, consulte Modificar ou adicionar um WIT (tipo de item de trabalho) personalizado.

O COPY e DEFAULT elementos preenchem valores no início da edição, mas o SERVERDEFAULT regra preenche um valor quando o item de trabalho é confirmado no banco de dados. Essa ação ocorre quando um usuário salva alterações em um item de trabalho, e o usuário não pode substituir o valor. Normalmente, esses campos aparecem como somente leitura no formulário de item de trabalho. O SERVERDEFAULT regra é usada para campos como "Último alterado por" e "Último alterado em" para dar suporte seguro trilhas de auditoria.

Sintaxe

Você pode usar o COPY, DEFAULT, e SERVERDEFAULT elementos para copiar um valor de um campo para outro, copie o valor de um servidor em um campo ou especificar um valor padrão a ser definida para um campo.

Dica

Se o item de trabalho está sendo alterado, a COPY ou DEFAULT regra elementos pode selecionar o valor atual ou anterior do campo de origem.

• Você pode especificar um valor para copiar de outro campo, o valor do relógio ou o nome do usuário atual. Se você especificar value ou field para o from atributo, você deve especificar o value ou field atributo. Quando um usuário altera ou cria um item de trabalho, o COPY regra preenche um valor de campo, independentemente de qualquer valor que já está no campo.

  <COPY for="userGroupName" not="userGroupName"  from="value | field | clock | currentuser" value="valueToCopy" field="fieldReferenceName/>
  

• Você pode especificar um valor padrão para um campo usando o DEFAULT regra. Quando um usuário cria ou edita um item de trabalho, o DEFAULT regra preenche um valor se esse campo estiver vazio. Você pode especificar um valor para copiar de outro campo, carimbo de data e hora que os registros de relógio do servidor ou o nome do usuário atual. Se um campo já tiver um valor, essa regra será ignorada.

  <DEFAULT for="userGroupName" not="userGroupName" from="value | field | clock | currentuser" value="defaultValue" field="fieldReferenceName" />
  

• Você pode especificar um valor para copiar do servidor em um campo quando o item de trabalho é salvo. Quando um usuário altera o estado de um item de trabalho, o SERVERDEFAULT regra especifica um valor a ser copiado para o campo atual de um valor que é derivado de um componente de servidor. O DEFAULT e COPY elementos preencher valores quando um usuário abre um item de trabalho para modificá-lo, mas o SERVERDEFAULT regra preenche um valor quando o item de trabalho é confirmado no banco de dados. Essa ação ocorre quando o usuário salva o item de trabalho. O usuário não pode substituir o valor. Normalmente, esses campos aparecem como somente leitura no formulário. O SERVERDEFAULT regra é usada para campos como "Último alterado por" e "Último alterado em" para dar suporte seguro trilhas de auditoria.

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

Cada um desses elementos de regra especifica uma from= "fromType" que identifica a origem do valor do atributo. Dependendo do fromType valor, os atributos adicionais podem ser necessários. A tabela a seguir descreve todos os atributos que o COPY, DEFAULT, e SERVERDEFAULT referências de elementos de regra.

Atributo	Descrição
for	Opcional. Especifica o nome de um usuário ou grupo no Team Foundation aos quais a regra se aplica. Os nomes válidos consistem em uma cadeia de caracteres de texto que contenha entre 1 e 255 caracteres. Valor do padrão: ^ [^ \ \] + \ \ [^ \ \] + $ Exemplo de valor padrão: domínio\UserID
not	Opcional. Especifica o nome de um usuário ou grupo no Team Foundation para quem a regra não se aplica. Os nomes válidos consistem em uma cadeia de caracteres de texto que contenha entre 1 e 255 caracteres. Valor do padrão: ^ [^ \ \] + \ \ [^ \ \] + $ Exemplo de valor padrão: domínio\UserID
from	Obrigatório. Especifica se deve copiar o valor padrão do value atributo, o field atributo, o relógio do sistema ou o usuário atual. Se você especificar value ou field para o from atributo, você deve especificar o value ou field atributo, respectivamente. Você pode especificar os seguintes valores: clock: Copia a hora do relógio do sistema. Usa a data atual e a hora como o valor. Não há atributos adicionais são necessários. Para o COPY e DEFAULT de regras, o valor é obtido do relógio do computador local. Para o SERVERDEFAULT regra, o valor é obtido do relógio do servidor no momento da confirmação. Válido somente para campos de data e hora. currentuser: Nome cópias do usuário que fizer logon. Use o nome curto do usuário atual como o valor. Não há atributos adicionais são necessários. Válido somente para campos de cadeia de caracteres. field: Copia o valor definido para o field atributo que você especificar. Requer um field="abc" atributo. Por padrão, se especificado "de" campo estiver vazio, nada é executado. O field atributo é usado somente para o COPY e DEFAULT regras. value: Copia o valor especificado value atributo.
value	Opcional. Especifica o valor a ser copiado para o campo quando value for especificado para o from atributo. Os valores válidos consistem em uma cadeia de caracteres de texto que contenha entre 1 e 255 caracteres. O valor para copiar pode estar vazio.
field	Opcional. Especifica o nome do campo cujo valor deve ser copiado para o campo quando field for especificado para o from atributo. Você deve definir esse atributo, se o from atributo tem "campo" como seu valor. O nome de referência do campo para copiar. O nome de referência deve corresponder ao nome de referência, conforme definido no FIELD elemento (definição). Para obter mais informações, consulte Referência de elemento FIELD (definição). Valor do padrão: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [a-zA-Z0-9 _] +) + $ Exemplo de valor padrão: Company.Division.IssueType

Voltar ao início

Definir um valor padrão

O exemplo a seguir define P3 como padrão para o campo de prioridade.

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

Limpar um campo automaticamente

No exemplo a seguir, o campo status está desmarcado.

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

Salvar um valor de campo

No exemplo a seguir, o nome do usuário que alterou um item de trabalho mais recentemente será salvo.

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

Especifique o relógio como padrão

No exemplo a seguir, o valor de um campo usa a data atual, mas os usuários podem alterar esse valor.

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

Dica

Para valores que contenham um apóstrofo, como "Não serão corrigidos", você deve usar aspas duplas em XML, como mostra o exemplo a seguir:

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

Consulte também

Conceitos

Todas as referências de elementos XML FIELD

Outros recursos

Aplicar uma regra a um campo do item de trabalho

Definir campos de item de trabalho