Personalizando e tipos de Item de trabalho Gerenciando
Você pode gerenciar os tipos de item de trabalho para um projeto de equipe usando o seguinte witadmin comandos:
destroywitd: Destrói um tipo de item de trabalho e destrói a cada item de trabalho desse tipo permanentemente sem recuperação.
exportwitd: Exporta a definição de um tipo de item de trabalho para um arquivo XML ou para a janela do Prompt de comando.
importwitd: Importações de item de trabalho tipos a partir de um arquivo de definição XML em um projeto de equipe em um servidor que executa o Team Foundation Server. Se um tipo de item de trabalho com o mesmo nome já existir, a nova definição de tipo de item de trabalho sobrescreve o existente. Se o tipo de item de trabalho ainda não existir, esse comando cria um novo tipo de item de trabalho. Para validar o XML que define um tipo de item de trabalho, mas não importar o arquivo, use o /v opção.
listwitd: Exibe os nomes dos tipos de item de trabalho no projeto especificado na janela do Prompt de comando.
renamewitd: Altera o nome de exibição de um tipo de item de trabalho dentro de um projeto específico. Depois de executar este comando, itens de trabalho de apresentação deste tipo o novo nome.
O witadmin o utilitário de linha de comando está localizado na da unidade:\Arquivos de Programas\Microsoft 10.0\Common7\IDE de Visual Studio no computador cliente que executa o Team Explorer.
Para obter mais informações sobre os tipos de item de trabalho, consulte Adicionar um tipo de Item de trabalho a um modelo de processo.
.gif "Observação") Observação |
|---|
Você pode criar e modificar os tipos de item de trabalho usando o Process Editor, uma ferramenta de alimentação para Visual Studio. Essa ferramenta não é suportada. Para obter mais informações, consulte a seguinte página no site da Microsoft: Team Foundation Server Power Tools em abril de 2010. |
Permissões necessárias
Para o projeto de equipe, onde são definidos os tipos de item de trabalho, você deve ter as seguintes permissões definidas:
Para exportar ou lista de tipos de item de trabalho, você deve ser um membro da leitores do grupo ou ter sua Exibir itens neste aceno de trabalhoe a permissão definida como Permitir
Destruir, importar, ou renomear tipos de item de trabalho, você deve ser um membro da Os administradores do Team Foundation o grupo de segurança ou o Administradores de projeto o grupo de segurança.
For more information, see Permissões de Team Foundation Server and Team Foundation Server de grupos, permissões e funções.
| Observação |
|---|
Mesmo se fizer logon com permissões administrativas, você deve abrir uma janela de Prompt de comando com privilégios elevados para executar essa função em um servidor que esteja executando o Windows Server 2008. Para abrir uma janela de Prompt de comando com privilégios elevados, clique em Iniciar, com o botão direito o Prompt de comandoe clique em Executar como administrador. Para obter mais informações, consulte o site da Microsoft: O controle de acesso do 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
Parameter |
Description |
|---|---|
/collection:CollectionURL |
Especifica o URI da coleção de projeto de equipe. O formato para o URI é o seguinte: http: / /Nome_do_servidor: port/VirtualDirectoryName/NomeDaColeta Se nenhum diretório virtual é usado, o formato para o URI é o seguinte: http: / /Nome_do_servidor: port / NomeDaColeta |
/p:Project |
O projeto de equipe para os quais os tipos de itens de trabalho são a serem gerenciados. O projeto de equipe deve ser definido na coleção do projeto especificada pelo /collection parâmetro. O /p parâmetro é obrigatório, a menos que você execute o importwitd comando com o /v opção. |
/n:TypeName |
O nome do tipo de item de trabalho para destruir, exportar, importar ou renomear. |
/f:FileName |
O caminho e o nome do arquivo de definição XML que contém os tipos de itens de trabalho a ser exportado ou importado. Se você omitir esse parâmetro quando você usa o exportwitd comando, o XML é exibido na janela de Prompt de comando. Observação
Se você estiver usando Windows Vista talvez você não tenha permissões para determinadas pastas.Se você tentar exportar o tipo de item de trabalho para um local onde você não tem permissões, a tecnologia de virtualização do registro automaticamente redireciona o arquivo exportado e salva-lo no armazenamento virtual.Para evitar esse redirecionamento, você pode exportar o arquivo para um local onde você tem permissões. Para obter mais informações sobre a virtualização de registro, consulte o site da Microsoft: Virtualização de registro e problemas comuns de virtualização de arquivo e registro no Windows Vista.
|
/e:Codificação |
O nome de um .NET Framework 2.0 codificação formato. O comando usa a codificação especificada para exportar ou importar os dados XML. Por exemplo, /e:utf-7 Especifica a 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. |
/exportgloballists |
Exporta as definições de listas globais referenciadas pelo tipo de item de trabalho. As definições de listas globais serão incorporadas na definição de tipo de item de trabalho XML. Quando não especificado, as definições de listas globais são omitidas. |
/v |
Valida o XML que define o tipo de item de trabalho, mas não importa o arquivo de definição XML. Observação
Você pode validar a definição de tipo sem especificar um projeto de equipe.Referências a grupos com escopo de projeto é ignorado.
|
/new:Novo_nome |
O novo nome do tipo de item de trabalho. |
/noprompt |
Desativa o prompt de confirmação. |
/? ouhelp |
Exibe ajuda sobre o comando na janela do Prompt de comando. |
Comentários
Quando você usa o destroywitd de comando, ele destrói os seguintes objetos:
O tipo de item de trabalho
Todos os itens desse tipo de trabalho
Entradas correspondentes em tabelas de item de trabalho, as tabelas de texto longo e as tabelas de link
Objetos do item de trabalho digite cache de metadados
Examples
A menos que especificado em contrário, os valores a seguir aplicam-se em cada exemplo:
URI para a coleção de projeto de equipe: http://AdventureWorksServer:8080/AWTeam/Collection1
Nome do projeto: AdventureWorks
Entrada ou saída nome de arquivo: myworkitems.XML
Nome do tipo de item de trabalho: myworkitem
Padrão de codificação: UTF-8
Exportar a definição de um tipo de Item de trabalho
O comando a seguir exporta a definição de myworkitem para o arquivo myworkitems.xml.
witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /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/AWTeam/Collection1 /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7
Exportar a definição de um tipo de Item de trabalho e suas listas de referência globais
O exemplo a seguir exporta o tipo de item de trabalho e suas listas de referência globais.
witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists
A definição de um tipo de Item de trabalho de lista.
O exemplo a seguir exibe a definição do tipo de item de trabalho da janela do Prompt de comando.
witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /n:myworkitem
Importar a definição dos 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/AWTeam/Collection1 /f:myworkitem.xml /p:AdventureWorks
Validar a definição XML de tipos de Item de trabalho
O exemplo a seguir valida o XML que define o tipo de item de trabalho, mas não importar a definição.
witadmin importwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:myworkitem.xml /p:AdventureWorks /v