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çã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:
|
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çã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. |