本主题是 WebKing 或 5.x 及更早版本 SOAtest 用户的通用迁移指南。本章包含：

关于该迁移向导

该向导目的在于帮助 WebKing 或 5.x 及更早版本 SOAtest 用户更早地筹备和尽可能快地在 SOAtest 中运行。

本迁移指南适用于已经熟悉 SOAtest 或 WebKing 的用户。对于新用户，我们建议首先查看 SOAtest 入门指南 。

为现有测试配置项目

由于自 6.0 版本后 SOAtest 接口就被集成到 Eclipse 框架，所以它现在遵循 Eclipse 框架层次结构以管理测试资产。不再需要一次打开一个 .tst 文件。相反，可以管理工作空间内项目的所有 .tst 文件。

• 工作空间对应于本地机器上的目录。SOAtest 启动时，它将询问您工作空间的所需位置，并在后面运行中记住该位置。当启动 SOAtest 9.x 时，Eclipse 工作空间将自动创建在 <user_home_dir>/parasoft/workspace中。例如：/home/username/parasoft/workspace (Linux), C:\Users\username\parasoft\workspace (Windows).

• 一个工作空间可以包括多个项目，每个项目都与本地机器上工作区中的目录相关联。项目可以包括多个 .tst 文件以及任何相关文件和构件，如数据源 Excel 电子表格、密匙库等。
• 项目中的 .tst 文件与以前版本中称为“项目文件”的功能相同。

选择合适的项目设置策略

在以下章节中，我们将介绍几种创建新项目的方法，这些方法可能对现有的 SOAtest 或 WebKing 用户有用。关于创建新项目的其他方法（比如，从 WSDL 中），可以在 SOAtest 教程 中找到。

若要确保测试可以轻松地在团队中，一个特定的团队成员（通常是团队领导或经理）共享，则必须决定使用哪个项目设置策略。然后整个团队应该采用相同策略。

从源代码控制下的测试创建项目

默认情况下，支持装载 CVS 源码控制的 SOAtest 9.x。可以通过给 Eclipse 提供合适的插件添加其他源码控制的支持。

若要创建由键入源码控制的测试套件组成的项目：

1. 请选择 File> Import。
2. 在打开的窗口中，展开与源码控制系统对应的文件夹（比如， SVN 或 CVS）。
3. 选择 Project(s) from <name of source control> 然后单击 Next。
4. 为包括测试的源码控制文件夹输入必需的资源库位置信息，然后单击 Finish。
5. 项目可在工作空间使用之后，将 .project 和 .parasoft 文件添加到源码控制中。  它们将在 Navigator 视图中可见，并应该由整个团队共享。
   • 不要将 .metadata 文件夹添加到源码控制中。

从不是源代码控制下的测试创建项目

强烈推荐将旧测试复制到新的工作空间。这样做将以类似于备份硬盘驱动器的方式保存旧的测试。该过程在 Copying Tests to a New Location中进行了说明。

作为第二选项，可以为没有存储在源码控制系统的测试使用现有 SOAtest 或 WebKing 测试套件向导中的项目。这将导致在工作空间内出现原始文件，但是这将允许保存在文件系统上的相同位置。该过程在 Leaving Tests in the Original Location中进行了说明。

复制测试到新的位置

若要创建一个将现有测试套件复制到文件系统上新位置的项目：

1. 选择 File> New> Project。
2. 在打开的窗口中，展开 General，选择 Project，然后单击 Next。
3. 为项目（包含多个 tst 文件）指定名称，然后单击 Finish。这将在工作空间中创建空的文件夹。
4. 请选择 File> Import。
5. 在打开的窗口中，展开 General，选择 File System，然后单击 Next。
6. 在 From directory 字段中，导航到包含测试的目录。
7. 在 Into folder 字段中，从步骤 3 选择项目文件夹，然后单击 Finish。
8. （可选项，强烈推荐）获得源码控制系统，并添加完整项目、 .project 文件夹和 .parasoft 文件到源码控制中。它们将在 Navigator 视图中可见，并应该由整个团队共享。
   • 不要将 .metadata 文件夹添加到源码控制中。

将测试留在原始位置

若要创建一个将现有测试套件留在文件系统上相同位置的项目：

1. 通过完成下列其中一项，打开 New Project Wizard ：
   • 选择 File> New> Project from Existing SOAtest or WebKing Test Suites。
     
     
     
     
   • 打开 New 工具按钮（左上角）的下拉菜单，然后选择 Project from Existing SOAtest or WebKing Test Suites。
     
     
     
     
2. 在打开的向导中，输入项目名然后输入或浏览到现有测试套件的根目录。
3. 点击 Finish 按钮。选定的测试将显示在测试用例资源管理器中。

使用团队项目集文件来跨团队共享项目

一旦团队成员创建了一个项目，则该成员便可创建一个团队 .psf 文件，以将此项目与其他团队成员共享。这一点允许每个团队成员以相同的方式创建 Eclipse 项目。对于导入来自自动化夜间测试进程的任务，这是很有必要的一步。

