前提条件

• 在开始通过通讯报文创建参数化的测试客户端或消息响应器之前，您的团队必须已安装并正在运行数据资源库服务器。详情请参阅 安装远程数据资源库服务器
• 消息内容必须是格式良好的（例如，如果是 XML，它必须是格式良好的；如是 EDI，它必须是有效的 EDI，等）；否则，可能无法从通讯报文中自动创建测试。SOAP 消息和/消息响应器必须只有一个顶级 XML 元素。
• 消息分组选项，注意数据资源库不支持具有混合类型的 JSON 数组的参数化。  如果 JSON 数组不是混合类型，那么 SOAtest 或 Virtualize 将假设数组中的所有元素都与第一个元素的类型相同。

使用向导

1. 在可用的创建向导中选择通讯报文> 生成参数化的消息选项。更多详情，请参阅以下章节： 添加新的 .tst 文件到现有项目和添加新的测试套件。

   添加项目、虚拟资产和响应器套件。

2. 在通讯报文向导中指定以下信息，然后点击下一步：
   1. 指定通讯报文文件的位置。
   2. 如果需要，请更改字符编码

   3. 如果要用保存在模板中的前一组设置填充向导，请输入该模板的位置。有关在 SOAtest 中创建和使用模板的详情，请参阅使用配置模板重用和共享向导设置，有关在 Virtualize 中创建和使用模板的详情，请参阅使用配置模板重用和共享向导设置。

      

      

3. 在 Parasoft 数据资源库设置页面中，指定哪个数据资源库应该存储用于参数化测试客户端或消息响应器，然后点击下一步。 
   

   
   
   

   

   

   

   • 在服务器字段中，指定要连接的服务器（嵌入式服务器或远程服务器）。如果选择嵌入式服务器，端口、用户和密码字段将灰显。如果选择远程服务器，端口、用户和密码字段将自动填充，并且可根据需要进行调整。

   • 在资源库名称字段中，选择或输入要使用的资源库的名称。如果输入新资源库的名称，将创建该资源库。

   • 定义资源库连接时，可以通过点击 Validate 检查连接。 

     锁定资源库，直到向导完成

     当使用远程（例如，非嵌入式）数据资源库服务器时，此处指定的资源库将被锁定，直到向导完成。如果想让锁显示为“locked by [your_username]”而不是“locked by [tmp]”，请选中为锁定配置身份验证，然后指定所使用的 CTP 服务器的 URL，以及该 CTP 服务器的用户名和密码。有关锁定的更多信息，请参阅锁定和解锁 CTP 中的资源库。

4. 在消息格式和分组策略 界面配置设置：

   

   
   

   1. 验证请求消息格式和响应消息格式是否设置正确。如果没有，请选择适当的格式。SOAtest 和 Virtualize 将尝试根据通讯报文文件中的第一条消息来标识请求和响应的消息格式。单个通讯报文文件中的所有请求都应具有一种格式，而同一文件中的所有响应都应具有一种格式。请求格式可能不同于请求格式。如果未检测到消息格式，则将选择纯文本。

   2. 转换选项可用于某些格式，如 EDI 或自定义格式。点击转换选项按钮并进行所需的更改。 

      

      
      

      

      
      

   3. 选择其中一项消息分组选项:

      • 基于操作/类型：根据操作或消息类型对消息进行分组。这对于包含可以通过操作或格式的消息类型（即，SOAP 主体下元素的名称、纯 XML 消息中根元素的名称或指定消息格式的消息类型）。为在通讯报文文件中发现的每个操作/类型生成一个响应器。如果选择此选项，Virtualize 将根据对通讯报文文件的分析，提供分组启发式方法建议。您可以更改预先选择的启发式方法。有关启发式方法的更多信息，请参阅了解按操作类型分组的启发式方法。

      • 基于类似请求：根据请求消息结构对消息进行分组。这告诉 Virtualize 分析请求消息结构并将请求/响应分组到响应器中，以便每个响应器将包含与具有类似结构的请求相关的响应。当消息具有相同的 DOM 树模型时，即使它们具有不同的值，也会被认为“类似”。此选项用于优化和简化将请求与每个消息响应器中的响应关联的规则。

      • 基于类似响应: 根据响应消息结构对消息进行分组。这告诉 Virtualize 分析响应消息结构并将请求/响应对分组到响应器中，以便每个响应器将包含具有类似结构的响应。当消息具有相同的 DOM 树模型时，即使它们具有不同的值，也会被认为“类似”。

      • 无：没有分组。为通讯报文文件中的每个响应消息生成一个响应器。如果想让每个请求/响应对位于单独的消息响应器中，请使用此选项。

        
        

