Compartilhar via

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

  • Artigo

Listas globais são listas de opções que podem ser incluídas em um ou mais campos e tipos de itens de trabalho. Usá-los para minimizar o trabalho que é necessário para atualizar uma lista que é compartilhada por vários tipos de itens de trabalho. Como as listas globais são definidas para uma coleção de projetos de equipe, elas podem ser incluídas em tipos de item de trabalho para todos os projetos de equipe dentro da coleção.

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

  • destroygloballist: Destrói a uma lista global.

  • exportgloballist: Exporta as listas globais para um arquivo XML ou na janela de Prompt de comando. Exporta um único arquivo, que contém todas as listas globais que foram definidas para a coleção de projetos de equipe.

  • importgloballist: Importa listas globais de um arquivo XML. Se você tentar importar uma lista global que já existe no servidor, uma mensagem pergunta se você deseja substituir a lista global no servidor. Se você tentar importar uma lista global que ainda não existir, o comando cria uma nova lista global.

  • listgloballist: Exibe o nome de cada lista global definida no servidor.

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

Para executar a ferramenta da linha de comandos witadmin, abra uma janela do Prompt de Comando em que Visual Studio ou Team Explorer esteja instalado e insira:

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

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

Dica

Você pode criar e modificar listas globais usando o Editor de processo, uma poderosa ferramenta para Visual Studio.Para obter mais informações, consulte Team Foundation Server Power Tools.

Requisitos

Para a coleção de projetos de equipe em que as listas globais são definidas, você deve ter as seguintes permissões definido:

  • Para exportar ou relacionar listas globais, você deve ser um membro do usuários válidos da coleção de projeto agrupar ou ter seu exibir informações de nível de conjunto permissão definida como permitir.

  • Para importar listas globais, você deve ser um membro do administradores do projeto segurança agrupar ou ter seu editar informações de nível de projeto permissão definida como permitir.

  • To destroy a global list using witadmin destroygloballist, you must be a member of the Project Collection Administrators security group or have your Edit collection-level information permission set to Allow.

Consulte Referência de permissões para o Team Foundation Server.

Dica

Mesmo que faça logon com permissões administrativas, você deve abrir uma janela elevada do Prompt de Comando para executar essa função em um servidor que esteja executando Windows Server 2008.Para abrir uma janela de Prompt de comando elevada, escolha iniciar, abra a Prompt de comando janela de atalho 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 o URI da coleção de projeto de equipe. O formato do URI é o seguinte: http://ServerName:Port/VirtualDirectoryName/CollectionName

Se nenhum diretório virtual for usado, então o formato do URI será o seguinte:

http://ServerName:Port/CollectionName.

/n:GlobalListName

O nome da lista global para destruir.

/f:FileName

O caminho e o nome do arquivo de definição XML lista global para exportar ou importar.

Dica

Se o computador cliente executar Windows Vista, talvez você não tenha permissões para determinadas pastas.A tecnologia de virtualização de registro redireciona o arquivo exportado e o salva no repositório virtual, automaticamente, caso tente exportar a lista global para um local para o qual você não tenha permissões.For more information, see the following pages on the Microsoft Web site: Registry Virtualization and Common file and registry virtualization issues in Windows Vista.Para evitar esse redirecionamento, exporte o arquivo para um local em que tenha permissões.

/e:Encoding

O nome de um formato de codificação .NET Framework 2,0. A codificação especificada será usada para exportar ou importar os dados XML. Por exemplo, /e utf-7 especifica codificação Unicode (UTF-7). Se você omitir esse parâmetro, witadmin tenta detectar a codificação, e se a detecção de falha, witadmin usa UTF-8.

/noprompt

Desabilita o prompt para confirmação.

/? ou help

Exibe ajuda sobre o comando na janela Prompt de comando.

Comentários

Importar uma lista global cria uma lista, se ainda não existir. Se a lista já existir, o witadmin importgloballist comando avisará 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 com os novos dados.

Para criar uma nova lista global, comece com o código a seguir e modificá-lo conforme necessário. Este exemplo define uma lista global de disciplinas que podem ser atribuídos a 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>

Não inclua os grupos de segurança no escopo do projeto em uma lista global, porque as listas globais limitam-se a uma coleção e não em um projeto.

Para adicionar uma lista global para um campo, exporte a definição para o tipo de item de trabalho que contém o campo e adicioná-la à definição de campo, conforme mostrado no exemplo a 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 as alterações, importe a definição de tipo e atualizar seu navegador ou o cache do cliente. Você pode precisar fechar qualquer item de trabalho que fazem referência o campos e abri-los.

Para obter informações sobre exportação e importação de definições de tipo, consulte Importar, exportar e gerenciar tipos de item de trabalho [witadmin].

Exemplos

A menos que especificado de outra forma, os seguintes valores se aplicam a cada exemplo:

  • URI da coleção do projeto de equipe: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Número da porta do servidor Web site: 8080

Exibir os nomes das listas globais

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

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

Exporte a definição das 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 no mesmo servidor, mas usa codificação Unicode (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 no mesmo servidor, mas usa codificação Unicode (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 acompanhar trabalho