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 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, e SERVERDEFAULT.Você pode especificar esses elementos como elementos filho da FIELD elemento (definição) ou o FIELD elemento (fluxo de trabalho).
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á comprometida com o banco de dados.Essa ação ocorre quando um usuário salva as alterações em um itemde trabalho e o usuário não pode substituir o valor.Esses campos normalmente aparecem como somente leitura noformuláriodo itemde trabalho. O SERVERDEFAULT é usada para campos, como o "Último alterado por" e "Último alterado em" para dar suporte a trilhas de auditoria de seguro.
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 um valor de servidor em um campoou especificar um valor padrão a serem definidas para um campo.
.gif "Observação") Observação |
|---|
Se o item de trabalho está sendo alterada, o COPY ou DEFAULT regra elementos poderá selecionar o valor atual ou anterior a partir docampode fonte. |
Você pode especificar um valor para copiar de outro campo, o valor do relógio, ou o nome do usuárioatual.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 itemdo 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 itemdo trabalho, o DEFAULT regra preenche um valor se esse campo estiver vazio.Você pode especificar um valor para copiar de outro campo, o carimbo de data e hora que o servidor do relógio registros ou o nome do usuárioatual.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 itemdo trabalho, o SERVERDEFAULT regra especifica um valor a ser copiada do campo atual de um valor que é derivado de um componentede 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á comprometida com o banco de dados.Essa ação ocorre quando o usuário salva o itemde trabalho.O usuário não pode substituir o valor.Esses campos normalmente aparecem como somente leitura no formulário.O SERVERDEFAULT é usada para campos, como o "Último alterado por" e "Último alterado em" para dar suporte a trilhas de auditoria de seguro.
<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. Padrão de valor: ^ [^ \ \] + \ \ [^ \ \] +$ Exemplo de valor padrão: domínio\UserID |
not |
Opcional.Especifica o nome de um usuário ou grupo na Team Foundation ao qual a regra faz não aplicar.Nomes válidos consistem em uma seqüência de caracteres de texto que contenha entre 1 e 255 caracteres. Padrão de valor: ^ [^ \ \] + \ \ [^ \ \] +$ Exemplo de valor padrão: domínio\UserID |
from |
Necessário.Especifica se você deseja copiar o valor padrão a partir do value atributo, o field atributo, o relógio do sistema ou o usuárioatual. 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:
|
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. Para copiar o valor pode ser 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 a from 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 elemento (definição).Para mais informações, consulte Elemento FIELD (definição). Valor de padrão: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [a-zA-Z0-9 _] +) +$ Exemplo de valor padrão: Company.Division.IssueType |
De volta ao topo
Definindo um valor padrão
O exemplo a seguir define P3 como padrão para o campode 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>
De volta ao topo
Limpando automaticamente de um campo
No exemplo a seguir, ocampo de statusestá desmarcada.
<FIELD refname="MyCorp.Status" name="Status" type="String">
<COPY from="value" value="" />
</FIELD>
De volta 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>
De volta 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 serão corrigidos", você deve usar aspas duplas no XML, como mostra o exemplo a seguir: <LISTITEM value="Won’t Fix"/> |
De volta ao topo
Consulte também
Conceitos
Todas as referências de elementos do campo XML