本主题概述了如何通过通讯报文日志中捕获的通讯报文创建参数化消息响应器。章节目录：

前提条件

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

监控控制台视图

当从通讯报文中创建测试和/或消息响应器时，保持控制台视图可见会很有帮助。此视图将显示在处理通讯报文文件时生成的任何警告、错误和信息消息。

使用向导

在可用的创建向导中选择通讯报文> 生成参数化消息选项。有关添加响应器的基本信息，请参阅添加项目、虚拟资产和响应器套件。
在通讯报文向导中指定以下信息：
1. 指定通讯报文文件的位置。如果输入的是定义文件，则此选项为可选项。
2. 如果需要，更改字符编码。
3. (可选）指定服务定义文件。提供服务定义有助于 Virtualize 创建更好的消息分组和数据源关联。
4. 如果要用保存在模板中的前一组设置填充向导，请输入该模板的位置。有关在 Virtualize 中创建和使用模板的详情，请参阅使用配置模板重用和共享向导设置。
点击下一步，从连接模式下拉菜单中选择以下模式之一，并配置相应的连接细节：
- 主机/端口：
  1. 输入数据资源库服务器的主机和端口。也可以从下拉菜单中选择嵌入式服务器或现有远程服务器。
    - 如果选择嵌入式服务器，端口、用户名、密码字段将变灰。如果选择远程服务器，端口、用户名和密码字段将自动填充，如有必要，也可进行调整。
  2. 在资源库名称中选择或输入要使用的资源库名称。如果输入新资源库的名称，将创建该资源库。
  3. 指定访问数据资源库服务器的凭据（如需要）。
  4. 要使用 SSL 连接服务器，请启用使用 SSL。
- 连接字符串：输入 MongoDB 连接字符串。使用 SSL 连接到本地服务器的连接字符串示例如下。有关 MongoDB 连接字符串的更多信息，请参阅https://www.mongodb.com/docs/manual/reference/connection-string/。
  MongoDB 连接字符串示例
```
mongodb://localhost:2424/?tls=true&tlsAllowInvalidHostnames=true
```
  如果在连接字符串中指定了身份验证数据库，则应使用 /defaultauthdb 组件；只有在连接字符串中指定了凭据，才能使用 ?authsource=defaultauthdb 选项。
点击验证对连接设置进行验证。
点击下一步并在消息格式和分组策略界面配置设置。
1. 验证请求消息格式和响应消息格式是否设置正确。Virtualize 将尝试根据通讯报文文件中的第一条消息来标识请求和响应的消息格式。单个通讯报文文件中的所有请求都应具有一种格式，而同一文件中的所有响应都应具有一种格式。请求格式可能不同于响应格式。如果未检测到消息格式，则将选择纯文本。
2. 转换选项可用于某些格式，如 EDI 或自定义格式。点击转换选项按钮并进行所需的更改。
3. 选择消息分组选项。详情请参阅Message Grouping Options。
4. 如果指定了服务定义或模板文件，则可以在消息组创建选项部分启用约束选项。如果启用此选项，则只对模板或服务定义文件中定义的消息组进行分组。所有其他消息将被忽略。如果禁用此选项，Virtualize 将对通讯报文文件中出现的所有消息进行分组。如果提供了服务定义和模板文件且启用了此选项，分组将在受到服务定义约束之前根据模板文件进行约束。因此，如果服务定义中定义了一条消息，但模板文件中没有定义，该消息将被忽略。约束选项默认启用。
5. 如果指定了服务定义或模板文件，则可以在消息组创建选项部分启用空白组选项。启用此选项后，即使通讯报文文件不包含符合分组标准的消息，也仍会根据服务定义或模板文件创建分组。禁用该选项后，将不会创建无消息的分组。如果在指定服务定义或通讯报文模板的同时指定了通讯报文文件，默认情况下空白组选项会被设为 false。如果没有指定通讯报文文件，默认情况下空白组选项会被设为 true。
6. 点击下一步并在消息分组审查界面审查有关操作和邮件的信息。详情请参阅Message Grouping Review Screen。
点击下一步。如果为每个组启用了自动配置选项，则将打开数据复用界面，您可以跳过下一步。
如果在前一个界面中禁用了自动配置选项，则需要在请求匹配界面中手动配置请求匹配选项。请参阅Configuring Request Mapping Options。
在数据复用界面中配置导入的通讯报文应如何复用或如何影响现有数据。详情请参阅Configuring Data Reuse Options。
点击下一步并在最终选项界面指定其他配置：
- 启用有效负载部分中的表单或字面量选项，将向导配置为以表单或字面量模式创建消息。详情请参阅表单输入或字面量。
- 可启用导出配置数据到一个可重用模板选项，并指定文件名和位置以将在此向导中使用的设置保存为模板。关于创建和使用模板的详情，请参阅使用配置模板重用和共享向导设置。
点击完成。

结果

将添加带有参数化元素以及预先配置的响应器关联和数据源关联的消息响应器。除非消息为 XML 或 JSON 大到影响性能，否则这些工具将默认表单输入/表单 JSON 视图。在这些情况下将使用字面量输入模式。

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

（对于现有数据资源库）将向现有资源库添加新的数据集和记录类型。

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

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

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

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

消息分组选项

您可以在消息格式和分组策略界面中使用以下消息分组选项：

基于操作/类型：根据操作或消息类型对消息进行分组。这对于包含可以通过操作或格式的消息类型（即，SOAP 主体下元素的名称、纯 XML 消息中根元素的名称或指定消息格式的消息类型）。为在通讯报文文件中发现的每个操作/类型生成一个响应器。如果选择此选项，Virtualize 将根据对通讯报文文件的分析，提供分组启发式方法建议。您可以更改预先选择的启发式方法。有关启发式方法的更多信息，请参阅了解按操作类型分组的启发式方法。
基于类似请求：根据请求消息结构对消息进行分组。这告诉 Virtualize 分析请求消息结构并将请求/响应分组到响应器中，以便每个响应器将包含与具有类似结构的请求相关的响应。当消息具有相同的 DOM 树模型时，即使它们具有不同的值，也会被认为“类似”。此选项用于优化和简化将请求与每个消息响应器中的响应关联的规则。
基于类似响应: 根据响应消息结构对消息进行分组。这告诉 Virtualize 分析响应消息结构并将请求/响应对分组到响应器中，以便每个响应器将包含具有类似结构的响应。当消息具有相同的 DOM 树模型时，即使它们具有不同的值，也会被认为“类似”。
无：没有分组。为通讯报文文件中的每个响应消息生成一个响应器。如果想让每个请求/响应对位于单独的消息响应器中，请使用此选项。

消息分组审查界面

消息分组审查界面中的列基于应用的分组策略。每个表行表示定义一个组的标准。为每个表行生成一个组。将为每个组生成一个响应器。有关使用此界面的完整信息，请参阅自定义分组标准部分。

关联性标准将按它们在表中的显示顺序（从上到下）进行处理。有关如何创建这些分组的详细信息，请参阅了解按操作类型分组的启发式方法。

您可以使用控件添加、修改、重新排序和删除分组条件。如果更改标准，请确保在继续前点击重组。

自动配置选项允许 Virtualize 为指定组自动配置消息响应器。禁用自动配置选项可为每个消息组手动配置消息响应器（请参阅Configuring Request Mapping Options）。

当消息组中有多个请求且路径、参数或主体存在差异时，自动配置通常可用。如果自动配置框灰显，则表示此分组不可使用“自动配置”；有关为何无法自动配置特定分组的详情，请参阅相关项的工具提示。

有关面板顶部列出的任何项（已处理对、未处理对、与组不匹配的消息等）的详细信息，请点击关联的超链接。

若要查看与特定响应器关联的消息和/或更改响应器和数据集名称，请点击计数列中的相关行。

配置请求映射选项

在请求匹配界面，您可以重新映射请求/响应对，自定义用于确定虚拟资产的响应消息的参数值，并指定与此消息关联的服务定义。有关在“请求匹配”界面中配置选项的完整详细信息，请参阅定制请求匹配和关联章节。

配置数据复用选项

定义的记录标识用于确定哪些数据是新的，哪些新记录与现有记录匹配。如果尚未为此数据集指定标识，则可以在数据树中添加/修改标识。树用绿色箭头图标指示标识字段。现有的数据集用注释标注。配置数据复用和更新章节讨论了有关配置复用的完整详细信息。

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

还可以控制匹配的数据（匹配现有的录制类型，由标识定义）是否重新使用现有的录制类型或更新现有的录制：

复用选项允许您复用/共享匹配的现有记录。更新选项允许您使用来自通讯报文的数据更新现有记录相对应的字段，并为新的记录类型添加新记录。
替换：删除现有数据，然后添加新数据。
合并：在无需修改现有数据的情况下，导入新数据。
更新：使用新数据更新匹配的记录，并根据需求创建新记录。
覆盖：使用新数据更新匹配的记录（匹配键），不创建其他记录。

推断约束从选项允许 Virtualize 确定资源库中存储的数据的特征。可以根据数据或服务定义推断约束。

部署虚拟资产

如果在虚拟资产文件夹中创建 .pva，则在向导完成时，虚拟资产将自动部署到本地 Virtualize 服务器。否则，您可以随时将其部署到本地或远程服务器。有关部署过程和选项的详情说明，请参阅部署虚拟资产 - 概要。

自定义虚拟资产

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

了解选择/扩展类型支持

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

<element name="parent">
    <complexType>
        <choice minOccurs="0" maxOccurs="unbounded">
            <element name="child1"/> 
            <element name="child2"/> 
            <element name="child3"/>
        </choice>
    </complexType> 
</element>

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

<element name="parent">
    <complexType>
        <sequence>
            <element name="child1" minOccurs="0" maxOccurs="unbounded"/> 
            <element name="child2" minOccurs="0" maxOccurs="unbounded"/> 
            <element name="child3" minOccurs="0" maxOccurs="unbounded"/>
        </sequence>
    </complexType> 
</element>

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

完成 Virtualize 向导：高级话题

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

视频教程：从使用消息代理录制的通讯报文中创建虚拟资产

在本视频中，您将学习如何从一个使用消息代理录制的通讯报文创建一个虚拟资产。

Page tree

Creating Parameterized Message Responders from Traffic