本主题介绍表单 XML 视图。
本章包含:
前言
您可以在消息工具和响应程序中的 Input Mode 下拉列表中指定输入消息的形式(比如:Request、Response、Payload)。表单 XML 提供 XML 消息和响应的树状视图,以便您可以配置 XML 消息。文字 XML 以图形方式表示,因此您可以添加、删除和重命名 XML 消息的组件。此外,如果数据源可用,则数据源值可用于配置 XML 消息。在表单 XML 模式中所做的任何更改也将在下面的模式中进行,文字XML 模式,反之亦然。
如果将表单 XML 选定为 SOAP Envelop,则面板的下半部分由 XML 视图树和 XML 配置选项卡组成。
从文本 XML 视图填充表单输入视图
如果希望查看和处理现有 XML 消息的简单方法(如:来自开发人员的样品、来自服务器和来自遗留测试工具的追踪等等),则可以将其复制到文本XML视图中,然后打开表单输入视图。一旦将消息复制到文本XML视图中,则表单输入视图将以 schema 感知和 schema 约束的方式填充,这种方式更易于编辑、管理和参数化。
XML Tree 选项
表单 XML 将以树状图的形式显示文字 XML,其中每个树节点表示一个元素。
右键单击树中节点,以访问 XML 树视图选项。
选项 | 说明 |
---|---|
Cut Copy Paste Delete | 您可以将节点剪切或复制到 OS 剪贴板,也可以将节点从剪贴板粘贴到树中。当试图在根元素中粘贴元素时,将显示一个对话框,询问您是替换整个内容,或者是作为子内容添加。 可以在下述环境中跨多个 XML 视图树剪切、复制和粘贴操作 在 Diff 工具、SOAP 客户端、HTTP 流量等内部。这些操作保存参数化和任何其他排除/编码设置。 也可以从树中删除节点。 |
Insert New | 选择插入新元素、属性或命名空间声明。根据您的选择,相应的选项卡将显示参数选项。 |
Expand All | 选择此选项,展开 XML 视图树中的所有节点。 |
Collapse All | 选择此选项,折叠 XML 视图树中的所有节点。 |
Move Up | 选择将 XML 视图树中的节点向上移动。仅当节点在树中比同级元素低时,才显示此选项。 |
Move Down | 选择将 XML 视图树中的节点向下移动。仅当节点在树中比同级元素高时,才显示此选项。 |
Encode Child Elements | 选择将元素的子树编码为其父元素的文本内容。如果为特定节点选择此选项,则表单 XML 树中该节点的所有子元素都将显示为 italicized ,而不是 XML。如果未选定此选项,则子元素将不被编码,仍然作为子元素。 |
Import Schema Element | 为主体和数据头选择元素。选定此选项后,将出现一个对话框,您可以从中从模式位置加载声明的元素。加载完元素后,您可以为 SOAP 头文件选择多个元素。一旦点击 Ok,将基于所选定元素定义创建一个 SOAP Envelope。 |
Populate | 填充 SOAP 数组和元素参数。这也将任何元素 nils 设置为 false,并展开它们。此命令只有从 WSDL 创建工具时才可用。 |
Show Namespaces | 选择此选项,查看 XML 视图树内的命名空间。 |
Show Attributes | 选择此选项,查看 XML 视图树内的属性。 |
Beautify | 选择此选项,美化所有良好格式的 XML 段。 |
Compact | 选择重新格式化 XML 以适合一行。 |
XML 元素配置选项
XML Configuration Tabs (元素、属性、命名空间声明)允许对 XML 组件进行添加、删除和重命名操作。若要添加或修改 XML 组件,请从 XML 视图树中选择合适的节点,然后单击合适的 XML 配置选项卡。
元素选项卡
显示从 XML 视图树中修改所选节点的元素参数的选项。
若要添加新元素,请右键单击 XML 视图树中的所需节点,然后从快捷菜单中选择 Insert New> Element 。将在右击的节点下面将出现一个 NewElement 节点。选择 NewElement 节点对其进行配置。
在表单 XML 模式的 Element 选项卡中有以下选项可用:
选项 | 说明 |
---|---|
Encode Value | (仅适用于不包含子节点的节点)选择此选项,将转义 XML 段值编码为文本。例如,如果正在发送 <UserName> 这样的值,则可以将小于(< )和大于(> )字符编码为 < 和 > 。通过这种方式,XML 编译器将不会将 <UserName> 值错误地解释为 XML 标记,而是文本。此功能还可以处理存储在数据源中的参数化值。 |
使用数据源:使用空字符串排除 | (仅适用于相关工具中指定的数据源)允许控制是否根据数据源中的值发送元素和属性。关于更多详情,请查阅 Using Data Sources with Form XML:Using Data Sources with Form XML Excluding Elements and AttributesExcluding Elements and Attributes. |
值 | (仅适用于没有子元素的元素)指定元素的内容值。如果数据源可用,则可以从下拉菜单中选择 Fixed 或 Parameterized 值。关于更多详情,请查阅 Using Data Sources with Form XML:Using Data Sources with Form XML Parameterized ValuesParameterized Values。 |
Prefix | 指定元素的命名空间前缀。根据所选定元素的命名空间声明及其先驱者, Prefix 下拉菜单中的选项将有所不同。 |
Local name | 指定元素的本地名称。如果数据源可用,则可以从下拉菜单中选择 Fixed 或 Parameterized 本地名。关于更多详情,请查阅 Using Data Sources with Form XML:Using Data Sources with Form XML Parameterized ValuesParameterized Values。 |
属性选项卡
显示从 XML 视图树中添加和/或修改所选节点的属性参数的选项。
在表单 XML 模式的 Attributes 选项卡中有以下选项可用:
选项 | 说明 |
---|---|
Attributes | 显示所选定节点的当前属性列表。 |
Remove | 单击此选项,从属性列表中删除所选定属性。 |
Add New Attribute | 单击此选项,从属性列表中添加新属性。 |
使用数据源:使用空字符串排除 | (仅适用于相关工具中指定的数据源)允许控制是否根据数据源中的值发送元素和属性。关于更多详情,请查阅 Using Data Sources with Form XML:Using Data Sources with Form XML Parameterized ValuesParameterized Values. |
值 | 指定属性的内容值。如果数据源可用,则可以从下拉菜单中选择 Fixed 或 Parameterized 值。关于更多详情,请查阅 Using Data Sources with Form XML:Using Data Sources with Form XML Parameterized ValuesParameterized Values。 |
Prefix | 指定属性的命名空间前缀。根据所选定元素的命名空间声明及其先驱者, Prefix 下拉菜单中的选项将有所不同。 |
Local name | 指定属性的本地名称。如果数据源可用,则可以从下拉菜单中选择 Fixed 或 Parameterized 本地名。关于更多详情,请查阅 Using Data Sources with Form XML:Using Data Sources with Form XML Parameterized ValuesParameterized Values。 |
命名空间声明选项卡
显示从 XML 视图树中添加和/或修改所选节点的命名空间声明参数的选项:
在表单 XML 模式的 Namespace Declarations 选项卡中有以下选项可用:
选项 | 说明 |
---|---|
Namespaces | 显示所选定节点的当前命名空间列表。 |
Remove | 单击此选项,从命名空间列表中删除命名空间。 |
Add New Namespace | 单击此选项,从命名空间列表中添加新的命名空间。 |
URI | 指定命名空间声明的 URI。 如果数据源可用,则可以从下拉菜单中选择 Fixed 或 Parameterized URI。关于更多详情,请查阅 Using Data Sources with Form XML:Using Data Sources with Form XML Parameterized ValuesParameterized Values。 |
Prefix | 指定命名空间声明的前缀。 如果数据源可用,则可以从下拉菜单中选择 Fixed 或 Parameterized 前缀。关于更多详情,请查阅 Using Data Sources with Form XML: 参数化值。 |
使用具有表单 XML 的数据源:Parameterized Values
如果数据源在工具左上角指定,则可以在表单 XML 模式的 XML 组件中将该数据源中的值作为参数化值来使用。例如,可以将数据源列中的所有值所谓元素的内容值来使用。
如果工具中指定了数据源,则您将有机会选择 value 或 Parameterized 值。如果数据源不可用,则仅可输入固定值。
- Fixed 值是通过将输入输入到可用文本字段指定的文字值。如果适用,可以使用
${name_of_variable}
符号引用变量。 - Parameterized 值是数据源列或数据源向导中的值(它允许使用其他工具值参数化当前工具)。在配置参数化值时,将出现一个包含来自数据源的列名的下拉框。
使用存储在现有数据源列中的值
Parameterized 字段右侧的下拉菜单中的列名对应于工具中指定的数据源列。所选定的数据源列中的所有值将作为文字值由工具发送。
使用其他工具值
若要使用其他工具的值,请从同时显示列名的框中选择 Use Data Source Wizard 。请查阅 XML 数据库, 以获得完成该向导的更多详情。
一旦提取了一个值,它将出现在可用列列表中。
使用具有表单 XML 的数据源:排除元素和属性
可以创建一个数据源来控制工具是否包含或排除作为消息一部分的特定元素和属性。
如果 Use Data Source: Exclude with empty string 复选框已选定,此复选框位于 Element 或 Attribute 表单 XML 配置选项卡中,则工具将使用特定数据源的空字符串(长度为 0 的字符串)作为一个条件,以控制是否包含或排除作为消息一部分的特定元素和属性。例如,可以创建创建一个数据源,其中包含用户名和密码的值。输入对应于密码值的空字符串,可以从消息中排除这些密码值。
若要从消息中排除元素或属性:
创建一个数据源,其中包含要作为消息的一部分发送的值的列,并且该列中包含表示包含或排除元素的空字符串和非空字符串。
在下面的数据源示例中, Value 列包含 name 和 password的值,并且 Exclude Password 列的值为 Don’t Exclude,还有一个空字符串。
有关配置数据源的更多详情,请查阅 使用数据源、变量或来自其他测试的值对测试进行参数化。- 确保从工具面板中的 Data Source 菜单选择正确的数据源。
- 选择 Use Data Source: Exclude with empty string 复选框,其位于 Element 或 Attribute 表单 XML 配置选项卡中。
- 在 Use Data Source: Exclude with empty string 复选框旁边的下拉框中,选择包含空字符串的合适列。
- 在 Value 下拉框中,通过选择 Parameterized 和包含合适列(该列包含作为消息的一部分发送的数据源值)指定 Element/Attribute 的内容值。
运行工具时,数据源中的 password 值将不会作为消息的一部分发送,因为它被 Exclude Password 列的空字符串排除,该列从 Use Data Source: Exclude with empty string 下拉框中选择。
若要从数据源发送所有参数化的值,则不要选择 Use Data Source: Exclude with empty string 复选框。