Definir listas de opções

Você pode enumerar um conjunto de valores para um campo definindo uma lista como parte de sua definição ou em algum momento durante o fluxo de trabalho. Você pode especificar a lista pode conter somente os valores permitidos, não pode conter valores proibidas ou pode sugerir valores. Se você sugere valores, os usuários podem especificar um valor outros estão na lista de separação.

Você também pode definir listas de opções de dependente, no qual você definir listas de dois ou mais de um campo, mas apenas uma lista aparece em tempo de execução com base na avaliação de uma regra condicional.

Neste tópico

  • Estrutura de sintaxe para enumerar listas de opções

  • Estrutura de sintaxe para GLOBALLIST e LISTITEM elementos

  • Permitindo que um valor existente

  • A enumeração de um conjunto de valores permitidos

  • Definir listas de opções dependentes

Estrutura de sintaxe para enumerar listas de opções

Você pode usar o ALLOWEDVALUES, SUGGESTEDVALUES, e PROHIBITEDVALUES elementos para especificar uma lista de valores que um usuário deve especificar, pode especificar ou não deve especificar como um valor para um campo. Se você usar cada um desses elementos, você pode enumerar uma lista de itens ou especificar uma lista global. Você pode usar o ALLOWEXISTINGVALUE para permitir que um campo para armazenar um valor existente, se você remover um item da lista de separação.

Você pode especificar esses elementos como elementos filhos da FIELD (definição) ou FIELD (fluxo de trabalho) de elemento.

  • Você pode usar ALLOWEDVALUES para definir uma lista de valores que os usuários podem especificar em um formulário de item de trabalho ou o editor de consulta. Os usuários devem especificar um dos valores de GLOBALLIST ou o conjunto de LISTITEM entradas.

    <ALLOWEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups">
       <GLOBALLIST name="globalListName" />
       <LISTITEM value="Name1" />
       <LISTITEM value="Name2" />
       <LISTITEM value="Name3" />
    . . . 
    </ALLOWEDVALUES>
    
  • Você pode usar PROHIBITEDVALUES para definir 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. Você pode usar esse elemento se você quiser restringir o uso de um valor que foi permitido anteriormente, mas não é mais válido.

    <PROHIBITEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups">
       <GLOBALLIST name="globalListName" />
       <LISTITEM value="Name1" />
       <LISTITEM value="Name2" />
       <LISTITEM value="Name3" />
    . . . 
    </PROHIBITEDVALUES>
    
  • Você pode usar SUGGESTEDVALUES para definir uma lista dos valores de um campo pode conter. Os usuários podem especificar outros valores além daqueles que você sugerir.

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

Para cada um desses elementos, você pode especificar um ou mais dos atributos que a tabela a seguir descreve:

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

expanditems

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

filteritems

Opcional. Especifica que a lista inclui apenas os membros de grupos, não os nomes de grupo. O valor só é válido para este atributo é excludegroups.

Para obter mais informações, consulte Definindo e usando listas, listas de seleção e listas globais.

Voltar ao topo

Estrutura de sintaxe para GLOBALLIST e LISTITEM elementos

Você pode usar o GLOBALLIST e LISTITEM elementos para enumerar uma lista de itens que podem ser atualizados globalmente ou que são específicos para um único campo.

  • Você pode usar GLOBALLIST para definir um conjunto de LISTITEM elementos que é armazenado para uma equipe de projeto de coleção e que todos os projetos da equipe em que a coleção pode usar. 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.

    <GLOBALLIST name="globalListName">
       <LISTITEM value="Name1" />
       <LISTITEM value="Name2" />
       <LISTITEM value="Name3" />
    . . . 
    </GLOBALLIST> 
    

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

    Observação importanteImportante

    Se você definir uma lista global em um arquivo XML que define um tipo de item de trabalho, é necessário fornecer a lista em um nome exclusivo. Caso contrário, você pode substituir uma lista existente que foi definida para a coleção.

  • Você pode usar LISTITEM para enumerar um conjunto de valores. LISTITEMé um elemento filho obrigatório do GLOBALLIST e um elemento filho opcional da ALLOWEDVALUES, SUGGESTEDVALUES, e PROHIBITEDVALUES elementos.

    <LISTITEM value="listName" />
    

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

Voltar ao topo

Permitindo que um valor existente

