Definir listas globais
Usando listas globais em Team Foundation Server (TFS), você pode minimizar o trabalho necessário para atualizar uma lista que aparece nas definições de vários tipos de item de trabalho (WITs). Listas globais são listas de opções que podem ser incluídas em um ou mais campos e definições de WIT. Você pode definir uma lista global dentro de um WIT que você adicionar a um projeto de equipe, como uma lista global para uma coleção de projetos de equipe ou dentro de um fluxo de trabalho global. Você pode compartilhar itens de lista entre vários WITs para uma coleção, incluindo os itens da lista em um ou mais GLOBALLIST elementos.
Conforme você define os WITs, você pode descobrir que alguns campos compartilham os mesmos valores. Freqüentemente, você pode compartilhar entre vários WITs e até mesmo vários projetos de equipe. Alguns desses valores, como o número de compilações noturnas, mudam com frequência, exigindo que o administrador atualize frequentemente essas listas em vários locais. As listas globais podem ser especialmente úteis quando uma lista precisar ser derivada de um sistema externo. Por exemplo, suponha que uma empresa mantém um banco de dados de cliente separado. Quando você arquiva um bug descoberto por um cliente, o nome do cliente é inserido no campo Found By Customer personalizado.
Você pode gerenciar listas globais de uma coleção como um arquivo XML que pode ser listado, importado, exportado e excluído. O nome de cada lista global pode ter até 254 caracteres Unicode e deve ser exclusivo dentro de uma coleção.
Dica
Não existem listas globais definidas no sistema, nem listas globais predefinidas nos modelos de processo padrão que o TFS fornece.
Requisitos
Para exportar ou relacionar listas globais, você deve ser membro do grupo de usuários válidos da coleção de projeto ou ter sua permissão de informações de nível de coleção de exibição definida como permitir.
Para definir ou editar listas globais, você deve ser membro do grupo Administradores do projeto ou ter a permissão para editar as informações de nível de projeto definida como permitir.
Para adicionar ou modificar uma lista global, use a ferramenta de linha de comandos witadmin para importar e exportar a definição para listas globais. Consulte Gerenciar listas globais para tipos de item de trabalho [witadmin]. Para usar uma lista global, adicione-a à definição FIELD dentro de um tipo de item de trabalho. Consulte Todas as referências de elementos XML FIELD.
Adicione e gerencie listas globais
Uma lista global é um conjunto de elementos LISTITEM que é armazenado e usado globalmente por todos os projetos de equipe em uma coleção. As listas globais são úteis para campos que são definidos dentro de vários tipos de itens de trabalho, como Sistema Operacional, Encontrado na Compilação e Corrigido na Compilação.
Você pode definir listas globais e seus itens usando um dos seguintes métodos:
Coleção de projetos de equipe: você pode exportar, modificar, excluir e importar as listas globais que são definidas para uma coleção de projetos de equipe. Essas listas globais estão disponíveis para todos os projetos de equipe na coleção.
Definição de tipo de item de trabalho: depois que um projeto de equipe é criado, você pode adicionar as listas globais que deseja disponibilizar para um tipo de item de trabalho para sua definição.
Definição de fluxo de trabalho global: depois que um projeto de equipe é criado, você pode adicionar as listas globais que deseja disponibilizar para todos os tipos de itens de trabalho para a definição do fluxo de trabalho global para um projeto de equipe ou uma coleção. Para obter mais informações, consulte Personalizar o fluxo de trabalho global.
Estrutura da sintaxe
A tabela a seguir descreve os elementos GLOBALLIST e LISTITEM. Você pode usar esses elementos para enumerar uma lista de valores, que aparecem como uma lista de opções ou menu suspenso de itens para o usuário.
Elemento |
Sintaxe |
Descrição |
|---|---|---|
GLOBALLIST |
|
Define um conjunto de elementos LISTITEM que é armazenado para uma coleção e que todos os projetos de equipe em uma coleção podem usar. globalListName: uma sequência de caracteres de texto que contém entre 1 e 255 caracteres. GLOBALLIST é um elemento filho obrigatório do elemento GLOBALLISTS e um elemento filho opcional dos elementos ALLOWEDVALUES, SUGGESTEDVALUES e PROHIBITEDVALUES. Para obter mais informações, consulte Definir listas de opções. |
LISTITEM |
|
Define um valor de lista válido. Dica As listas globais não devem incluir grupos com escopo do projeto porque eles não têm escopo para um projeto. LISTITEM é um elemento filho obrigatório de GLOBALLIST e um elemento filho opcional dos elementos ALLOWEDVALUES, SUGGESTEDVALUES e PROHIBITEDVALUES. |
Lista global de amostra
Adicionando-se a sintaxe a seguir, você pode definir uma lista global dentro de um arquivo de definição XML para um tipo de item de trabalho ou um fluxo de trabalho global:
<GLOBALLISTS>
<GLOBALLIST name="name of global list">
<LISTITEM value="List item 1" />
<LISTITEM value="List item 2" />
<LISTITEM value="List item 3" />
<LISTITEM value="List item 4" />
. . .
<LISTITEM value="List item n" />
</GLOBALLIST>
</GLOBALLISTS>
Ao usar a sintaxe a seguir, você pode referenciar uma lista global dentro de um arquivo de definição XML para um tipo de item de trabalho:
<GLOBALLISTS>
<GLOBALLIST name=" name of global list 1" />
<GLOBALLIST name=" name of global list 2" />
. . .
<GLOBALLIST name=" name of global list n" />
</GLOBALLISTS>
Para obter informações sobre a estrutura e a localização de arquivos de definição para tipos de itens de trabalho ou fluxo de trabalho global, veja Todas as referências de elementos XML WITD ou Referência de elemento XML do fluxo de trabalho global, respectivamente.
Lista global de amostras mantida para uma coleção de projetos
Para adicionar uma lista global em uma coleção de projetos, você pode importar a seguinte sintaxe usando o comando witadmin importgloballist:
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/globallists">
<GLOBALLIST name="NameOfGlobalList">
<LISTITEM value="ListItem1" />
<LISTITEM value="ListItem2" />
<LISTITEM value="ListItem3" />
<LISTITEM value="ListItem4" />
. . .
<LISTITEM value="ListItemN" />
</GLOBALLIST>
</gl:GLOBALLISTS>
Uma lista global não pode estar vazia. Cada elemento GLOBALLIST deve ter pelo menos um elemento LISTITEM definido.
Perguntas e respostas
P: Alguma lista global é preenchida automaticamente com dados?
R: Sim. A lista global chamada Compilações – TeamProjectName é anexada sempre que uma compilação for executada. Com o tempo, a lista pode se tornar muito longa. A melhor prática é remover regularmente os itens não usados da lista.
Para saber mais sobre o uso dessa lista, veja Campos que dão suporte à integração com teste, compilação e controle de versão.
Consulte também
Referência
Gerenciar listas globais para tipos de item de trabalho [witadmin]
Conceitos
Personalizar objetos de acompanhamento de trabalho para dar suporte aos processos da sua equipe