Gerenciar listas globais para tipos de item de trabalho

Artigo
03/22/2013

As listas globais são as listas de opções que você pode incluir em um ou mais campos e tipos de itens de trabalho.Use-os para minimizar o trabalho que é necessário atualizar uma lista que seja compartilhado por vários tipos de itens de trabalho.Porque as listas globais são definidas para uma coleção de projeto de equipe, podem ser incluídas em tipos de itens de trabalho para todos os projetos de equipe dentro da coleção.

Observação
As listas globais não devem incluir grupos de segurança Project- escopo do usuário porque as listas globais não têm o mesmo escopo de equipe se projetar.

Você pode definir uma lista global no seu próprio arquivo de definição, no arquivo de definição para um tipo de item de trabalho, ou no fluxo de trabalho global.A definição de globais - lista gerencia as listas globais que são definidas para uma coleção.A definição de globais - lista usa os seguintes comandos na ferramenta de linha de comando witadmin :

destroygloballist: For uma lista global.
exportgloballist: Exportar as listas globais para um arquivo XML, ou janela do prompt de comando.Exportar um único arquivo, que contém todas as listas globais que foram definidas para a coleção de projeto de equipe.
importgloballist: Importa listas globais de um arquivo XML.Se você tentar importar uma lista global que já existe no servidor, um aviso pergunta se você deseja substituir a lista global que está no servidor.Se você tentar importar uma lista global que não existe, o comando cria uma nova lista global.
listgloballist: Exibe o nome de cada lista global definido no servidor.

Consulte Definir listas globais e Personalizar o fluxo de trabalho global.

Para executar a ferramenta de linha de comando witadmin , abra uma janela de prompt de comando onde Visual Studio ou Team Explorer sejam instalados e insira:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

Em uma edição de 64 bits do Windows, substitua %programfiles% com %programfiles(x86)%.

Observação
Você pode criar e modificar listas globais usando o editor do processo, uma ferramenta elétrica para Visual Studio.Essa ferramenta não é suportada.Para obter mais informações, consulte a seguinte página no site da Microsoft: Ferramentas poderosas do Team Foundation Server.

Requisitos

Para o projeto de equipe a coleção onde as listas globais são definidas, você deve ter as permissões definidas seguintes:

Para exportar ou liste listas globais, você deve ser um membro do grupo de Usuários válidos da Coleção de Projetos ou ter sua permissão definida de Exibir informações em nível de coleção Permitir
Para importar ou destruir listas globais, você deve ser um membro do grupo de segurança Administradores do Team Foundation ou grupo de segurança de Administradores do Projeto .

Consulte Team Foundation Permissões do servidor e Team Foundation Funções, permissões e grupos do servidor padrão.

Observação
Mesmo se você fizer logon com permissões administrativas, você deve abrir uma janela de prompt de comando alto para executar esta função em um servidor que esteja executando Windows Server 2008.Para abrir uma janela de prompt de comando, escolha Iniciar, abra a janela de atalho de Prompt de comando , e escolha Executar como administrador.Para obter mais informações, consulte esta página no site da Microsoft: Controle de acesso de usuário.

Mesmo se você fizer logon com permissões administrativas, você deve abrir uma janela de prompt de comando alto para executar esta função em um servidor que esteja executando Windows Server 2008.Para abrir uma janela de prompt de comando, escolha Iniciar, abra a janela de atalho de Prompt de comando , e escolha Executar como administrador.Para obter mais informações, consulte esta página no site da Microsoft: Controle de acesso de usuário.

witadmin destroygloballist /collection:CollectionURL /n:GlobalListName [/noprompt] [/force]

witadmin exportgloballist /collection:CollectionURL [/f:FileName] [/e:Encoding] 

witadmin importgloballist /collection:CollectionURL /f:FileName [/e:Encoding]

witadmin listgloballist /collection:CollectionURL

Parâmetros

