Importar e exportar o fluxo de trabalho global [witadmin]
Usando o fluxo de trabalho global, você pode minimizar o trabalho necessário para definir e atualizar campos de item de trabalho e listas globais que compartilham vários projetos de equipe e tipos de itens de trabalho. Com o fluxo de trabalho global, você pode definir e atualizar campos e listas globais. Você pode gerenciar o fluxo de trabalho global para uma coleção de projetos de equipe ou um projeto de equipe usando os seguintes comandos no witadmin ferramenta de linha de comando:
exportglobalworkflow: Exporta o fluxo de trabalho global para um arquivo XML ou a janela do Prompt de comando.
importglobalworkflow: Importa o fluxo de trabalho global de um arquivo XML.
O witadmin ferramenta de linha de comando só funciona quando executado em um TFS local. Para executar a ferramenta, abra uma janela de Prompt de comando onde o Visual Studio ou Team Explorer esteja instalado e digite:
cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE
Em uma edição de 32 bits do Windows, substitua %programfiles(x86)% por %programfiles%.
Para obter mais informações sobre o fluxo de trabalho global, consulte Personalizar o fluxo de trabalho global.
Requisitos
Para exportar um fluxo de trabalho global, você deve ser um usuário válido do projeto de equipe ou coleção de projetos de equipe.
Para importar um fluxo de trabalho global para um projeto de equipe, você deve ser um membro dos seguintes grupos de segurança: administradores do Team Foundation, administradores da coleção de projetos, ou administradores do projeto.
Para importar um fluxo de trabalho global para uma coleção de projetos de equipe, você deve ser um membro do administradores do Team Foundation ou administradores da coleção de projetos.
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 do Prompt de Comando elevado, escolha Iniciar, abra o menu de atalho do Prompt de Comando e, em seguida, escolha Executar como Administrador.Para obter mais informações, consulte a seguinte página no site da Microsoft: o controle de acesso do usuário.
witadmin exportglobalworkflow /collection:CollectionURL [/p:ProjectName] [/f:FileName] [/e:Encoding] [/exportgloballists]
witadmin importglobalworkflow /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:Encoding] [/v]
Parâmetros
Parâmetro |
Descrição |
|---|---|
/collection:CollectionURL |
Especifica o URI da coleção. Você tem que especificar o URI no seguinte formato: http://ServerName:Port/VirtualDirectoryName/CollectionName Se não especificar um diretório virtual, então especifique o URI no seguinte formato: http://ServerName:Port/CollectionName. |
/p:ProjectName |
Opcional. O projeto de equipe para o qual você deseja exportar ou importar o fluxo de trabalho global. Esse projeto de equipe tem que ser definido na coleção especificada usando o parâmetro /collection. Se você não especificar um projeto de equipe, o fluxo de trabalho global é importado ou exportado para a coleção. |
/f:FileName |
O caminho e o nome do arquivo de definição XML para o fluxo de trabalho global exportar ou importar. Dica Talvez você não tenha permissões para certas pastas, caso o computador cliente esteja executando o Windows Vista.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.Para obter mais informações, consulte as seguintes páginas no site da Microsoft: Registry Virtualization e problemas comuns de virtualização de arquivos e do registro no Windows Vista.Para evitar esse redirecionamento, exporte o arquivo para um local em que tenha permissões. |
/e:Encoding |
Opcional. 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 omitir esse parâmetro, o witadmin tenta detectar a codificação e, caso não consiga, usa UTF-8. |
/v |
Opcional. Valida o XML que define o fluxo de trabalho global, mas não importa o arquivo de definição. |
/exportgloballists |
Opcional. Exporta as definições de listas globais que referencia o fluxo de trabalho global. As definições de listas globais serão incorporadas na definição XML do fluxo de trabalho global. Se você não especificar esse parâmetro, as definições de listas globais são omitidas. |
/? ou help |
Exibe ajuda sobre o comando na janela Prompt de comando. |
Comentários
Você pode definir os campos de item de trabalho, importe-as por meio de um fluxo de trabalho global. No entanto, você não pode alterar as propriedades de campos existentes usando o fluxo de trabalho global. Se você importar um fluxo de trabalho global que não contém um FIELDS elemento, todas as regras importados anteriormente para o fluxo de trabalho global será excluído. Definições de campo não serão afetadas.
Exemplos
A menos que especificado de outra forma, os seguintes valores se aplicam a cada exemplo:
URI da coleção: http://AdventureWorksServer:8080/tfs/DefaultCollection
Projeto de equipe: Contoso
Número da porta do site do servidor: 8080
Exporte a definição de um fluxo de trabalho global para um projeto de equipe
O exemplo a seguir exporta o fluxo de trabalho global para um projeto de equipe:
witadmin exportglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:Contoso /f:C:myGlobalWorkflow.xml
Importar a definição de um fluxo de trabalho global para um projeto de equipe
O exemplo a seguir importa o fluxo de trabalho global para o projeto de equipe Contoso:
witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:Contoso /f:C:collectionGlobalWorkflow.xml
Importar a definição de um fluxo de trabalho global para uma coleção
O exemplo a seguir importa o fluxo de trabalho global para a coleção:
witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:collectionGlobalWorkflow.xml
Consulte também
Conceitos
Outros recursos
Personalizar o fluxo de trabalho global
witAdmin: personalizar e gerenciar objetos para acompanhar trabalho