Definir listas de opções

Artigo
06/09/2015

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

Você também pode definir listas de opções dependente, no qual você define dois ou mais listas para 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 da sintaxe
Estrutura de sintaxe para GLOBALLIST e LISTITEM elementos
Permitir que um valor existente
Especificar um conjunto de valores permitidos
Definir listas de opções dependentes

Dica

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

Estrutura da sintaxe

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 armazenar um valor existente, se você remover um item na lista de seleção.

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

Você usa ALLOWEDVALUES para definir uma lista de valores especificados pelos usuários em um formulário de item de trabalho ou o editor de consulta. Os usuários devem especificar um dos valores a 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ê usa PROHIBITEDVALUES para definir uma lista de valores que não pode conter um campo. Os usuários não é possível salvar um item de trabalho se o campo contiver um valor proibido. Você usa esse elemento se você quiser restringir o uso de um valor que foi permitido anteriormente, mas não é mais válida.
```
<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 pode conter um campo. Os usuários podem especificar outros valores além daquelas 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 descreve a tabela a seguir:

Atributo	Descrição
for	Opcional. Especifica o nome de um usuário ou grupo no Team Foundation aos quais a regra se aplica. Os nomes válidos consistem em uma cadeia de caracteres de texto que contenha entre 1 e 255 caracteres. Valor do padrão: ^ [^ \ \] + \ \ [^ \ \] + $ Exemplo de valor padrão: domínio\UserID
not	Opcional. Especifica o nome de um usuário ou grupo no Team Foundation para quem a regra não se aplica. Os nomes válidos consistem em uma cadeia de caracteres de texto que contenha entre 1 e 255 caracteres. Valor do padrão: ^ [^ \ \] + \ \ [^ \ \] + $ Exemplo de valor padrão: domínio\UserID
expanditems	Opcional. Especifica se um grupo identificado no 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 único valor válido desse atributo é excludegroups.

Para obter mais informações, consulte Expandir itens de lista e excluir grupos das listas.

Estrutura de sintaxe para elementos GLOBALLIST e LISTITEM

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 a um único campo.

Você usa GLOBALLIST para definir um conjunto de LISTITEM elementos que são armazenados por uma equipe de projeto coleção e que todos os projetos de equipe nessa coleção possa usar. GLOBALLIST é um elemento filho obrigatório do elemento GLOBALLISTS e um elemento filho opcional dos elementos ALLOWEDVALUES, SUGGESTEDVALUES e PROHIBITEDVALUES. 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 sequência 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 atribuir a lista um nome exclusivo.Caso contrário, você pode substituir uma lista existente que foi definida para a coleção.
Você usa LISTITEM para enumerar um conjunto de valores. LISTITEM é um elemento filho obrigatório de GLOBALLIST e um elemento filho opcional dos elementos ALLOWEDVALUES, SUGGESTEDVALUES e PROHIBITEDVALUES.
```
<LISTITEM value="listName" />
```
listName: uma cadeia de caracteres de texto que contenha entre 1 e 255 caracteres.

Permitir que um valor existente

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

<ALLOWEXISTINGVALUE />

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

Especificar esse elemento sob o TRANSITION elemento para aplicá-lo, 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 no REASON e DEFAULTREASON elementos.

Especificar uma lista

Listas de campo são compostas de itens de lista individuais. Lista cada campo deve conter pelo menos um item.

Dica

As listas globais não devem incluir grupos com escopo do projeto porque eles não têm escopo para um projeto.

Para especificar itens em uma lista de campos, use o <LISTITEM value=""> elemento. 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" />

Dica

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

Especificar um conjunto de valores permitidos

Neste exemplo, o campo de severidade de cliente pode ter qualquer um dos três valores: emergência, principais e secundárias. O campo é 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 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>