5. 点击下一步并在消息分组审查界面审查有关操作和邮件的信息。 
1. 包括的列基于所应用的分组策略。 
2. 每个表行表示定义一个组的标准。将为每个表行生成一个组。将为每个组生成一个响应器。 

3. 关联性标准将按它们在表中的显示顺序（从上到下）进行处理。 

   URL 路径和参数将根据录制类型中的字段进行参数化。这些字段将具有一个自动生成的名称，并且将在数据复用页面（稍后的向导中）可见。

   有关如何创建这些分组的详情，请参阅了解按操作类型分组的启发式方法。

6. 1. 使用可用的控件添加、修改、重新排序和删除分组条件。 有关在 SOAtest 中配置分组条件的详情，请参阅自定义分组标准。

      有关在 Virtualize 中配置分组条件的详情，请参阅自定义分组标准。

      如果更改条件，请确保在继续之前点击重组。

   2. 如果选中了所有自动配置框，并且希望 Virtualize 自动为指定组配置邮件响应器，则可以跳过此步骤。

      如果要执行以下任何任务，请为要自定义的每个消息组禁用自动配置，点击下一步，然后按照中所述配置请求映射定制请求匹配和关联：

      • 自定义应该使用哪些参数值确定虚拟资产的响应消息 
      • 修改自动的请求/响应对匹配 
      • 指定 WSDL 或模式

      当消息组中有多个请求且路径、参数或主体存在差异时，自动配置通常可用。如果自动配置框灰显，则表示该组无法使用自动配置；有关为何无法自动配置特定组的更多详细信息，请参阅该项目的工具提示。
      
      
      
      有关面板顶部列出的任何项目（处理对、未处理对、与组不匹配的消息等），请点击关联的超链接。
      
      
      
      要查看与特定响应者相关的消息和/或更改响应者和数据集名称，请点击计数列中的相关行。
      
      
      
      

      如果想指定 WSDL/schema，请启用配置 WSDL/Schema，然后在下一页中指定合适的值。
      
      
      
      

      您应该指定 WSDL 还是 Schema？

      指定 WSDL 或模式的优点包括：

      生成的表单输入模型将根据 WSDL/Schema，当您编辑和维护结果表单输入时，该模式提供了丰富的类型。

      变更指导助手（如变更管理中描述）可以帮助您保持资产与不断发展的服务和不断变化的环境条件保持同步。

      如果您注意到生成的表单输入及其数据参数化与原始消息不匹配，则说明消息没有完全匹配 WSDL/Schema，或者映射原始消息失败。如果遇到这样的问题，应该忽略 WSDL/Schema，以确保生成的表单输入模型完全匹配通讯报文消息。

7. 点击下一步，然后在请求匹配界面配置设置。
   
   
   1. 点击请求/响应对，并验证是否已建立正确的关联性。您可以点击并拖动连接请求和响应的点以更改匹配。
      
   2.  点击请求关联性选项，然后在下拉菜单中选择一种响应器模式。 
8. 以及在数据复用界面中配置导入的通讯报文应如何复用或如何影响现有数据。
1. 定义的记录标识用于确定哪些数据是新的，哪些新记录与现有记录匹配。如果尚未为此数据集指定标识，则可以在此页面的数据树中添加/修改标识此页。 
2. 树用绿色箭头图标指示标识字段。现有的数据集用注释标注。

3. 您可以控制通讯报文文件的数据将如何扩展和/或更新现有资源库数据集。 

   替换：删除现有数据，然后添加新数据

   附加：添加新记录，无需删除现有数据。

4. 还可以控制匹配的数据（匹配现有的记录类型，由标识定义）是否重新使用现有的记录类型或更新现有的记录。复用选项允许您复用/共享匹配的现有记录。更新选项允许您使用来自通讯报文的数据更新现有记录相对应的字段，并为新的记录类型添加新记录。
    

   Virtualize 选项

   替换：删除现有数据，然后添加新数据。

   合并：在无需修改现有数据的情况下，导入新数据。

   更新：使用新数据更新匹配的记录，并根据需求创建新记录。

   覆盖：使用新数据更新匹配的记录（匹配键），不创建其他记录。

   
   

   有关指定身份并在 SOAtest 中的可用数据复用/更新选项中进行选择的详情，请参阅配置数据重用和更新。 针对 Virtualize，请参阅配置数据复用和更新。

