本主题概述了如何从通讯报文日志中捕获到的通讯报文创建参数化的测试客户端（SOAP 客户端、REST 客户端、EDI 客户端）。章节目录：

前提条件

• 您的团队必须安装并运行数据资源库服务器。详情请参阅 安装远程数据资源库服务器
• 消息内容必须格式正确。SOAP 消息必须只有一个顶级 XML 元素。
• 数据资源库不支持具有混合类型的 JSON 数组的参数化。如果 JSON 数组不是混合类型，那么 SOAtest 将假设数组中的所有元素都与第一个元素的类型相同。

使用向导

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

2. 在通讯报文向导中指定以下信息，然后点击下一步：
   1. 指定通讯报文文件的位置。如果使用服务定义文件，则这一项为可选项。
   2. 如果需要，更改字符编码。
   3. (可选）指定服务定义文件。提供服务定义有助于 SOAtest 创建更好的消息分组。

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

      

3. 点击下一步，从连接模式下拉菜单中选择以下模式之一，并配置相应的连接细节：
   • 主机/端口：
     1. 输入数据资源库服务器的主机和端口。也可以从下拉菜单中选择嵌入式服务器或现有远程服务器。
        • 如果选择嵌入式服务器，端口、用户名、密码字段将变灰。如果选择远程服务器，端口、用户名和密码字段将自动填充，如有必要，也可进行调整。
     2. 在资源库名称中选择或输入要使用的资源库名称。如果输入新资源库的名称，将创建该资源库。
     3. 指定访问数据资源库服务器的凭据（如需要）。
     4. 要使用 SSL 连接服务器，请启用使用 SSL。

   • 连接字符串：输入 MongoDB 连接字符串。使用 SSL 连接到本地服务器的连接字符串示例如下。有关 MongoDB 连接字符串的更多信息，请参阅 https://www.mongodb.com/docs/manual/reference/connection-string/。
     

     mongodb://localhost:2424/?tls=true&tlsAllowInvalidHostnames=true

     如果在连接字符串中指定了身份验证数据库，则应使用 /defaultauthdb 组件；只有在连接字符串中指定了凭据，才能使用 ?authsource=defaultauthdb 选项。

     

4. 点击验证对连接设置进行验证。 
   

5. 点击下一步，配置信息格式和分组策略：
   

   1. 验证请求消息格式设置正确。如果没有，请选择适当的格式。SOAtest 将尝试根据通讯报文文件中的第一条消息来标识请求和响应的消息格式。单个通讯报文文件中的所有请求都应具有一种格式，而同一文件中的所有响应都应具有一种格式。请求格式可能不同于请求格式。如果未检测到消息格式，则将选择纯文本。转换选项可用于某些格式，如 EDI 或自定义格式。点击转换选项按钮并进行所需的更改。 

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

      • 基于操作/类型：根据操作或消息类型对消息进行分组。这对包含可通过操作或格式消息类型（即 SOAP 体下的元素名称、纯 XML 消息中的根元素名称或指定消息格式的消息类型）明确识别的消息的服务通讯报文而言非常有用。为在通讯报文文件中发现的每个操作/类型生成一个响应器。

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

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

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

   3. 如果指定了服务定义或模板文件，则可以在消息组创建选项部分启用约束选项。如果启用此选项，则只对模板或服务定义文件中定义的消息组进行分组。所有其他消息将被忽略。如果禁用此选项，SOAtest 将对通讯报文文件中出现的所有消息进行分组。如果提供了服务定义和模板文件且启用了此选项，分组将在受到服务定义约束之前根据模板文件进行约束。因此，如果服务定义中定义了一条消息，但模板文件中没有定义，该消息将被忽略。约束选项默认启用。 
   4. 如果指定了服务定义或模板文件，则可以在消息组创建选项部分启用空白组选项。启用此选项后，即使通讯报文文件不包含符合分组标准的消息，也仍会根据服务定义货模板文件创建分组。禁用该选项后，将不会创建无消息的分组。如果在指定服务定义或通讯报文模板的同时指定了通讯报文文件，默认情况下空白组选项会被设为 false。如果没有指定通讯报文文件，默认情况下空白组选项会被设为 true。
   5. 点击下一步并在消息分组审查界面审查有关操作和邮件的信息。 
      
      
      1. 包括的列基于所应用的分组策略。 
      2. 每个表行表示定义一个组的标准。为每个表行生成一个组。将为每个组生成一个响应器。 

      3. 关联性标准将按它们在表中的显示顺序（从上到下）进行处理。URL 路径和参数将根据录制类型中的字段进行参数化。这些字段将具有一个自动生成的名称，并且将在数据复用页面（稍后的向导中）可见。

      4. 使用可用的控件添加、修改、重新排序和删除分组条件。有关在 SOAtest 中配置分组条件的详情，请参阅自定义分组标准。如果更改条件，请确保在继续之前点击重组。

      5. 如果想要指定 WSDL/schema，请启用配置栏中的选项，然后点击下一步指定合适的值。

         
         服务定义选项将根据通讯报文类型显示。例如，如果通讯报文为 JSON，您可以选择指定 OpenAPI/Swagger、RAML 或 WADL 文件。如果为 XML 通讯报文，您可以指定 WSDL 或 Schema。
         

         指定 WSDL 或模式的优点包括： 生成的表单输入模型将根据 WSDL/Schema，当您编辑和维护结果表单输入时，该模式提供了丰富的类型。 变更指导助手（如变更管理中描述）可以帮助您保持资产与不断发展的服务和不断变化的环境条件保持同步。 如果您注意到生成的表单输入及其数据参数化与原始消息不匹配，则说明消息没有完全匹配 WSDL/Schema，或者映射原始消息失败。如果遇到这样的问题，应该忽略 WSDL/Schema，以确保生成的表单输入模型完全匹配通讯报文消息。

6. 点击完成结束向导设置，或点击下一步配置导入通讯报文的数据复用设置。
   1. 定义的记录标识用于确定哪些数据是新的，哪些新记录与现有记录匹配。如果尚未为此数据集指定标识，则可以在此页面的数据树中添加/修改标识此页。 
   2. 树用绿色箭头图标指示标识字段。现有的数据集用注释标注。

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

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

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

   4. 还可以控制匹配的数据（匹配现有的记录类型，由标识定义）是否重新使用现有的记录类型或更新现有的记录。复用选项允许您复用/共享匹配的现有记录。更新选项允许您使用来自通讯报文的数据更新现有记录相对应的字段，并为新的记录类型添加新记录。有关指定身份并在 SOAtest 中的可用数据复用/更新选项中进行选择的详情，请参阅配置数据重用和更新。 针对 Virtualize，请参阅配置数据复用和更新。

7. 点击下一步并在最终选项界面指定其他配置：
   1. 您可以将向导配置为以表单或字面量模式创建消息。这些模式显示一个表单输入视图（请参阅表单输入）或字面量视图（请参阅字面量）。   

   2. 可启用导出配置数据到一个可重用模板选项，并指定文件名和位置以将在此向导中使用的设置保存为模板。（仅限 MQ 和 JMS）在下一个 SOAtest 向导页中指定连接设置。这些设置将应用到创建此通讯报文的工具。详情请参阅配置 MQ 选项和配置 JMS 选项。有关创建和使用模板的详情，请参阅在 SOAtest 中使用配置模板重用和共享向导设置。

   3. 点击完成。

将创建和配置以下项目：

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

  • 对于新的数据资源库，将添加具有适用数据集和录制类型的资源库。每个通过分析通讯报文确定的消息组将添加一个数据集。对于现有数据资源库，将向现有资源库添加新的数据集和录制类型。

  • 将为每个添加的数据集添加资源库数据源，并将每个测试客户端和消息响应器配置为使用相关的数据源。

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

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

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

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

通讯报文文件中存在的自定义传输头和任何 SOAP 头（例如，WS-Security 头）不会自动配置到生成的资产或数据资源库数据集中。

完成 SOAtest 向导：进阶主题

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

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