Definindo um valor padrão ou a cópia de um valor a um campo

Você pode especificar um valor padrão para um campo ou você pode copiar o valor de outro campo ou o 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, and SERVERDEFAULT. Você pode especificar esses elementos como elementos filhos da FIELD o elemento de (definição) ou o FIELD (fluxo de trabalho) de elemento.

O COPY e DEFAULT elementos preencher os valores no início da edição, mas o SERVERDEFAULT regra preenche um valor quando o item de trabalho está comprometido com o banco de dados. Essa ação ocorre quando um usuário salva as alterações para 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 "última alterado por" e "Alterado pela última vez em" para suportar as trilhas de auditoria segura.

Neste tópico

  • Estrutura de sintaxe para definir valores padrão

  • Definindo um valor padrão

  • Limpando automaticamente de um campo

  • Salvar um valor de campo

  • Especificando o relógio como um padrão.

Estrutura de sintaxe para definir valores padrão

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

ObservaçãoObservação

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

  • Você pode especificar um valor para copiar a partir 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 está já 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 a partir de outro campo, o 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 é 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 está comprometido com o 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 "última alterado por" e "Alterado pela última vez em" para suportar as trilhas de auditoria segura.

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

Cada um desses elementos de regra especifica um from= "fromType" atributo que identifica a fonte do valor. 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ência de elementos de regra.

Atributo

Descrição

for

Opcional. Especifica o nome de um usuário ou grupo na Team Foundation ao qual a regra se aplica. Nomes válidos consistem em uma seqüência de caracteres de texto que contenha entre 1 e 255 caracteres.

Valor padrão: ^[^\\]+\\[^\\]+$

Exemplo de valor padrão: Domínio\UserID

not

Opcional. Especifica o nome de um usuário ou grupo na Team Foundation para o qual a regra não se aplica. Nomes válidos consistem em uma seqüência de caracteres de texto que contenha entre 1 e 255 caracteres.

Valor padrão: ^[^\\]+\\[^\\]+$

Exemplo de valor padrão: Domínio\UserID

from

Obrigatório. Especifica se deve copiar o valor padrão a partir 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 de atributo, respectivamente. Você pode especificar os seguintes valores:

  • clock: Copia a hora do relógio do sistema. Usa a data e hora atuais, como o valor. Não há atributos adicionais são necessários. Para o COPY e DEFAULT regras, o valor é extraído do relógio do computador local. Para o SERVERDEFAULT regra, o valor é obtida do relógio do servidor em tempo de confirmação. Válido somente para campos de data e hora.

  • currentuser: O nome cópias do usuário que efetuou 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 seqüência de caracteres.

  • field: Copia o valor definido para o field atributo que você especificar. Requer um field="abc" atributo. Por padrão, se especificado "from" o campo está 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 é especificado para o from atributo. Os valores válidos consistem em uma seqüência de caracteres de texto que contenha entre 1 e 255 caracteres.

O valor para copiar pode ficar vazio.

field

Opcional. Especifica o nome do campo cujo valor é para ser copiado para o campo quando field é especificado para o from atributo. Você deve definir esse atributo, se o from o atributo tem um "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 na FIELD (definição) elemento. Para obter mais informações, consulte Elemento FIELD (definição).

Valor padrão: ^[a-Za-Z_][a-Za-z0-9_]* (\. [a-zA-Z0-9 _] +) +$

Exemplo de valor padrão: Company.Division.IssueType

Voltar ao topo

Definindo um valor padrão

O exemplo a seguir define a P3 como padrão para o campo 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>

Voltar ao topo

Limpando automaticamente de um campo

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

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

Voltar ao topo

Salvar um valor de campo

No exemplo a seguir, o nome do usuário que alterou um item de trabalho mais recentemente é 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>

Voltar ao topo

Especificando o relógio como um padrão.

No exemplo a seguir, o valor de um campo usará 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>
ObservaçãoObservação

Valores que contenham um apóstrofo, como, por exemplo, "Não corrigir", você deve usar aspas duplas em XML, como mostra o exemplo a seguir:

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

Voltar ao topo

Consulte também

Conceitos

Todas as referências de elementos do campo XML

Outros recursos

Trabalhando com regras do campo

A definição de campos de Item de trabalho

Histórico de alterações

Date

History

Motivo

Janeiro de 2011

Fornecida a sintaxe para todos os elementos de padrão e mais contexto para os exemplos.

Aprimoramento de informações.