若要为从 CVS 创建的项目创建团队项目集文件，请完成以下内容：

1. 选择 File> Export。将显示 Export Wizard 。
2. 在 Export Wizard中，选择 Team> Team Project Set，然后单击 Next 按钮。
3. 通过选择相应的多选框来选择团队 .psf 文件中要包括的项目。
4. 输入团队 .pst 文件将保存的位置，然后单击 Finish 按钮。

若要从团队 .psf 文件中创建一个项目，请完成以下内容：

1. 选择 File> Import。将显示 Import Wizard 。
2. 在 Import Wizard中，选择 Team> Team Project Set，然后单击 Next 按钮。
3. Browse 到需要的团队项目集，然后单击 Finish 按钮。选定的测试将显示在测试用例资源管理器中。

导入现有首选项

现有 SOAtest 或 WebKing 用户可以从 SOAtest 的以前版本或 WebKing 中导入首选项。首选项包含类似以前使用的 WSDL、URLs、报告中心首选项、类路径中包括其他 jar 文件的系统属性等的设置。以前版本 SOAtest 或 WebKing 中的首选项以带 .xtp 或 .wkp 扩展名的二进制文件保存在 SOAtest 或 WebKing 的安装目录中。

若要导入现有首选项，请完成以下内容：

1. 选择 Parasoft> Preferences。将显示 Preferences 对话框。
2. 在首选项对话框内选择根 Parasoft 节点，并单击 Import 链接。
3. 浏览并选择 .xtp 或 .wkp 首选项文件。选择的首选项现在被保存。

熟悉 SOAtest 9.x 界面

Parasoft SOAtest 是基于 Eclipse IDE 的，并且它的外观和感觉都与以前的版本不同。然而，除了上述变更，用户接口设置布局、表单和设置在很大程度上保持不变，并且应该熟知现有用户。

测试用例资源管理器

测试用例资源管理器可以在同一个时间打开多个 Eclipse 项目。每个项目可以同时打开多个测试套件。在以前版本的 SOAtest 中，只有在给定时间才可以打开测试套件。

测试用例资源管理器菜单按钮

在测试用例资源管理器的右上角有以下菜单按钮：

• Refresh: 单击以刷新测试用例资源管理器的内容。
• Collapse All: 单击以折叠测试用例资源管理器内的所有节点。
• Search: 单击以执行测试用例资源管理器内任何节点的搜索（比如，测试套件、测试、链接工具等）。单击搜索（Search）按钮后，将显示以下选项：
  • Containing: 输入测试中包含的文字或字符串。
  • Within the whole tree: 选择以搜索整个树中指定的文本。
  • Within the selected node: 选择以搜索所选节点中指定的文本。
  • Wrap around: 选择以围绕文字执行搜索。
  • Case sensitive: 选择以执行区分大小写的搜索。
• Filter: 选择以隐藏测试用例资源管理器中特定的项目或测试。
• Statistics: 选择以在测试用例资源管理器中的每个测试套件节点附近显示统计信息（比如，测试通过、失败、错误、跳过、运行的数量）。

编辑器

通过双击或单击打开编辑器

在以前版本中，如果希望为测试节点（比如，一个“编辑器”）打开配置面板，则将在测试选项卡中选择该节点。使用 SOAtest 9.x，可以双击项目的 Test Case Explorer 节点来显示其编辑器。

如果希望将默认的双击行为更改为单击，请完成以下内容：

1. 选择 Windows> Preferences。将显示 Preferences 对话框。
2. 在首选项对话框中，在左侧选择 General ，并在右侧 GUI 面板中将 Open mode 从 Double click 更改为 Single click 。
3. 选择 General> Editors，启用 Close editors automatically ，然后单击 OK 按钮。

现在，您将能够基于单击打开编辑器。

打开多个编辑器

在以前版本的 SOAtest 和 WebKing 中，一次只能打开一个编辑器。  在 SOAtest 9.x 中，可以同时打开多个编辑器。 

保存编辑器中的更改

当编辑器在 SOAtest 9.x 中被修改后，将在编辑器选项卡上显示一个星号“*”，表示编辑器现在是“编辑状态（未保存）”。对编辑器的修改必须使用 Save 工具栏按钮或 Ctrl-S 键盘快捷键明确保存。

环境

在以前版本的 SOAtest（5.x 及更早版本）中，环境将显示在测试选项卡下方的单独选项卡中。现在，环境是测试用例资源管理器中树视图中的一部分。

运行测试

若要运行测试，则可以单击测试节点，并从快捷菜单选择 Test Using ‘Example Configuration’ 。  或者，可以按键盘上的 F9 ，然后单击 Test 工具栏按钮。

保存测试套件文件

在以前版本的 SOAtest 和 WebKing 中，必须明确保存测试套件（.tst）文件。在 6.x 及更高版本的 SOAtest 中，将自动保存测试用例资源管理器中的用户操作。例如，将自动保存添加新测试到测试用例资源管理器中。

注意，一旦将测试保存在最新版本的 SOAtest 中，就无法在较早版本的 SOAtest 中打开它们。。

