Definir listas globais

Usando listas globais em Team Foundation Server (TFS), você pode minimizar o trabalho que é necessário atualizar uma lista que vários tipos de itens de trabalho compartilharem.As listas globais são as listas de opções que você pode incluir dentro de um ou mais campos e tipos de item de trabalho.Você pode definir uma lista global em um tipo de item de trabalho que você adiciona a um projeto de equipe, como uma lista global para uma coleção de projeto de equipe, ou em um fluxo de trabalho global.Você pode compartilhar itens de lista entre vários tipos de itens de trabalho para uma coleção incluindo os itens em um ou mais elementos de GLOBALLIST .

Como você define tipos de itens de trabalho, você pode achar que alguns campos compartilham os mesmos valores.Geralmente, você pode compartilhar através de vários tipos de itens de trabalho e mesmo através de vários projetos de equipe.Alguns desses valores, como o número de noites, mudam frequentemente, que requer um administrador atualizar geralmente essas listas em vários locais.As listas globais podem ser especialmente úteis quando uma lista deve ser derivada de um sistema externo.Por exemplo, suponha que uma empresa mantém um banco de dados separado do cliente.Quando você fazer o check-in particular de um bug que um cliente descoberto, o nome do cliente está inserido em um campo personalizado de Found By Customer .

Você pode gerenciar listas globais para uma coleção como um arquivo XML que você pode listar, importar, exportar, e excluir.O nome de cada lista global pode ter até 254 caracteres Unicode e deve ser exclusivo dentro de uma coleção.

ObservaçãoObservação

Não há nenhuma lista global sistema definida, nem uma lista globais predefinidas nos modelos padrão do processo que fornece TFS.

Neste tópico

  • Adicionando e gerenciando listas globais

  • Estrutura de sintaxe para definir listas globais

  • Estrutura de sintaxe de listas globais adicionadas a uma definição de tipo de item de trabalho ou um fluxo de trabalho global

  • Estrutura de sintaxe de listas globais mantidas para uma coleção

ObservaçãoObservação

Para adicionar ou modificar uma lista global, usar a ferramenta de linha de comando witadmin para exportar e importar a definição para listas globais.Consulte Gerenciar listas globais para tipos de item de trabalho [witadmin].Para usar uma lista global, adicioná-la à definição de FIELD dentro de um tipo de item de trabalho.Consulte Todas as referências de elementos do campo XML.

Adicionando e gerenciando listas globais

Uma lista global é um conjunto de elementos de LISTITEM que é armazenado e usado global por todos os projetos de equipe de uma coleção.As listas globais são úteis para os campos que são definidos em vários tipos de itens de trabalho, como o sistema operacional, encontrados na compilação, e corrigidos na compilação.

Você pode definir listas globais e seus itens usando um dos seguintes métodos:

  • Modelo de processo: Você pode definir listas globais dentro da definição para um tipo de item de trabalho em um modelo de processo.Cada projeto de equipe que é criado desse modelo tem acesso às listas globais.

  • Coleção de projeto de equipe: Você pode exportar, modificar, excluir, e importar as listas globais que são definidas para uma coleção de projeto 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 você deseja ter disponível para um tipo de item de trabalho a sua definição.

  • Definição global de fluxo de trabalho: Depois que um projeto de equipe é criado, você pode adicionar as listas globais que você deseja ter disponível para todos os tipos de itens de trabalho para a definição global de fluxo de trabalho para um projeto ou uma coleção de equipe.Para obter mais informações, consulte Personalizar o fluxo de trabalho global .

De volta ao topo

Estrutura de sintaxe para definir listas globais

A tabela a seguir descreve os elementos de GLOBALLIST e de LISTITEM .Você pode usar esses elementos para enumerar uma lista de valores que é apresentada ao usuário como uma lista de opções ou um menu drop-down de itens.

Elemento

Sintaxe

Descrição

GLOBALIST

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

Define um conjunto de elementos de LISTITEM que sejam armazenados para uma coleção e que todos os projetos de equipe de uma coleção podem usar.

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

GLOBALLIST é necessário um elemento filho do elemento de GLOBALLISTS e um elemento filho opcional de ALLOWEDVALUES, de SUGGESTEDVALUES, e elementos de PROHIBITEDVALUES .Para obter mais informações, consulte Definir listas de opções.

LISTITEM

<LISTITEM value="Name" />

Define um valor válido da lista.

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

LISTITEM é um filho de GLOBALLIST necessário e um elemento filho opcional de ALLOWEDVALUES, de SUGGESTEDVALUES, e elementos de PROHIBITEDVALUES .

De volta ao topo

Estrutura de sintaxe de listas globais adicionadas a uma definição de tipo de item de trabalho ou um fluxo de trabalho global

Adicionando a seguinte sintaxe, você pode definir uma lista global em um arquivo de definição de XML para um tipo de item de trabalho ou 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>

Usando a seguinte sintaxe, você pode fazer referência a uma lista global em um arquivo de definição de 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 o local de arquivos de definição para tipos de itens de trabalho ou de fluxo de trabalho global, consulte Todas as referências de elementos XML WITD ou Referência de elemento XML de fluxo de trabalho global, respectivamente.

De volta ao topo

Estrutura de sintaxe de listas globais mantidas para uma coleção de Projeto

Para adicionar uma lista global para uma coleção de projeto, você pode importar a seguinte sintaxe usando o comando de 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 ser vazia.Cada elemento de GLOBALLIST deve ter pelo menos um elemento de LISTITEM definido.

De volta ao topo

Consulte também

Referência

Gerenciar listas globais para tipos de item de trabalho [witadmin]

Conceitos

Personalizar dados de acompanhamento de projeto, formulários, fluxo de trabalho e outros objetos

Definir listas de usuários, listas de opções e listas globais

Outros recursos

Personalizar o fluxo de trabalho global