Parâmetro	Descrição
/collection:CollectionURL	Especifica a URL a coleção de projeto de equipe.O formato para o URI é o seguinte: http://ServerName:Port/VirtualDirectoryName/CollectionName Se nenhum diretório virtual é usado, o formato para o URI é o seguinte: http://ServerName:Port/CollectionName.
/n:GlobalListName	O nome da lista global destrui-lo.
/f:FileName	O caminho e o nome do arquivo XML global da definição da lista importar ou exportar. Observação Se o computador cliente executa Windows Vista, você pode não ter permissões a determinadas pastas.Se você tentar exportar a lista global em uma localidade onde você não tem permissões, a tecnologia virtualização do Registro automaticamente redireciona o arquivo exportado e o salva no armazenamento virtual.Para obter mais informações, consulte as seguintes páginas no site da Microsoft: Virtualização do Registro e Problemas de virtualização de arquivo comum e do Registro no Windows Vista.Para evitar essa redirecionamento, você pode exportar o arquivo para um local onde você tenha permissões.
/e:Encoding	O nome de .NET Framework 2.0 que codifica o formato.A codificação especificada será usada para importar ou exportar os dados XML.Por exemplo, /e utf-7 especificar a codificação Unicode (UTF-7).Se você omitir este parâmetro, witadmin tenta detectar a codificação, e se a detecção falhar, witadmin usa UTF-8.
/noprompt	Desativa o aviso para a confirmação.
/?ouhelp	Exibe ajuda sobre o comando na janela do prompt de comando.

Comentários

Importar uma lista global cria uma lista se não existir uma.Se a lista já existir, o comando de witadmin importgloballist adverti-lo-á que a lista atual será substituída.Você pode escrever seu próprio programa para atualizar uma lista global existente, ou você pode atualizar a lista global você mesmo com os novos dados.

Para criar uma nova lista global, inicie com o seguinte código e altere-o quando necessário.Este exemplo define uma lista global de disciplinas que você pode atribuir às tarefas.

<?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
    <GLOBALLIST name="Disciplines">
        <LISTITEM value="Architecture" />
        <LISTITEM value="Requirements" />
        <LISTITEM value="Development" />
        <LISTITEM value="Release Management" />
        <LISTITEM value="Project Management" />
        <LISTITEM value="Test" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

Para adicionar uma lista global para um campo, exportar a definição para o tipo de item de trabalho que contém o campo e o adiciona à definição de campo, conforme mostrado no exemplo o seguir:

<FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES>
     <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

Para exibir alterações, para importar o definição de tipo e para atualizar o cache do navegador ou cliente.Talvez seja necessário fechar todos os itens de trabalho que referenciarem o campo e os reabrirem.

Para obter informações sobre a exportar e importar de definições de tipos, consulte Personalizar e gerenciar tipos de item de trabalho [witadmin].

Exemplos

Salvo indicação caso contrário, os seguintes valores se aplicam em cada exemplo:

URI para a coleção de projeto de equipe: http://AdventureWorksServer:8080/tfs/DefaultCollection
Número de porta do site do servidor: 8080

Exibir os nomes de listas globais

O exemplo a seguir mostra as listas globais definidas no servidor.O exemplo exportar as listas globais usando a codificação UTF-8 padrão:

witadmin listgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Exportar a definição de listas globais

O exemplo a seguir exporta as listas globais:

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

O exemplo a seguir exporta as mesmas listas globais para o mesmo servidor, mas a codificação Unicode usos (UTF-7):

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e:utf-7

Importar a definição de listas globais

O exemplo a seguir importa listas globais:

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

O exemplo a seguir importa as mesmas listas globais para o mesmo servidor, mas a codificação Unicode usos (UTF-7):

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e utf-7

Consulte também

Conceitos

Definir listas globais

Outros recursos

Personalizar o fluxo de trabalho global

witAdmin: personalizar e gerenciar objetos para monitorar itens de trabalho

Compartilhar via