质量任务视图和控制台视图

测试执行期间出现的故障现在在质量任务视图中显示。之前在消息日志视图中显示的内容现在在控制台视图中显示。

源代码控制集成

如果在 Eclipse 环境中安装了合适的源码控制插件，那么现在测试套件直接检入到源码控制中，如下所示：

• 右键单击测试套件节点，然后从快捷菜单中选择 Team> Commit 。

若要在新项目中进行检查，请完成以下内容：

• 右键单击项目节点，然后从快捷菜单中选择 Team> Share Project 。

使用 CLI 设置自动化的夜间构建

若要通过命令行设置自动化的夜间构建，请完成以下内容：

1. 启动测试机器上的 SOAtest，然后创建包含所有项目的工作空间以及希望作为夜间测试构建的一部分来运行的测试套件。关于更多信息，请查阅上述 为现有测试配置项目 部分。
2. 使用测试所需的任何全局设置来配置 SOAtest 首选项。若要打开 SOAtest 首选项，请选择 Parasoft> Preferences。如果工作空间的测试套件是从源码控制中导入，那么应该配置 Parasoft> Source Controls 设置。可以设置首选项，如 导入现有首选项 上用户指南章节中所描述。
3. （可选项）创建要用于夜间测试运行的测试配置。测试配置中包括影响测试执行的方式的设置。SOAtest 附带一个名为 Example Configuration 的测试配置，如果不希望创建自动的测试配置，则可以使用它。测试配置可以通过选择 Parasoft> Test Configurations进行管理。如果工作空间的项目从源码控制中创建，则应该单击测试配置中的 Common 选项卡，然后启用 Update projects from source control 选项。
4. （可选项）创建 本地设置文件 - 选项。这是文本文件，可用于报告、邮件、报告中心、团队服务器、许可证服务器、作者和源码控制的控件设置。
5. 安排使用所需的命令行选项调用 SOAtest 的每日流程。这可以通过使用如 Windows Task Scheduler 或 Unix 图标的任务安排机制来完成。例如，若要运行工作空间中的所有项目，那么可以使用以下命令：
   
   soatestcli.exe -data "c:\mySOAtestWorkspace" -showdetails -config "user://Example Configuration" -report "c:\mySOAtestReports" -publish -localsettings c:\mySOAtestWorkspace\mylocalsettings.properties" 

-Publish 参数将添加报告到 DTP，以便测试和分析数据可以被合并、关联和分析，从而暴露出隐藏很深的缺陷模式。DTP 处理数据时，它将创建可操作的发现，该发现可下载并导入到 IDE 中（要求 5.3.x 及更新版本的 DTP）。

还可以使用 -publishteamserver 选项来发布报告到团队服务器，该服务器提供了 Concerto 和更早版本的 DTP 的兼容性。

关于更改的详细列表，请查阅 命令行界面迁移 上的主题。 

HP 质量中心集成

HP QC 集成已经从 6.2 升级为 9.x。必须重新执行连接两个产品的步骤，以确保继续执行正确的行为。

已弃用的功能

• Load Testing: 现在，这可以在名为 Parasoft Load Test 的单独可安装程序中使用。当前版本允许运行现有的 SOA 和 web 负载测试，以及创建新的 SOA。它还允许加载测试完整的端到端测试场景，通过服务，从 web 界面到数据库。Parasoft Load Test 工具支持 Parasoft SOAtest 中可用的每个协议和测试类型。
  • Parasoft Load Test 工具包括完整的 SOAtest 产品，因此，如果您既对功能测试感兴趣，也对负载测试感兴趣，那么应该安装 Parasoft Load Test 。
• WebKing Paths: WebKing’s Path 视图已经被使用浏览器回放工具的被基于测试套件的功能测试所替换。主要的好处在于基于测试套件的功能测试支持更复杂的 web 应用程序（如 RIA 和 AJAX 应用程序）。而且，新的实现遵循支持端到端测试的一致的测试配置范例。现有 .xkj 文件中的路径可以在 SOAtest 9.x 中执行，但它们却不可被编辑或扩展。
• WebKing Publishing: 该功能不适用于 SOAtest 9.x。
• Capture HTTP Traffic Tool: 不再支持该工具。如果需要该功能，则可使用像 WireShark 这样的免费工具来将 HTTP 跟踪保存到文件中，然后可以使用 "Generate tests from traffic” 选项从中创建测试。
• Specific XML Validator Options: XML DTD 首选项和针对 DTD 选项的验证不再可用。
• Management Reports: 计划报告改进。SOAtest 将报告所有元数据到报告中心，并且报告中心将可能生成不同类型的报告。
• CLI commands:
  • -run: 该命令已弃用，它用于通过 SOAtest 运行自定义的 Jython 脚本。关于迁移脚本到 9.x 的帮助，请联系技术支持。
  • -runtest: 该命令已经替换为新的 CLI 选项。有关更多详情，请查阅 命令行界面迁移 上的迁移指南主题。
  • -wsdl
  • -reportAllTraffic
  • -traffic