Partilhar via


Regras de campo disponível

[Observação: Este tópico é pré-versão documentação e está sujeitas a alterações em versões futuras. Tópicos em branco são incluídos sistema autônomo espaços reservados.]

Campo regras definem o comportamento e restrições em campos.Regras de campo são elementos adicionais que são listados dentro <field></field> blocos.Por exemplo, se um campo for necessário, o XML que define o campo deve ser sistema autônomo segue:

<FIELD refname="System.Priority" name="Priority" type="String">
<HELPTTEXT>Enter the business priority of the bug</HELPTEXT>
<REQUIRED />
</FIELD>

Regras de campo disponível

Você pode usar as seguintes regras de campo para alterar o comportamento de um campo:

<NECESSÁRIO / >

Este campo não pode estar vazio.Você pode marcar qualquer tipo de campo sistema autônomo necessária.Este elemento aceita for e not atributos. Para obter mais informações, consulte Elemento REQUIRED (tipo de item de trabalho Definition esquema).

<READONLY / >

O campo não pode ser modificado.Este elemento aceita for e not atributos. Para obter mais informações, consulte READONLY elemento (esquema de definição do tipo de item de trabalho).

<VAZIA / >

O valor do campo está desmarcado na confirmar e o usuário não poderá inserir qualquer valor.Essa regra é usada principalmente durante a transição de estado para desmarcar os campos que se aplicam a transição para estado.Este elemento aceita for e not atributos. Para obter mais informações, consulte EMPTY elemento (esquema de definição do tipo de item de trabalho).

<frozen/>

Assim que um campo tem um valor após uma confirmar, que o valor não pode mais ser modificado.No entanto, o campo pode ser limpo, usando um <empty/> restrição.O usuário pode desmarcar manualmente o campo, salvar o item de trabalho e, em seguida, especifique um valor diferente após a recarga.Este elemento aceita for e not atributos. Para obter mais informações, consulte Elemento CONGELADO (tipo de item de trabalho Definition esquema).

<cannotlosevalue/>

Depois de um campo tiver adquirido um valor, não pode ser limpo ou feita vazio.Este elemento aceita for e not atributos. Para obter mais informações, consulte CANNOTLOSEVALUE elemento (esquema de definição do tipo de item de trabalho).

<NOTSAMEAS campo="MyCorp.Reviewer" />

O valor do campo não pode ter o mesmo valor sistema autônomo o valor no outro campo; nesse caso, o campo"MyCorp.Reviewer ”.O valor do campo deve ser um nome de referência de campo válido.Para obter mais informações, consulte Nomes de referência de campo.

Exemplos de uso da regra de campo NOTSAMEAS:

  • Dois campos não podem estar vazios ao mesmo time.

  • valor do campo "Revisor de código" exatamente não pode coincidir com o "atribuído a" valor do campo.

Use essa regra para campos de como tipo.Você não pode usá-lo para campos texto não criptografado ou HTML.Este elemento aceita for e not atributos. Para obter mais informações, consulte NOTSAMEAS elemento (esquema de definição do tipo de item de trabalho).

<VALIDUSER agrupar="agrupar" />

O valor do campo deve ser um usuário válido que seja membro do Usuários válidos do Team Foundation agrupar.

Esta regra suporta o atributo opcional do agrupar para especificar que o usuário deve ser um membro direto ou indireto do agrupar especificado.Por padrão, a regra ativa todos os usuários que são membros do Usuários válido do Team Foundation agrupar.Para obter mais informações, consulte Usando tokens a referência de usuários e grupos.Este elemento aceita for e not atributos. Para obter mais informações, consulte VALIDUSER elemento (esquema de definição do tipo de item de trabalho).

Observação:

Se o <required/> regra não for especificada, este campo aceita um valor vazio.Usado para tipos de campo de string.

Observação:

Campos de item de trabalho não fazem distinção entre usuário identidades em domínios diferentes.Portanto, "Example1\jaepak" e "Example2\jaepak" são tratados sistema autônomo o mesmo usuário quando inserido em um campo que usa o < VALIDUSER / > regra.No entanto, as identidades dos usuários são diferenciadas por domínio em outro lugar no Team Foundation Server.

<allowexistingvalue/>