Você pode usar o ALLOWEXISTINGVALUE elemento para permitir que um campo manter os valores existentes, depois que você especificar uma lista de itens usando o ALLOWEDVALUES elemento. Se você não especificar o ALLOWEXISTINGVALUE elemento, você força o usuário, no momento da edição, para especificar um dos valores atuais válidos para esse campo. O ALLOWEXISTINGVALUE elemento modifica apenas aqueles elementos no mesmo bloco.

<ALLOWEXISTINGVALUE />

Você especificar este elemento sob o FIELD elemento (fluxo de trabalho) para aplicá-la, as regras que são definidas para o campo. Este aplicativo inclui as regras que o STATE, TRANSITION, DEFAULTREASON, e REASON elementos de especificar o campo. Você especificar este elemento sob o STATE elemento para aplicá-la, não apenas as regras que são definidas no estado para o campo, mas também para as regras que são definidas para o campo para todas as transições em estado.

Você especificar este elemento sob o TRANSITION elemento para aplicá-la, não apenas para as regras que são definidas na transição para o campo, mas também as regras que são definidas para o campo do REASON e DEFAULTREASON elementos.

Voltar ao topo

Enumerando uma lista

Listas de campos são compostas de itens individuais. Cada lista do campo deve conter pelo menos um item.

ObservaçãoObservação

Listas globais não devem incluir os grupos com escopo de projeto, porque eles não têm o escopo para um projeto.

Para especificar os itens em uma lista de campos, use o <LISTITEM value=""> elemento. Você pode especificar uma seqüência de caracteres, um nome de usuário ou um nome de grupo.

<LISTITEM value="Emergency"/>
<LISTITEM value="Major"/>
<LISTITEM value="Minor"/>
<LISTITEM value="Domain\joe"/>
<LISTITEM value="[Global]\GlobalGroup" />
<LISTITEM value="[Project]\ProjectGroup" />
ObservaçãoObservação

Em tempo de execução, itens de uma lista aparecem em ordem alfabética com base no idioma do servidor que está executando o Visual Studio Team Foundation Server.

Voltar ao topo

A enumeração de um conjunto de valores permitidos

Neste exemplo, o campo de gravidade do cliente pode ter qualquer um dos três valores: Emergência, principais e secundárias. O campo está definido como obrigatório com um valor padrão de menor. Em tempo de execução, os usuários podem especificar um dos valores em uma lista drop-down.

<FIELD refname="System.Title" name="Title" type="String">
<HELPTEXT>Provide a brief description of the work item</HELPTEXT>
<REQUIRED/>
</FIELD>
<FIELD refname="MyCorp.CusSeverity" name="Customer Severity" type="String">
<HELPTEXT>Indicate the severity of the problem</HELPTEXT>
    <ALLOWEDVALUES>
        <LISTITEM value="Emergency">
        <LISTITEM value="Major">
        <LISTITEM value="Minor">
    </ALLOWEDVALUES>
<DEFAULT from="value" value="Minor"/>
</FIELD>

Voltar ao topo

Definir listas de opções dependentes

Você pode definir uma lista de seleção está ativa somente quando sua cláusula condicional do pai é true. No exemplo a seguir, os dois conjuntos de lista de escolhas são definidos para o Meu campo. Em tempo de execução, apenas uma lista aparece com base no que se os requisitos é atribuído para o MyCompany.MyTeam.Discipline campo.

ObservaçãoObservação

O WHEN e WHENNOT as regras neste exemplo também podem aplicar a outras regras para especificar quando essas regras devem ser avaliadas. Para obter mais informações, consulte Atribuindo regras e valores baseados em condicional.

<FIELD name="My Field" refname="MyCompany.MyProcess.MyField" type="String" reportable="dimension">
  <WHEN field="MyCompany.MyTeam.Discipline" value="Requirements">
    <ALLOWEDVALUES>
      <LISTITEM value="Planning" />
      <LISTITEM value="Review" />
    </ALLOWEDVALUES>
  </WHEN>
  <WHENNOT field=" MyCompany.MyTeam.Discipline" value="Requirements">
    <ALLOWEDVALUES>
      <LISTITEM value="Process Management" />
      <LISTITEM value="Planning" />
      <LISTITEM value="Review" />
    </ALLOWEDVALUES>
  </WHENNOT>
</FIELD>

Voltar ao topo

Consulte também

Conceitos

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

Outros recursos

Índice de definições de elemento XML para tipos de itens de trabalho

Personalizando o fluxo de trabalho Global

A definição de campos de Item de trabalho

Histórico de alterações

Date

History

Motivo

Janeiro de 2011

Adicionado a estrutura de sintaxe e exemplos mais.

Aprimoramento de informações.