Todas as referências de elementos do campo XML

  • Artigo

Você pode usar as informações neste tópico, como uma referência rápida para todos os elementos e atributos principais que definem um campo de dados para um tipo de item de trabalho. Esses elementos em você especifica o FIELD (definição) elemento contêiner. Adicionar um campo para um tipo de item de trabalho especificando um FIELD o elemento (definição) dentro do FIELDS (definição) elemento. Você pode especificar esses elementos dentro da definição de um tipo de trabalho item ou como parte de um fluxo de trabalho global. Você pode criar elementos que este tópico descreve para especificar o comportamento de um campo, definir valores padrão ou definir uma lista de valores do filho. Você pode usar elementos de regra de campo em combinação com uns aos outros. Além de escopo a maioria das regras para aplicar a um ou mais usuários ou grupos ou ignorados para um ou mais usuários ou grupos.

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

Todos os elementos filho da FIELD elemento são opcionais. Exceto para o HELPTEXT elemento, você pode especificar todos os elementos como elementos filhos da FIELD (definição), FIELD (fluxo de trabalho), e FIELD todos os elementos (fluxo de trabalho Global). Você pode usar o FIELD o elemento (definição) para definir um campo de item de trabalho e especificar as regras e condições que se aplicam ao proprietário. Você especificar regras para um FIELD o elemento (fluxo de trabalho) para definir o valor de ou aplicar regras a um campo como um item de trabalho transita de um estado para outro. Você pode especificar regras de campo com base na STATE, TRANSITION, DEFAULTREASON, ou REASON elemento do qual o seu elemento de CAMPOS pai é um filho. Para obter mais informações, consulte Trabalhando com campos de Item de trabalho e Projetando o fluxo de trabalho..

Neste tópico

  • Elemento de contêiner de campo (definição)

  • Elementos filho de campo

  • GLOBALLIST e os elementos filho LISTITEM

  • Atributos especificados pelos elementos filho de campo

Elemento de contêiner de campo (definição)

Você pode usar a seguinte sintaxe para definir os campos de dados para um tipo de item de trabalho. Este exemplo mostra o formato do FIELD o elemento de (definição) e todos os elementos filho opcional. Para obter mais informações, consulte Elemento FIELD (definição).

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID "
syncnamechanges="true | false" reportingname="reportingDisplayName" reportingrefname="reportingReferenceName"
reportable="Dimension | Detail | Measure" formula="avg" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

Elementos filho de campo

A tabela a seguir descreve os elementos filho que você pode especificar para aplicar regras para atribuir um valor a um campo. Todos os elementos filho são opcionais. Além de escopo a maioria dos elementos filho para aplicar somente a um único grupo ou a todos, exceto para os usuários em um único grupo.

Elemento

Descrição e sintaxe

ALLOWEDVALUES

Define uma lista de valores que os usuários podem especificar uma lista de campos de formulários de itens de trabalho e no editor de consulta. Os usuários devem especificar um dos valores que você listar.

<ALLOWEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</ALLOWEDVALUES>

Para obter mais informações, consulte Definir listas de opções.

ALLOWEXISTINGVALUE

Especifica que um campo pode reter um valor existente, mesmo se ele não estiver mais em uma lista. Todos os novos valores de campo devem estar na lista.

<ALLOWEXISTINGVALUE />

Para obter mais informações, consulte Definir listas de opções.

CANNOTLOSEVALUE

Especifica que os usuários não é possível limpar um campo de todos os valores após um valor foi especificado. Após o campo contiver um valor, esse campo deve sempre conter um valor não nulo.

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

Para obter mais informações, consulte Definindo as condições em um campo de Item de trabalho.

COPY

Copia um valor especificado para um campo quando um usuário cria ou modifica um item de trabalho.

<COPY for="userGroupName" not="userGroupName"  
from="value | field | clock | currentuser" 
value="valueToCopy" field="fieldReferenceName" />

Para obter mais informações, consulte Definindo um valor padrão ou a cópia de um valor a um campo.

DEFAULT

Especifica um valor para um campo que está vazio quando um usuário cria ou modifica um item de trabalho. Se um campo já tiver um valor, a regra padrão é ignorada.

<DEFAULT for="userGroupName" not="userGroupName" 
from="value | field | clock | currentuser" 
value="value to copy" field="field reference name" />

Para obter mais informações, consulte Definindo um valor padrão ou a cópia de um valor a um campo.

EMPTY

Limpa o campo de qualquer valor que ele contém. O EMPTY regra também torna um campo somente leitura, e você não deve ser usar com o READONLY regra.

O valor do campo é limpo quando um usuário salva o item de trabalho e não é possível especificar qualquer valor. Essa regra é usada principalmente durante a transição de estado para limpar os campos que se aplicam ao estado em que o item está em transição.

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