Permite que um campo de manter um valor existente, mesmo se esse valor não está mais habilitado.O comportamento padrão e alternativa é forçar o usuário em time de edição para coincidir com os valores mais recentes ativados para aquele campo.Este elemento tem um efeito modificando somente nos elementos no mesmo bloco.Este elemento não pode aceitar for ou not atributos. Para obter mais informações, consulte ALLOWEXISTINGVALUE elemento (esquema de definição do tipo de item de trabalho).

<allowedvalues/>

Uma lista enumerada de valores que é apresentada ao usuário sistema autônomo uma lista.Os usuários devem selecionar um dos valores nessa lista.Este elemento aceita for e not atributos. Para obter mais informações, consulte ALLOWEDVALUES elemento (esquema de definição do tipo de item de trabalho).

<suggestedvalues/>

Uma lista enumerada de valores que é apresentada ao usuário sistema autônomo uma lista.Os usuários podem selecionar qualquer um dos valores.Os usuários também podem inserir seus próprios valores que não é uma das sugestões.Este elemento aceita for e not atributos. Para obter mais informações, consulte SUGGESTEDVALUES elemento (esquema de definição do tipo de item de trabalho).

<prohibitedvalues/>

Os usuários não poderão salvar um item de trabalho se o campo contiver valores proibidos.Proibido valores geralmente são usados quando um valor permitido anteriormente, mas não é mais válido.Este elemento aceita for e not atributos. Para obter mais informações, consulte PROHIBITEDVALUES elemento (esquema de definição do tipo de item de trabalho).

<padrão>

Quando um usuário cria um novo item de trabalho ou edita um item de trabalho, o elemento <padrão>preenche um valor do campo se esse campo estiver vazio.Se um campo já possui um valor, a regra padrão será ignorada.Este elemento aceita for e not atributos. Para obter mais informações, consulte padrão elemento (esquema de definição do tipo de item de trabalho).

Observação:

Ao alterar um item de trabalho, essa regra de elemento é não determinístico no que diz respeito a seleção do valor anterior ou corrente de outro campo.

<copy>

Quando um usuário cria um novo item de trabalho ou altera um item de trabalho, o elemento <copy>preenche um valor do campo, independentemente de qualquer valor existente já no campo.Este elemento aceita for e not atributos. Para obter mais informações, consulte COPY elemento (esquema de definição do tipo de item de trabalho).

Observação:

Ao alterar um item de trabalho, essa regra de elemento é não determinístico no que diz respeito a seleção do valor anterior ou corrente de outro campo.

<serverdefault>

Diferentemente <padrão>e <copy>preencher os valores no início da edição, o <serverdefault>regra preenche um valor quando o item de trabalho é confirmado no banco de dados.Isso ocorre no economizar time e o usuário não pode substituir o valor.Esses campos são exibidos somente para leitura no formulário.Essa regra é usada para campos, sistema autônomo "Última alterado por" e "Último alterado em" para dar suporte seguro trilhas de auditoria.Este elemento aceita for e not atributos. Para obter mais informações, consulte SERVERDEFAULT elemento (esquema de definição do tipo de item de trabalho).

<CORRESP padrão = "<pattern>" / >

Impõe básica de padrões coincidentes para somente cadeias de caracteres.<pattern>deve ser substituído com o padrão de correspondência.sistema autônomo valores válido são "A, ”"N, ”"X. ” Todos sistema autônomo outros valores são utilizados sistema autônomo literais. "A"representa um caractere alfabético. "N"representa um caractere numérico. "X"representa qualquer caractere alfanumérico.Esse padrão só é suportado para campos do tipo String.Este elemento aceita for e not atributos. Para obter mais informações, consulte CORRESP elemento (esquema de definição do tipo de item de trabalho).

Exemplos de correspondência de padrão

Os exemplos a seguir ilustram bem-sucedidas e malsucedida padrão corresponde para uma variedade de usos do campo:

Número de versão

Padrão: ANN.NN.NN

Valida

R01.03.04 ou V05.08.99

Falha de validação

1.3.4 ou V5.8.99 ou v1.3

Um identificador flexível

Padrão: XXX XXX

Valida

001-abc ou b02 a00

Falha de validação

abc-1 ou 001. abc

Prioridade

Padrão: PN

Valida

P1 ou P5 ou P9

Falha de validação

1 ou P10

Rótulos de correspondência são sem distinção entre maiúsculas e minúsculas, para que corresponde a "NP" tanto P1 p1.

Observação:

Você pode especificar vários elementos <match>.Se pelo menos um elemento for bem-sucedida, o campo tem um valor válido.

Consulte também

Outros recursos

Definir listas de campo