本主题介绍表单 XML 视图。
章节目录:
前言
您可以在消息工具和响应器(例如:请求、响应、有效负载)中的输入模式下拉列表中指定输入消息的形式。表单 XML 提供 XML 消息和响应的树状视图,以便您可以配置 XML 消息。字面量 XML 以图形方式表示,因此您可以添加、删除和重命名 XML 消息的组件。此外,如果数据源可用,则数据源值可用于配置 XML 消息。在表单 XML 模式中进行的任何更改也将在字面量 模式进行,反之亦然。
如果将表单 XML 选定为 SOAP Envelop,则面板的下半部分由 XML 视图树和 XML 配置选项卡组成。
从文本 XML 视图填充表单输入视图
如果您需要一种简单的方法来查看和处理现有的 XML 消息(例如,开发人员提供的样本、从服务器追踪到的消息、旧版测试工具提供的消息等),可以将其复制到字面量 视图中,然后打开表单输入视图。一旦将消息复制到文本 视图中,则表单输入视图将以 schema 感知和 schema 约束的方式填充,这种方式更易于编辑、管理和参数化。
XML Tree 选项
表单 XML 将以树状图的形式显示字面量 XML,其中每个树节点表示一个元素。
右键点击树中节点,以访问 XML 树视图选项。
选项 | 说明 |
---|---|
剪切 复制 粘贴 删除 | 您可以将节点剪切或复制到 OS 剪贴板,也可以将节点从剪贴板粘贴到树中。当试图在根元素中粘贴元素时,会有一个对话框询问您是替换整个内容,或者是作为子内容添加。 可以在下述环境中跨多个 XML 视图树剪切、复制和粘贴操作。这些操作保存参数化和任何其他排除/编码设置。 也可以从树中删除节点。 |
插入新 | 选择插入新元素、属性或命名空间声明。根据您的选择,相应的选项卡将显示参数选项。 |
编码子元素 | 选择将元素的子树编码为其父元素的文本内容。如果为特定节点选择此选项,则表单 XML 树中该节点的所有子元素都将显示为 italicized,而不是 XML。如果未选定此选项,则子元素将不被编码,仍然作为子元素。 |
XML 编码 | 为转义 XML 片段选择编码选项。可选项包括:
该选项只有在节点不包含子节点时才会出现。 |
导入 Schema 元素 | 为主体和头部选择元素。选定此选项后,将出现一个对话框,您可以从中从模式位置加载声明的元素。加载完元素后,您可以为 SOAP 头选择多个元素。点击 OK 后,将基于所选定元素定义创建一个 SOAP 消息封套。 |
全部展开 | 选择此选项,展开 XML 视图树中的所有节点。 |
全部折叠 | 选择此选项,折叠 XML 视图树中的所有节点。 |
上移 | 选择将 XML 视图树中的节点向上移动。仅当节点在树中比同级元素低时,才显示此选项。 |
下移 | 选择将 XML 视图树中的节点向下移动。仅当节点在树中比同级元素高时,才显示此选项。 |
填充 | 填充 SOAP 数组和元素参数。这也将任何元素 nils 设置为 false,并展开它们。此命令只有从 WSDL 创建工具时才可用。 |
显示命名空间 | 选择此选项,查看 XML 视图树内的命名空间。 |
显示属性 | 选择此选项,查看 XML 视图树内的属性。 |
美化 | 选择此选项,美化所有良好格式的 XML 段。 |
紧凑 | 选择重新格式化 XML 以适合一行。 |
XML 元素配置选项
XML 配置选项卡(元素、属性、命名空间声明)允许对 XML 组件进行添加、删除和重命名操作。若要添加或修改 XML 组件,请从 XML 视图树中选择合适的节点,然后点击合适的 XML 配置选项卡。
元素选项卡
显示从 XML 视图树中修改所选节点的元素参数的选项。
若要添加新元素,请右键点击 XML 视图树中的所需节点,然后从快捷菜单中选择插入新 > 元素。将在右键点击的节点下面将出现一个 NewElement 节点。选择 NewElement 节点对其进行配置。
在表单 XML 模式的 Element 选项卡中有以下选项可用:
选项 | 说明 |
---|---|
使用数据源: 排除使用空字符串 | (仅适用于相关工具中指定的数据源)允许控制是否根据数据源中的值发送元素和属性。更多信息,请参阅使用具有表单 XML 的数据源:排除元素和属性。 |
值 | (仅适用于没有子元素的元素)指定元素的内容值。如果数据源可用,则可以从下拉菜单中选择固定值或参数化值。更多信息,请参阅使用具有表单 XML 的数据源:参数化值。 |
前缀 | 指定元素的命名空间前缀。根据所选定元素的命名空间声明及其先驱者,前缀下拉菜单中的选项将有所不同。 |
本地名称 | 指定元素的本地名称。如果数据源可用,则可以从下拉菜单中选择固定值或参数化本地名。更多信息,请参阅使用具有表单 XML 的数据源:参数化值。 |
属性选项卡
显示从 XML 视图树中添加和/或修改所选节点的属性参数的选项。
在表单 XML 模式的属性选项卡中有以下选项可用:
选项 | 说明 |
---|---|
属性 | 显示所选定节点的当前属性列表。 |
删除 | 点击此选项,从属性列表中删除所选定属性。 |
添加新属性 | 点击此选项,从属性列表中添加新属性。 |
使用数据源: 排除使用空字符串 | (仅适用于相关工具中指定的数据源)允许控制是否根据数据源中的值发送元素和属性。更多信息,请参阅使用具有表单 XML 的数据源:参数化值。 |
值 | 指定属性的内容值。如果数据源可用,则可以从下拉菜单中选择固定值或参数化值。更多信息,请参阅使用具有表单 XML 的数据源:参数化值。 |
前缀 | 指定属性的命名空间前缀。根据所选定元素的命名空间声明及其先驱者,前缀下拉菜单中的选项将有所不同。 |
本地名称 | 指定属性的本地名称。如果数据源可用,则可以从下拉菜单中选择固定值或参数化本地名。更多信息,请参阅使用具有表单 XML 的数据源:参数化值。 |
命名空间声明选项卡
显示从 XML 视图树中添加和/或修改所选节点的命名空间声明参数的选项:
在表单 XML 模式的命名空间声明选项卡中有以下选项可用:
选项 | 说明 |
---|---|
命名空间 | 显示所选定节点的当前命名空间列表。 |
删除 | 点击此选项,从命名空间列表中删除命名空间。 |
添加新命名空间 | 点击此选项,从命名空间列表中添加新的命名空间 |
URI | 指定命名空间声明的 URI。 如果数据源可用,则可以从下拉菜单中选择固定值或参数化 URI。更多信息,请参阅使用具有表单 XML 的数据源:参数化值。 |
前缀 | 指定命名空间声明的前缀。 如果数据源可用,则可以从下拉菜单中选择固定值或参数化前缀。更多信息,请参阅使用具有表单 XML 的数据源:参数化值。 |
使用具有表单 XML 的数据源:参数化值
如果数据源在工具左上角指定,则可以在表单 XML 模式的 XML 组件中将该数据源中的值作为参数化值来使用。例如,您可以将数据源列中的所有值作为元素的内容值使用。
如果在工具中指定了数据源,则可以选择固定值或参数化值。如果数据源不可用,则仅可输入固定值。
- 固定值是通过将输入输入到可用文本字段指定的字面值。如果适用,可以使用
${name_of_variable}
符号引用变量。 - 参数化值是数据源列或数据源向导中的值(它允许使用其他工具值参数化当前工具)。在配置参数化值时,将出现一个包含来自数据源的列名的下拉框。
使用存储在现有数据源列中的值
参数化字段右侧的下拉菜单中的列名对应于工具中指定的数据源列。所选定的数据源列中的所有值将作为字面值由工具发送。
使用其他工具值
若要使用其他工具的值,请从同时显示列名的框中选择使用数据源向导。请参阅 XML 数据库以获得完成该向导的更多详情。
提取了一个值后,它将出现在可用列的列表中。
使用具有表单 XML 的数据源:排除元素和属性
可以创建一个数据源来控制工具是否包含或排除作为消息一部分的特定元素和属性。
如果使用数据源: 如果在元素或属性 XML 格式配置选项卡中选择了排除使用空字符串复选框,工具将使用指定数据源的空字符串(长度为 0 的字符串)作为条件,控制是否将元素和属性作为消息的一部分包含或排除。例如,可以创建一个数据源,其中包含用户名和密码的值。输入对应于密码值的空字符串,可以从消息中排除这些密码值。
若要从消息中排除元素或属性:
创建一个数据源,其中包含要作为消息的一部分发送的值的列,并且该列中包含表示包含或排除元素的空字符串和非空字符串。
在下面的数据源示例中,Value 列包含 name 和 password的值,并且 Exclude Password 列的值为 Don’t Exclude,还有一个空字符串。- 确保从工具面板中的数据源菜单选择正确的数据源。
- 在使用数据源: 排除使用空字符串复选框旁边的下拉框中,选择包含空字符串的合适列。
- 在值下拉框中,通过选择参数化和包含合适列(该列包含作为消息的一部分发送的数据源值)指定值/属性的内容值。
运行工具时,数据源中的 password 值将不会作为消息的一部分发送,因为它被 Exclude Password 列的空字符串排除,该列从使用数据源: 排除使用空字符串下拉框中选择。
若要从数据源发送所有参数化的值,则不要选择使用数据源: 排除使用空字符串复选框。