Para obter mais informações, consulte Definindo as condições em um campo de Item de trabalho.

FROZEN

Especifica que você não pode alterar o campo para um valor vazio após as alterações são confirmadas. Assim que um usuário salva o item de trabalho com um valor nesse campo, o valor não pode mais ser modificado.

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

Para obter mais informações, consulte Definindo as condições em um campo de Item de trabalho.

HELPTEXT

Define o texto exibido quando um usuário aponta para o campo no formulário de item de trabalho.

tooltipText: Uma seqüência de caracteres de texto que contenha entre 1 e 255 caracteres.

<HELPTEXT>tooltipText </HELPTEXT>

Para obter mais informações, consulte Definir o texto de ajuda para um campo de Item de trabalho.

MATCH

Define um padrão que devem coincidir com os valores dos campos do tipo String.

<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />

Para obter mais informações, consulte Fazendo uma seqüência de caracteres de campo coincidam com um padrão.

NOTSAMEAS

Especifica que um campo não é atribuído o mesmo valor atribuído à qual outro campo especificado. O valor de field atributo deve ser um nome de referência válida de um campo.

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

Para obter mais informações, consulte Definindo as condições em um campo de Item de trabalho.

PROHIBITEDVALUES

Define uma lista dos valores de um campo não pode conter. Os usuários não é possível salvar um item de trabalho se o campo contiver um valor proibido.

<PROHIBITEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</PROHIBITEDVALUES>

Para obter mais informações, consulte Definir listas de opções.

READONLY

Especifica que você não pode modificar o valor ao qual o campo está atribuído.

<READONLY for="userGroupName" not="userGroupName" />
ObservaçãoObservação
Não use esse elemento juntamente com o EMPTY elemento porque EMPTY também faz um campo somente leitura.Se você combinar esses elementos, os resultados serão inconsistentes.

Para obter mais informações, consulte Definindo as condições em um campo de Item de trabalho.

REQUIRED

Especifica que os usuários devem 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 atribuiu os valores para todos os campos obrigatórios.

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

Para obter mais informações, consulte Definindo as condições em um campo de Item de trabalho.

SERVERDEFAULT

Copia um valor de servidor especificado para um campo quando um usuário salva um item de trabalho. Normalmente, esses campos aparecem como somente leitura no formulário.

<SERVERDEFAULT for="userGroupName" not="userGroupName" 
from="clock | currentuser" />

Para obter mais informações, consulte Definindo um valor padrão ou a cópia de um valor a um campo.

SUGGESTEDVALUES

Define uma lista de sugestões de valores que os usuários podem especificar uma lista de campos de formulários de itens de trabalho e no editor de consulta. Os usuários podem especificar valores diferentes daqueles que você sugerir.

<SUGGESTEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>    
</SUGGESTEDVALUES>

Para obter mais informações, consulte Definir listas de opções.

VALIDUSER

Impede que os itens de trabalho sendo modificado por usuários que pertencem ao grupo que você especificar. O grupo padrão é o Team Foundation grupo de usuários válidos.

Todos os atributos são opcionais. Todos os atributos devem consistir em uma seqüência de caracteres de texto que contenha entre 1 e 255 caracteres. Você pode usar os tokens para especificar os grupos. Para obter mais informações, consulte Usando os Tokens de usuários de referência e grupos.

< VALIDUSER group="groupName" for="userName" not="userName" />

Para obter mais informações, consulte Gerenciando a permissão para criar ou modificar itens de trabalho.

WHEN

Especifica uma ou mais regras para aplicar ao campo atual quando outro campo tem um valor específico. O pai FIELD elemento define o campo atual.

<WHEN field="fieldReferenceName" value="value">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHEN>

Para mais informações, consulte: Atribuindo regras e valores baseados em condicional.

WHENNOT

Especifica uma ou mais regras para aplicar ao campo atual quando outro campo não tem um valor específico. O pai FIELD elemento define o campo atual.

<WHENNOT field="fieldReferenceName" value="value">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHENNOT>

Para obter mais informações, consulte Atribuindo regras e valores baseados em condicional.

WHENCHANGED

Especifica uma ou mais regras para aplicar ao campo atual quando outro campo é alterado durante a revisão do item de trabalho. O pai FIELD elemento define o campo atual.

<WHENCHANGED field="fieldReferenceName" >
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>      
</WHENCHANGED>

Para obter mais informações, consulte Atribuindo regras e valores baseados em condicional.

WHENNOTCHANGED

Especifica uma ou mais regras para aplicar ao campo atual quando outro campo não é alterado durante a revisão do item de trabalho. O elemento pai define o campo atual.

<WHENNOTCHANGED field="fieldReferenceName">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHENNOTCHANGED>

