管理全局工作流
使用全局工作流,可以将定义和更新由许多团队项目和工作项类型共享的工作项字段和全局列表所需的工作减到最少。 使用全局工作流,您可以定义并更新字段和全局列表。 您可以使用 witadmin 命令行工具中的以下命令来管理团队项目集合或团队项目的全局工作流:
exportglobalworkflow:将全局工作流导出到 XML 文件或命令提示符窗口。
importglobalworkflow:从 XML 文件导入全局工作流。
提示
在定义全局工作流之前,必须在应用层服务器上启用该功能。 因此,服务器必须运行支持该功能的 Visual Studio Team Foundation Server 版本,例如 Team Foundation Server 2010 Service Pack 1 (SP1)。 可以从 Microsoft 网站上的以下页面下载 Service Pack:Visual Studio Team Foundation Server 2010 Service Pack 1 Beta。
您可以在运行 团队资源管理器 的任何计算机上的 驱动器:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE 中找到 witadmin 命令行工具。对于 64 位机器,该工具位于驱动器:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE 中。
有关全局工作流的更多信息,请参见自定义全局工作流。
所需权限
对于定义全局工作流处的团队项目集合,您必须具有以下权限集:
若要导出全局工作流,您必须是团队项目或集合的有效用户。
若要导入全局工作流,您必须是以下安全组的成员:“Team Foundation Administrators(Team Foundation 管理员)”、“Project Administrators(项目管理员)”(将全局工作流导入到团队项目),或**“Project Collection Administrators(项目集合管理员)”**(将全局工作流导入到集合)。
有关更多信息,请参见Team Foundation Server 权限和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]
参数
Parameter |
说明 |
---|---|
/collection:CollectionURL |
指定集合的 URI。 必须使用以下格式指定 URI:http://ServerName:Port/VirtualDirectoryName/CollectionName 如果不指定虚拟目录,则必须指定以下格式的 URI: http://ServerName:Port/CollectionName。 |
/p:ProjectName |
可选。 您想要为其导出或导入全局工作流的团队项目。 必须在使用 /collection 参数指定的集合中定义此团队项目。 如果您不指定团队项目,则将为集合导入或导出全局工作流。 |
/f:FileName |
要导出或导入的全局工作流 XML 定义文件的路径和名称。
注意
如果客户端计算机运行的是 Windows Vista,则您可能没有访问某些文件夹的权限。如果尝试将全局列表导出到您没有权限的位置,注册表虚拟化技术将自动重定向导出的文件,并将其保存到虚拟存储区。有关更多信息,请参见 Microsoft 网站的以下页面:Registry Virtualization(注册表虚拟化)和 Common file and registry virtualization issues in Windows Vista(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/AWTeam/Collection1
团队项目:Contoso
服务器网站的端口号:8080
导出团队项目的全局工作流的定义
下面的示例将导出团队项目的全局工作流:
witadmin exportglobalworkflow /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:Contoso /f:C:myGlobalWorkflow.xml
将全局工作流的定义导入团队项目
下面的示例将全局工作流导入到 Contoso 团队项目:
witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:Contoso /f:C:collectionGlobalWorkflow.xml
将全局工作流的定义导入集合
下面的示例将全局工作流导入到该集合:
witadmin importglobalworkflow /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:collectionGlobalWorkflow.xml