Definir condições em um campo de item de trabalho

Você pode impedir que as alterações feitas a um campo, especificando uma regra de qualificação, como o CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY, e REQUIRED elementos.Por exemplo, você pode usar o NOTSAMEAS regra para impedir que dois campos sendo atribuído o mesmo valor ou que está sendo limpo ao mesmo tempo.Além disso, você pode usar essa regra para impedir que o campo de "Revisor de código" que está sendo atribuído o mesmo valor que o campo "atribuído a".

Você pode especificar essas regras como elementos filho da FIELD (definição), FIELD (fluxo de trabalho), ou FIELD elementos (fluxo de trabalho Global).Você pode aplicar ou ignorar essas regras com base em quem está modificando o item de trabalho, especificando um usuário ou grupo para o for ou not atributos, respectivamente.

Estrutura de sintaxe dos elementos de regra para valores de campo

  • Você pode especificar o CANNOTLOSEVALUE regra para impedir que um campo que está sendo limpo depois que foi especificado um valor.Se você aplicar essa regra a um campo, esse campo sempre deve conter um valor não nulo, depois que um usuário define o campo como qualquer valor.

    <CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />
    
  • Você pode especificar o EMPTY regra para limpar um campo de qualquer valor que ele contém.Esta regra também torna um campo somente leitura, e você não deve usá-lo com o READONLY regra.O valor do campo é desmarcado quando você salvar o item de trabalho e você não pode especificar qualquer valor.Principalmente usam essa regra durante a transição de estado para limpar os campos que se aplicam ao estado em que o item de trabalho está em transição.

    <EMPTY for="userGroupName"not="userGroupName" />
    
  • Você pode especificar o FROZEN regra para impedir que um usuário altere o campo para um valor não nulo, depois de salvar o item de trabalho.Assim que um campo tiver um valor definido no banco de dados, o valor não pode mais ser modificado.

    <FROZEN for="userGroupName" not="userGroupName" />
    
  • Você pode especificar o NOTSAMEAS regra para impedir que um campo que está sendo atribuído o mesmo valor de outro campo.O field atributo deve ser um nome de referência válida de um campo.

    <NOTSAMEAS for="userGroupName" not="userGroupName" field="fieldReferenceName"/>
    

    Por exemplo, o trecho a seguir impede que um campo tendo o mesmo valor que o campo MyCorp.Reviewer:

    <NOTSAMEAS field="MyCorp.Reviewer" />
    

    Use essa regra para campos que são de um tipo semelhante.Você não pode usá-lo para os campos de texto sem formatação ou HTML.

  • Você pode especificar o READONLY regra para impedir alterações para o valor de um campo.

    Não use esse elemento em conjunto com o EMPTY elemento porque EMPTY também torna um campo somente leitura.Se você usar os dois elementos juntos, você pode produzir resultados inconsistentes.

    <READONLY for="userGroupName" not="userGroupName" />
    
  • Você pode especificar o REQUIRED regra para exigir que um usuário deve especificar um valor para o campo.Campos obrigatórios não podem estar vazios.Os usuários não é possível salvar um item de trabalho até que eles definiu todos os campos obrigatórios.

    <REQUIRED for="userGroupName" not="userGroupName" />
    

De volta ao topo

Atributos

Você pode restringir a quem as regras de qualificação se aplicam.A tabela a seguir descreve os atributos que fazem referência a esses elementos:

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 para quem 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.

Padrão de valor: ^ [^ \ \] + \ \ [^ \ \] +$

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

field

Necessário para NOTSAMEAS elemento.Especifica o nome de referência do campo cujo valor do campo atual não pode conter.

O nome de referência deve coincidir com o nome de referência é definido pela 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

Consulte também

Conceitos

Todas as referências de elementos do campo XML

Usar tokens para fazer referência a usuários e grupos

Outros recursos

Gerenciar permissão para criar ou modificar itens de trabalho

Trabalhando com regras do campo

Definir campos de item de trabalho