导入和导出全局工作流 [witadmin]
通过使用全局工作流，你可以最大程度地减少定义和更新多个团队项目和工作项类型共享的工作项字段和全局列表所需的工作量。 借助全局工作流，你可以定义和更新字段和全局列表。 通过使用 witadmin 命令行工具中的以下命令，可管理团队项目集合或团队项目的全局工作流：
exportglobalworkflow：将全局工作流导出到 XML 文件或命令提示符窗口。
importglobalworkflow：从 XML 文件导入全局工作流。
若要运行 witadmin 命令行工具，请在安装了 Visual Studio 或团队资源管理器的情况下打开命令提示符窗口，然后输入：
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
在 32 位版本的 Windows 上，将 %programfiles(x86)% 替换为 %programfiles%。
有关全局工作流的更多信息，请参见自定义全局工作流。
要求
要导出全局工作流，你必须是团队项目或团队项目集合的有效用户。
要将全局工作流导入团队项目，你必须是以下安全组的成员：“Team Foundation 管理员”、“项目集合管理员”或“项目管理员”。
要将全局工作流导入团队项目集合，你必须是“Team Foundation 管理员”或“项目集合管理员”的成员。
请参阅Team Foundation Server 权限参考。
备注
即使你以管理权限登录，也必须打开提升的命令提示符窗口，以在运行 Windows Server 2008 的服务器上执行此功能。若要打开提升的命令提示符窗口，请选择“开始”，打开“命令提示符”快捷菜单，然后选择“以管理员身份运行”。有关详细信息，请参阅 Microsoft 网站上的以下页面：用户访问控制。
witadmin exportglobalworkflow /collection:CollectionURL [/p:ProjectName] [/f:FileName] [/e:Encoding] [/exportgloballists]
witadmin importglobalworkflow /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:Encoding] [/v]
参数
参数 |
描述 |
|---|---|
/collection:CollectionURL |
指定集合的 URI。 你必须使用以下格式指定 URI：http://ServerName:Port/VirtualDirectoryName/CollectionName 如果不指定虚拟目录，则必须使用以下格式指定 URI： http://ServerName:Port/CollectionName。 |
/p:ProjectName |
可选。 你想要导出或导入全局工作流的团队项目。 此团队项目必须在使用 /collection 参数指定的集合中定义。 如果你并未指定团队项目，则为集合导入或导出全局工作流。 |
/f:FileName |
要导出或导入的全局工作流的 XML 定义文件的路径和名称。 备注 如果客户端计算机正在运行 Windows Vista，你可能没有特定文件夹的权限。如果你尝试将全局列表导出到没有权限的位置，注册表虚拟化技术会自动重定向导出的文件并将其保存到虚拟存储。有关详细信息，请参阅 Microsoft 网站上的以下页面：注册表虚拟化和 Windows Vista 中的通用文件和注册表虚拟化问题。若要避免此重定向，你可以将文件导出到具有权限的位置。 |
/e:Encoding |
可选。 .NET Framework 2.0 编码格式的名称。 指定的编码将用于导出或导入 XML 数据。 例如，/e utf-7 指定 Unicode (UTF-7) 编码。 如果省略此参数，则 witadmin 将尝试检测编码，并且如果检测失败，将使用 UTF-8。 |
/v |
可选。 验证定义全局工作流的 XML，但是不导入定义文件。 |
/exportgloballists |
可选。 导出全局工作流引用的全局列表的定义。 全局列表的定义将嵌入到全局工作流的 XML 定义中。 如果没有指定此参数，就会省略全局列表的定义。 |
/? 或 help |
在“命令提示符”窗口中显示有关命令的帮助。 |
备注
可定义工作项字段，方式是通过全局工作流导入这些工作项字段。 但，你不能通过使用全局工作流来更改现有字段的属性。 如果导入不含 FIELDS 元素的全局工作流，则将删除所有之前为全局工作流导入的规则。 字段定义不会受到影响。
示例
除非另外指定，否则在每个示例中应用下面的值：
集合的 URI：http://AdventureWorksServer:8080/tfs/DefaultCollection
团队项目：Contoso
服务器网站的端口号：8080
导出团队项目的全局工作流的定义
以下为导出团队项目的全局工作流的示例：
witadmin exportglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:Contoso /f:C:myGlobalWorkflow.xml
将全局工作流定义导入团队项目
以下为将全局工作流导入 Contoso 团队项目的示例：
witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:Contoso /f:C:collectionGlobalWorkflow.xml
将全局工作流定义导入集合
以下为将全局工作流导入集合的示例：
witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:collectionGlobalWorkflow.xml