Personalizar e gerenciar tipos de link

Artigo
03/22/2013

Semelhante aos tipos de item de trabalho, você pode definir e modificar os tipos de link personalizados.No entanto, você não poderá fazer alterações aos tipos de link sistema definidos.Antes de adicionar um novo tipo de link a sua coleção de projeto de equipe, revise os tipos de link disponíveis para seu uso.Consulte Vincular itens de trabalho e objetos para dar suporte à rastreabilidade.

Você gerencia os tipos de link definidos para uma coleção de projeto de equipe usando os seguintes comandos de witadmin :

deactivatelinktype: Desativa o tipo de link especificado.Os usuários não poderão criar links desse tipo.Links existentes desse tipo continuarão a funcionar corretamente.
deletelinktype: Remover permanentemente o tipo de link especificado do banco de dados.Todos os links definidos com esse tipo de link são removidos também.
exportlinktype: Exportar as definições de tipos de link.Você pode exportar a definição de único tipo de link ou todos os tipos de link definido para o servidor.
importlinktype: Importar definições de tipos de link de um arquivo XML.Se um tipo de link com o mesmo nome de referência já existir, ele será atualizado para corresponder ao tipo de link importado.Se o tipo de link não existir, um novo tipo de link será criado.
listlinktypes: O conjunto disponível lista de tipos de link em um servidor.
reactivatelinktype: Reactivates o tipo de link especificado, e opcionalmente atribui um novo nome.

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)%.

Requisitos

Para a coleção de projeto de equipe onde os tipos de link são definidos, você deve ter as permissões definidas seguintes:

Para listar ou exportar tipos de link, você deve ter sua permissão de Visualizar informações em nível de projeto para um projeto de equipe no conjunto da coleção Permitir.
Para excluir, para importar, ou tipos de link reactivos, você deve ser um membro do grupo de segurança Administradores da Coleção de Projetos ou ter sua permissão definida para Gerenciar tipos de link de item de trabalho a Permitir.

Para obter mais informações, 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 o menu de atalho de Prompt de comando , e então escolha Executar como administrador.Para obter mais informações, consulte o 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 o menu de atalho de Prompt de comando , e então escolha Executar como administrador.Para obter mais informações, consulte o site da Microsoft: Controle de acesso de usuário.

witadmin deactivatelinktype /collection:CollectionURL /n:LinkName

witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]

witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding] 

witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]

witadmin listlinktypes /collection:CollectionURL

witadmin reactivatelinktype /collection:CollectionURL /n:LinkName

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 Por exemplo: http: //ServerName: 8080/tfs/Collection0 Se um diretório virtual não é usado, o formato para o URI é o seguinte: http://ServerName:Port/CollectionName
/n:LinkName	O nome ou o nome da referência de tipo de link para desativar ou excluir.
/f:FileName	O arquivo XML de tipos de link.Necessário para importação, opcional para exportação.Se você omitir este parâmetro, a saída do comando aparecem na exibição.
/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.
/v	Valida o tipo de link XML sem importá-lo.
/noprompt	Desativa o aviso para a confirmação.
/?ou help	Exibe ajuda sobre o comando na janela do prompt de comando.

Comentários

Para a estrutura do esquema de definição de tipo de link, consulte Referência de elementos de tipo de link.

Para obter informações sobre como você pode restringir os tipos de relações de link que os membros da equipe podem fazer, consulte Referência de campo, restrições e vincular controles e Elementos de LinksControlOptions.

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
Nome do servidor: AdventureWorksServer
Nome de arquivo de entrada ou saída: myLinkTypes.xml
Nome do tipo de link: mylinktype
Codificação padrão: UTF-8

Tipos de link de lista

O comando a seguir exibe os tipos de link personalizados definidos para Team Foundation AdventureWorksServer.

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

Listar a definição de um tipo de link

O exemplo seguinte exibe a definição de link na janela do prompt de comando:

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

Desativar e reativar em um tipo de link

Os exemplos a seguir desativa o tipo de link, mylinktype, e reativar o:

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype

Exportar a definição de um tipo de link

O comando a seguir exporta a definição de todos os tipos de link para o arquivo, mylinktype.xml:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

Importar definições de tipos de link

O exemplo a seguir importa a definição de tipos de link definidos no arquivo XML:

witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

Consulte também

Conceitos

Referência de elementos de tipo de link

Referência de campo, restrições e vincular controles

Outros recursos

Vincular itens de trabalho e objetos para dar suporte à rastreabilidade

witAdmin: personalizar e gerenciar objetos para monitorar itens de trabalho

Compartilhar via