Compartilhar via


Definindo as condições em um campo de Item de trabalho

Você pode impedir que 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 os dois campos sejam atribuídos o mesmo valor ou que está sendo limpo ao mesmo tempo. Além disso, você pode usar a regra para impedir que o revisor"código" campo sejam atribuídos o mesmo valor que o "atribuído a" campo.

Você pode especificar essas regras como elementos filhos do FIELD (definição), FIELD (fluxo de trabalho), ou FIELD todos os 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.

ObservaçãoObservação

Antes de definir um fluxo de trabalho global, o recurso deve ser habilitado no servidor de camada de aplicativo. Portanto, o servidor deve estar executando uma versão do Visual Studio Team Foundation Server, como Team Foundation Server 2010 com Service Pack 1 (SP1), que suporta esse recurso. Você pode obter o service pack na seguinte página no site da Microsoft: Service Pack 1 de 2010, a versão Beta do Team Foundation Server de Visual Studio. Para obter mais informações, consulte Personalizando o fluxo de trabalho Global.

Estrutura de sintaxe dos elementos de regra para os 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 para 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ê salva o item de trabalho e não é possível 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 alterar 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 sejam atribuídos 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 do campo de 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 no valor de um campo.

    Não use esse elemento juntamente com o EMPTY elemento porque EMPTY também faz 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" />
    

Voltar 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.

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

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 pelo 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

Consulte também

Conceitos

Todas as referências de elementos do campo XML

Usando os Tokens de usuários de referência e grupos

Outros recursos

Gerenciando a permissão para criar ou modificar itens de trabalho

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

Revisado para manter a simplicidade e forneceu a estrutura de sintaxe para cada elemento da regra.

Aprimoramento de informações.