5. 推断约束从选项允许 Virtualize 确定资源库中存储的数据的特征。可以根据数据或服务定义推断约束。
9. 点击下一步并在最终选项界面指定其他配置：
   1. 您可以将向导配置为以表单或字面量模式创建消息。这些模式显示一个表单输入视图（请参阅表单输入）或字面量视图（请参阅字面量）。   

   2. 可启用导出配置数据到一个可重用模板选项，并指定文件名和位置以将在此向导中使用的设置保存为模板。 

      （仅限 MQ 和 JMS）在下一个 SOAtest 向导页中指定连接设置。这些设置将应用到创建此通讯报文的工具。详情请参阅配置 MQ 选项和配置 JMS 选项。

      有关创建和使用模板的详情，请参阅使用配置模板重用和共享向导设置以及在 SOAtest 中使用配置模板重用和共享向导设置。

      如果要在 Virtual Assets 文件夹中创建 .pva，以实现自动部署，请通过为要创建的虚拟资产指定所需的名称和部署路径来完成部署虚拟资产向导页面，然后点击下一步。虚拟资产将部署在列出的端点。详情请参阅配置单个虚拟资产部署设置。

   3. 点击完成。

将创建和配置以下项目：

• • 一个或多个具有参数化值的测试客户端。创建的工具将是 SOAP 客户端、REST 客户端、EDI 客户端或消息传送客户端，具体取决于消息格式。除非消息是 XML 或 JSON 并且消息太大以至于会对性能产生影响，否则这些工具将默认为“表单输入/表单JSON”视图。在这种情况下，将使用字面量视图。

    将添加带有参数化元素以及预先配置的响应器关联和数据源关联的消息响应器。除非消息是 XML 或 JSON 并且消息太大以至于会对性能产生影响，否则这些工具将默认为“表单输入/表单JSON”视图。在这种情况下，将使用字面量视图。

    
    

    • （对于新数据资源库）将添加具有适用数据集和记录类型的新数据资源库。每个通过分析通讯报文确定的消息组将添加一个数据集。
    • （对于现有数据资源库）将向现有资源库添加新的数据集和记录类型。
    • 将为每个添加的数据集添加资源库数据源，并将每个测试客户端和消息响应器配置为使用相关的数据源。

例如，以下是使用数据资源库值参数化的示例 REST 客户端：



这是响应资源库的一部分：

现在，此参数化的、数据驱动的 REST 客户端可以在广泛的测试值范围内运行，而无需对工具本身进行任何修改。您可以修改或扩展关联的数据资源库值，而不是编辑工具。

如果在虚拟资产文件夹中创建 .pva，则在向导完成时，虚拟资产将自动部署到本地 Virtualize 服务器。否则，可以手动将其部署到本地或远程服务器。

有关如何编辑和扩展存储在数据资源库中的数据的详细信息，请参阅查看和修改资源库结构和内容。

请注意，通讯报文文件中存在的自定义传输头和任何 SOAP 头（例如，WS-Security 头）不会自动配置到生成的资产或数据资源库数据集中。您可以在生成的消息响应器中指定它们

 （详情请参阅消息响应器概要）

部署虚拟资产

如果在虚拟资产文件夹中创建 .pva，则在向导完成时，虚拟资产将自动部署到本地 Virtualize 服务器。否则，您可以随时将其部署到本地或远程服务器。

有关部署过程和选项的详情说明，请参阅部署虚拟资产 - 概要。

自定义虚拟资产

有关如何自定义消息响应器行为的详情，请参阅消息响应器概要。

 了解选择/扩展类型支持

如果在向导的末尾没有输入 WSDL 或模式文件，Virtualize 将使用录制的通讯报文的数据结构来创建数据资源库。当一个元素的数据结构在录制的通讯报文中发生变化时，该元素的类型很可能是基础架构中的一个选项。但是，向导并不显式支持选择类型；它将元素的数据结构解释为所有可能的子元素的序列。

例如，假设一个元素的实际架构如下：

Virtualize 将使用以下数据结构表示元素：

尽管所录制的通讯报文可能具有以不同顺序出现的子元素（例如，响应消息中的一个“parent”有一个“child1”，然后再是“child2”，而另一个响应消息中的“parent”有一个“child2”，然后才是“child1”），Virtualize 将以固定顺序参数化消息数据。因此，在本例中，元素“child1”和“child2”在响应消息中的顺序始终相同。

完成 Virtualize 向导：进阶主题

以下主题提供了帮助您完成向导的其他详细信息：

• • 使用配置模板重用和共享向导设置
    • 了解按操作类型分组的启发式方法
    • 自定义分组标准
    • 定制请求匹配和关联
    • 配置数据复用和更新

完成 SOAtest 向导：进阶主题

以下主题提供了帮助您完成向导的其他详细信息：

• • 使用配置模板重用和共享向导设置
    • 自定义分组标准
    • 配置数据重用和更新