Definir listas de opções

Artigo
03/12/2013

Você pode enumerar um conjunto de valores para um campo definindo uma lista de opções como parte de sua definição ou em algum ponto durante o fluxo de trabalho.Você pode especificar que a lista pode conter somente valores permitidos, não pode conter valores proibidos, nem pode sugerir valores.Se você sugere valores, os usuários podem especificar um valor outro aqueles na lista de opções.

Você também pode definir as listas de opções dependentes, em que você define dois ou mais listas para um campo mas somente 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 elementos de GLOBALLIST e de LISTITEM
Permitindo um valor existente
Enumerando um conjunto de valores permitidos
Definindo listas de opções dependentes

Observação
Para adicionar ou modificar uma lista de opções de uma definição de FIELD , usar a ferramenta de linha de comando witadmin para exportar e importar a definição para o tipo de item de trabalho.Consulte Personalizar e gerenciar tipos de item de trabalho [witadmin].

Estrutura de sintaxe para enumerar listas de opções

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

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

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

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

Você usa PROHIBITEDVALUES para definir uma lista de valores que um campo não pode conter.Os usuários não podem salvar um item de trabalho se o campo contém um valor proibido.Você usa esse elemento se você deseja restringir o uso de um valor que é 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ê usa SUGGESTEDVALUES para definir uma lista de valores que um campo pode conter.Os usuários podem especificar outros valores além do que aquelas que você sugere.

<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 de um grupo na Team Foundation que as regras se aplicam.Os nomes válidos consistem em uma cadeia de caracteres de texto que contém entre 1 e 255 caracteres. Valor de padrão: ^ [\ de ^ +] \ \ \ de ^ [\ \ +$] Exemplo do valor de padrão: Domínio\UserID
not	Opcional.Especifica o nome de um usuário ou de um grupo na Team Foundation que a regra não se aplica.Os nomes válidos consistem em uma cadeia de caracteres de texto que contém entre 1 e 255 caracteres. Valor de padrão: ^ [\ de ^ +] \ \ \ de ^ [\ \ +$] Exemplo do valor de padrão: Domínio\UserID
expanditems	Opcional.Especifica se um grupo identificado no elemento de LISTITEM deve ser expandido para incluir grupos subordinados na lista.O valor padrão é true.
filteritems	Opcional.Especifica que a lista inclui somente os membros de grupos, não nomes de grupo.O único valor válido desse atributo é excludegroups.

Para obter mais informações, consulte Definir listas de usuários, listas de opções e listas globais.

De volta ao topo

Estrutura de sintaxe para elementos de GLOBALLIST e de LISTITEM

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

Você usa GLOBALLIST para definir um conjunto de elementos de LISTITEM que sejam armazenados para uma coleção de projeto de equipe e que todos os projetos de equipe na coleção podem usar.GLOBALLIST é necessário um elemento filho do elemento de GLOBALLISTS e um elemento filho opcional de ALLOWEDVALUES, de SUGGESTEDVALUES, e elementos de PROHIBITEDVALUES .Você pode definir uma lista global em uma definição de item de trabalho, de uma definição global da lista, ou fluxo de trabalho global.

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

globalListName: Uma cadeia de caracteres de texto que contém entre 1 e 255 caracteres.

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

Você usa LISTITEM para enumerar um conjunto de valores.LISTITEM é um filho de GLOBALLIST necessário e um elemento filho opcional de ALLOWEDVALUES, de SUGGESTEDVALUES, e elementos de PROHIBITEDVALUES .
```
<LISTITEM value="listName" />
```
listName: Uma cadeia de caracteres de texto que contém entre 1 e 255 caracteres.

De volta ao topo

Permitindo um valor existente

Você pode usar o elemento de ALLOWEXISTINGVALUE para permitir que um campo manter valores existentes, depois que você especifica uma lista de opções de itens usando o elemento de ALLOWEDVALUES .Se você não especificar o elemento de ALLOWEXISTINGVALUE , você forçar o usuário, em tempo de edição, especifique um dos valores válidos atual para o campo.O elemento de ALLOWEXISTINGVALUE altera somente os elementos no mesmo bloco.

<ALLOWEXISTINGVALUE />

Você especifica esse elemento no elemento de FIELD (fluxo de trabalho) aplicá-lo às regras que são definidas para o campo.Este aplicativo inclui regras que STATE, TRANSITION, DEFAULTREASON, e os elementos de REASON do campo especificam.Você especifica esse elemento no elemento de STATE aplicá-lo não apenas as regras que são definidas no estado para o campo mas também às regras que são definidas para o campo para todas as transições no estado.

Você especifica esse elemento no elemento de TRANSITION aplicá-lo não apenas as regras que são definidas na transição para o campo mas também às regras que são definidas para o campo em elementos de REASON e de DEFAULTREASON .

De volta ao topo

Enumerando uma lista

As listas do campo são compostos de itens de listas individuais.Cada lista de campos deve conter pelo menos um item.

Observação
As listas globais não devem incluir grupos com o escopo porque não são do escopo a um projeto.

Para especificar itens em um campo listar, use o elemento de <LISTITEM value=""> .Você pode especificar uma cadeia 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ção
Em tempo de execução, os itens em uma lista parecem com base em ordem alfabética no idioma de servidor que está executando Visual Studio Team Foundation Server.

De volta ao topo

Enumerando um conjunto de valores permitidos

Nesse exemplo, o campo de gravidade de cliente pode ter qualquer dos três valores: Emergência, versão, e menor.O campo é definido como necessário com um valor padrão de menor.Em tempo de execução, os usuários podem especificar um dos valores em uma lista suspensa.

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

De volta ao topo

Definindo listas de opções dependentes

Você pode definir uma lista de opções que está ativo apenas quando sua cláusula condicional pai é verdadeira.No exemplo a seguir, dois conjuntos de lista de opções são definidos para meu campo.Em tempo de execução, somente uma lista aparece com base em se os requisitos são atribuídos ao campo de MyCompany.MyTeam.Discipline .

Observação
As regras de WHEN e de WHENNOT nesse exemplo também podem aplicar a outras regras para especificar quando essas regras devem ser avaliadas.Para obter mais informações, consulte Atribuir regras e valores baseados em condicionais.

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

De volta ao topo