Para obter mais informações, consulte Atribuindo regras e valores baseados em condicional.

GLOBALLIST e os elementos filho LISTITEM

A tabela a seguir descreve o GLOBALLIST e LISTITEM elementos. Você especificar esses elementos como elementos filhos da ALLOWEDVALUES, SUGGESTEDVALUES, e PROHIBITEDVALUES elementos. Você pode usar esses elementos para enumerar uma lista de valores que aparece como uma lista de opções ou o menu suspenso de itens que um usuário pode especificar. Para obter mais informações, consulte Definindo e usando listas, listas de seleção e listas globais.

Elemento

Sintaxe

Descrição

GLOBALIST

 
<GLOBALLIST name="globalListName
">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

Define um conjunto de LISTITEM elementos que é armazenado para uma equipe de projeto de coleção e que todos os projetos de equipe em uma coleção podem usar.

globalListName: Uma seqüência de caracteres de texto que contenha entre 1 e 255 caracteres.

GLOBALLISTé um elemento filho necessário o GLOBALLISTS elemento e um elemento filho opcional da ALLOWEDVALUES, SUGGESTEDVALUES, e PROHIBITEDVALUES elementos. Você pode definir uma lista global dentro de uma definição de item de trabalho, uma definição de lista global ou um fluxo de trabalho global.

LISTITEM

 
<LISTITEM value="listName" />

Define um valor válido de lista.

LISTITEMé um elemento filho obrigatório do GLOBALLIST e um elemento filho opcional da ALLOWEDVALUES, SUGGESTEDVALUES, e PROHIBITEDVALUES elementos.

Voltar ao topo

Atributos especificados pelos elementos filho de campo

Você pode qualificar mais FIELD regras para aplicar ou não a um conjunto de grupos ou usuários, incluindo o for ou not atributos. Para obter mais informações, consulte Uma regra de campo a um grupo de escopo..

Atributo

Sintaxe

Descrição

expanditems

expanditems = "true | False"

Opcional. Especifica se um grupo que o LISTITEM elemento identifica deve ser expandido para incluir grupos subordinados na lista. O valor padrão deste atributo é true.

filteritems

filteritems = "excludegroups"

Opcional. Especifica que somente os membros de grupos e nomes de grupo, estão incluídos na lista. O único valor permitido para este atributo é excludegroups.

for

for = "userGroupName"

Opcional. Especifica o nome de um usuário ou grupo na Team Foundation ao qual a regra se aplica. Os valores válidos consistem em uma seqüência de caracteres de texto que contenha entre 1 e 255 caracteres.

not

não = "userGroupName"

Opcional. Especifica o nome de um usuário ou grupo na Team Foundation para o qual a regra não se aplica. Os valores válidos consistem em uma seqüência de caracteres de texto que contenha entre 1 e 255 caracteres.

from

from = "valor | campo | relógio | CurrentUser"

Obrigatório. Especifica a origem do valor do qual deseja copiar um valor ou especificar um valor padrão. Os seguintes valores são válidos:

  • clock: Copia a data e hora atuais do relógio do sistema para os campos de data e hora. Não há atributos adicionais são necessários. Para COPY e DEFAULT regras, esse valor provém o tempo de relógio do computador local. Para SERVERDEFAULT, o valor vem do relógio do servidor quando um usuário salva o item de trabalho.

  • currentuser: Copia o nome do usuário que está conectado no momento. Use o nome de usuário curto do usuário atual como o valor. Não há atributos adicionais são necessários. Usado para campos de seqüência de caracteres.

  • field: Copia o valor de field atributo que você especificar. Requer um field="abc" atributo. Por padrão, se especificado "from" o campo está vazio, nada é executado. O field atributo é usado somente para <COPY> e <DEFAULT> regras.

  • value: Copia o valor de value atributo que você especificar. Use o valor de uma constante de seqüência de caracteres que você especificar. Requer um value="abc" atributo. valuesó é usada para <COPY> e <DEFAULT> regras.

Se você especificar "valor" ou "campo" Você também deve incluir o atributo de valor ou o campo, respectivamente.

field

campo = "fieldReferenceName"

Opcional. Especifica o nome do campo cujo valor é para ser copiado para o campo quando field é especificado para o from atributo.

value

valor = "valueToCopy"

Opcional. Especifica o valor a ser copiado para o campo quando value é especificado para o from atributo.

Voltar ao topo

Consulte também

Conceitos

Definindo e usando listas, listas de seleção e listas globais

Trabalhando com campos de Item de trabalho

Projetando o fluxo de trabalho.

Histórico de alterações

Date

History

Motivo

Janeiro de 2011

Revisado para fornecer a sintaxe para todas as FIELD elementos filho e remover links para tópicos que foram removidos.

Aprimoramento de informações.