Team Foundation

Gerenciando "Global Lists" no TFS

Neste artigo demonstrar como adicionar, atualizar e excluir uma determinada lista global (global list) para uma determinada coleção do Team Foundation.

Segundo a Microsoft, por meio de listas global, você pode minimizar o trabalho que é necessário para atualizar uma lista em que vários tipos de “Work Items” compartilham. Listas globais são listas de seleção que você pode incluir em um ou mais campos e tipos de “Work Item”. Você pode definir listas globais para uma equipe de projeto, uma coleção de equipe de projeto, um modelo de processo, ou fluxo de trabalho global.

É possível definir uma lista global no seu próprio arquivo de definição, em um para um tipo de “Work Item”, ou no “Work Flow” global. Quando você usa a definição de lista global, você pode gerenciar as listas globais que estão definidas para uma coleção usando os seguintes comandos na ferramenta “witadmin” através da seguinte linha de comando:

destroygloballist:  Exclui uma determinada lista global.

exportgloballist: Exportações das listas globais para um arquivo XML, ou para a janela do Prompt de Comando.
importgloballist: Importações das listas globais de um arquivo XML. Se você tentar importar uma lista global que já existe no servidor, um aviso perguntando se você deseja substituir o que está no servidor. Se você tentar importar uma lista global que já não existe, o comando cria uma nova lista global.
listgloballist: Exibe o nome de cada lista global definido no servidor.
O utilitário de linha de comando witadmin  está localizado no seguinte caminho “Drive: \ Program Files \ Microsoft Visual Studio 10.0 \ Common7 \ IDE” no computador cliente que executa o Team Explorer. Para máquinas de 64 bits, a ferramenta está no “Drive: \ Program Files (x86) \ Microsoft Visual Studio 10.0 \ Common7 \ IDE“.
Para que a ferramenta funcione de forma correta, você deverá ter alguns privilégios. Para a coleção de projeto de equipe, onde as listas globais são definidas, você deve ter o conjunto de permissões a seguir:
  • Para exportar ou listar listas globais, você deve ser membro do grupo “Readers” ou ter seus “View Work Items” devem estar ajustados para “Alow”.
  • Para destruir ou importar listas global, você deve ser um membro do grupo de segurança do “Team Foundation Administrators”  ou do grupo de segurança “Project Administrators”.
É importante frisar que mesmo se você fizer logon com permissões administrativas, você deve abrir uma janela de prompt de comando em nível elevado para executar essa função em um servidor que está executando o Windows Server 2008. Para abrir uma janela de Prompt de Comando privilegiada, clique em Iniciar, clique com Prompt de Comando e selecione Executar como Administrador.
Exemplos de linha de comando:
destroygloballist
witadmin destroygloballist /collection:CollectionURL /n:GlobalListName [/noprompt] [/force]
exportgloballist
witadmin exportgloballist /collection:CollectionURL [/f:FileName] [/e:Encoding]
importgloballist
witadmin importgloballist /collection:CollectionURL /f:FileName [/e:Encoding]
listgloballist
witadmin listgloballist /collection:CollectionURL
Abaixo segue um exeplo de como utilizar o comando:

Exibindo os nomes das Listas Globais

O exemplo a seguir mostra as listas globais definidas no servidor. O exemplo exporta as listas global usando o padrão UTF-8 encoding.
witadmin listgloballist /collection:http://ServidorTFS:8080/tfs/Collection1

Exportar a definição de listas globais

O exemplo a seguir exporta a lista global.
witadmin exportgloballist /collection:http://ServidorTFS:8080/tfs/Collection1 /f:mygloballists.xml
O exemplo a seguir exporta as mesmas listas globais para o mesmo servidor, mas usa a codificação Unicode (UTF-7):
witadmin exportgloballist /collection:http://ServidorTFS:8080/tfs/Collection1 /f:mygloballists.xml /e:utf-7

Importar a definição de listas globais

O exemplo a seguir importa lista global.
witadmin importgloballist /collection:http://ServidorTFS:8080/tfs/Collection1 /f:mygloballists.xml
O exemplo a seguir importa as mesmas listas globais para o mesmo servidor, mas usa a codificação Unicode (UTF-7).
witadmin importgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:mygloballists.xml /e utf-7
Espero que tenham gostado do artigo. Qualquer questão, me escreva.
Márcio Pulcinelli @ OminaVincit!

Como Excluir Coleções do Team Foundation

SNAGHTML8ee9e4Neste artigo vou apresentar como excluir uma coleção do Team Foundation. Para isso, vamos em primeiro lugar verificar o nome de nossas coleções.

 

 

 

 

Vamos abrir o Team Foundation Server Administration Console.

SNAGHTML91e477

Assim que você clicar no ícone acima, a seguinte tela deverá se abrir.

SNAGHTML94fce7

Na imagem acima vemos duas coleções criadas, vamos então excluir a coleção “ProjetoTesteCollection”.

Para excluir uma coleção no TFS 2010, precisamos fazer isso através de linha de comando. O comando utilizado para tal é o TFSCONFIG COLLECTION.

TFSConfig Collection {/attach | /detach | /delete} [/collectionName:CollectionName] [/collectionDB:ServerName;DatabaseName] [/clone]

SNAGHTML9af4fb

Abra o prompt de comando conforme imagem acima e entre na pasta do Team Foundation:

SNAGHTML9d89ab

Digite a seguinte linha de comando:

TFSConfig Collection  /delete /collectionName:ProjetoTesteCollection

SNAGHTMLa04e51

Assim que digitar a linha de comando e pressionar <Enter>, o TFSConfig deverá perguntar se é realmente isso que você deseja fazer, conforme a imagem abaixo:

SNAGHTMLa368d3

Digite “Yes” e o TFSConfig excluirá sua coleção. Veja abaixo:

SNAGHTMLa67283

A partir deste momento sua coleção não mais existe no servidor do TFS assim como todos os projetos que existiam dentro desta coleção. É importante frisar que os sites do SharePoint não serão excluídos e nem a base de dados que foi criada no servidor do SQLServer.

Espero que tenham gostado do artigo. Qualquer dúvida me escreva.

Márcio Pulcinelli @ OminaVincit