Compartilhar via


Personalizar e gerenciar tipos de item de trabalho

Você pode gerenciar tipos de itens de trabalho para um projeto de equipe usando os seguintes comandos de witadmin :

  • destroywitd:  For um tipo de item de trabalho, e destrói cada item de trabalho do tipo permanentemente sem recuperação.

  • exportwitd:  Exporta a definição de um tipo de item de trabalho a um arquivo XML, ou janela do prompt de comando.

  • importwitd:  Os tipos de itens de trabalho imports de um arquivo de definição XML em um projeto de equipe em um servidor que executa Team Foundation Server.Se um tipo de item de trabalho com o mesmo nome já existir, o definição de tipo de item de trabalho substitui existente.Se o tipo de item de trabalho já não existir, este comando cria um tipo de item de trabalho.Para validar XML que define um tipo de item de trabalho, mas não importar o arquivo, use a opção de /v .

  • listwitd:  Exibe os nomes dos tipos de itens de trabalho no projeto especificado na janela do prompt de comando.

  • renamewitd:  Altera o nome para exibição de um tipo de item de trabalho em um projeto específico.Depois de executar este comando, os itens de trabalho de esse tipo mostram o 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)%.

Para obter mais informações sobre os tipos de itens de trabalho, consulte Adicionar definições de tipo de itens de trabalho a um modelo de processo.

ObservaçãoObservação

Você pode criar e modificar os tipos de itens de trabalho usando o editor do processo, uma ferramenta avançada para Visual Studio.Essa ferramenta não é suportada.Para obter mais informações, consulte a seguinte página no site da Microsoft: Ferramentas eléctricas do Team Foundation Server.

Requisitos

Para o projeto de equipe onde os tipos de itens de trabalho são definidos, você deve ter as permissões definidas seguintes:

  • Para exportar ou liste tipos de item de trabalho, você deve ser um membro do grupo de Administradores de projeto ou ter sua permissão definida de Informações de nível de projeto de exibição a Permitir.

  • Para destruir, para importar, ou renomear tipos de item de trabalho, você deve ser um membro do grupo de segurança Administradores do team foundation ou grupo de segurança de Administradores de projeto .

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çãoObservaçã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 para 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 destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]

witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]

witadmin importwitd /collection:CollectionURL [/p:Project] /f:FileName [/e:Encoding] [/v]

witadmin listwitd /collection:CollectionURL /p:Project

witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]

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: porta/VirtualDirectoryName/CollectionName/

Se nenhum diretório virtual é usado, o formato para o URI é o seguinte:

http:ServerName: porta/CollectionName/

/p:Project

O projeto de equipe que os tipos de itens de trabalho devem ser gerenciados.Este projeto de equipe deve ser definido na coleção do projeto especificado pelo parâmetro de /collection .

O parâmetro de /pé necessária a menos que você executar o comando de importwitd com a opção de /v .

/n:TypeName

O nome do tipo de item de trabalho a destruir, exportar, importar, ou renomear.

/f:FileName

O caminho e nome de arquivo de definição do arquivo XML que contém os tipos de itens de trabalho ou exportados a ser importado.Se você omitir este parâmetro quando você usar o comando de exportwitd , XML aparece na janela do prompt de comando.

ObservaçãoObservação
Se você estiver usando Windows Vista você pode não ter permissões a determinadas pastas.Se você tentar exportar o tipo de item de trabalho a um local 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 evitar essa redirecionamento, você pode exportar o arquivo para um local onde você tenha permissões. Para obter mais informações sobre virtualização do Registro, consulte o site da Microsoft: Virtualização do Registro e Problemas de virtualização de arquivo comum e do Registro no Windows Vista.

/e:Codificação

o nome de .NET Framework 2.0 que codifica o formato.O comando a seguir usa a codificação especificada 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.

/exportgloballists

Exportar as definições de listas globais referenciadas pelo tipo de item de trabalho.As definições para listas globais serão inseridas na definição de tipo de item de trabalho XML.Quando não especificado, as definições para listas globais são omitidas.

/v

Valida XML que define o tipo de item de trabalho, mas não importa o arquivo de definição de XML.

ObservaçãoObservação
Você pode validar a definição de tipo sem especificar um projeto de equipe.As referências aos grupos com escopo do aplicativo são ignoradas.

/new:NewName

O novo nome de tipo de item de trabalho.

/noprompt

Desativa o aviso para a confirmação.

/?ou help

Exibe ajuda sobre o comando na janela do prompt de comando.

Comentários

Quando você usar o comando de destroywitd , destrói os seguintes objetos:

  • O tipo de item de trabalho

  • Todos os itens de trabalho do tipo

  • Entradas correspondentes nas tabelas de item de trabalho, nas tabelas longas de texto, e nas tabelas de link

  • Objetos no cache de metadados de tipo de item de trabalho

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 projeto: AdventureWorks

  • Nome de arquivo de entrada ou saída: myworkitems.xml

  • Nome do tipo de item de trabalho: myworkitem

  • Codificação padrão: UTF-8

Dd312129.collapse_all(pt-br,VS.110).gifExportar a definição de um tipo de item de trabalho

O comando a seguir exporta a definição para o myworkitem para o arquivo, myworkitems.xml.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem

O exemplo a seguir exporta o item de trabalho usando a codificação Unicode (UTF-7).

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

Dd312129.collapse_all(pt-br,VS.110).gifExportar a definição de um tipo de item de trabalho e suas listas globais referenciadas

O exemplo a seguir exporta o tipo de item de trabalho e suas listas globais de referência.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists

Dd312129.collapse_all(pt-br,VS.110).gifListar a definição de um tipo de item de trabalho

O exemplo seguinte exibe a definição do tipo de item de trabalho a janela do prompt de comando.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem

Dd312129.collapse_all(pt-br,VS.110).gifImportar definições de tipos de item de trabalho

O exemplo a seguir importa a definição de item de trabalho do arquivo XML.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks

Dd312129.collapse_all(pt-br,VS.110).gifValidar a definição de XML de tipos de item de trabalho

O exemplo a seguir valida XML que define o tipo de item de trabalho mas não importa a definição.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

Consulte também

Tarefas

Criar um tipo de Item de trabalho

Conceitos

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

Outros recursos

witAdmin: personalizar e gerenciar objetos para monitorar itens de trabalho