1.1.1 Property Transfer
创建或双击现有的Property-Transfer TestStep将打开以下窗口:
左侧的列表显示了此TestStep中配置的传输,添加和管理所需的数量。 选择传输时(如上图截图中的“result”),右侧的区域允许您根据需要进行配置;
- 顶部的源区域指定源属性和可选的XPath用于传输
- 目标区域指定目标属性和可选的XPath进行传输
- 下面的区域将不同的配置选项设置在传输级别上。
底部的传输日志显示窗口打开时的最新执行传输及其实际传输的值。
可用的配置选项可以大大改变传输的内容,并将其各自的定义为:
- Fail transfer on error -尝试执行转移时发生任何错误时,转移步骤将失败
- Transfer text content -只会传送文字内容。 不会保留结构元素
- Transfer to all -匹配的值将被转移到所有的目标位置,以防多个匹配
- Entitize transferred values -这些值将具有某些字符,例如&符号(“&”)替换为相应的字符实体值(“&”)
- Set null on missing source -如果源资源丢失,目标将设置为null。 这意味着如果目标已经有一个值,它将丢失
- Ignore empty/missing values -这意味着如果源的匹配值为空或丢失,则它将被忽略,并且目标值保持不变
- Use XQuery - SoapUI将假定源是XQuery而不是默认的XPath,当尝试提取源值时
- Transfer child nodes - SoapUI不会尝试从匹配的源节点进行任何文本提取,而是选择匹配节点的子节点,从而保留子树XML结构
1.1.1.1 Transfer Execution
当在TestCase运行期间执行PropertyTransfer TestStep时,通过选择传输源步骤,属性和可选XPath/JSONPath表达式指定的属性来执行属性传输中的每次传输,并使用以下命令将其值复制到目标步骤指定的属性可选的XPath/JSONPath表达式。 如果指定了XPath/JSONPath表达式,soapUI将尝试用源节点替换目标节点,如果它们的类型相同。 如果没有(例如,将text()分配给@attribute),soapUI将尽可能复制该值。
源和目标XPath/JSONPath表达式都必须指向其各自属性中的现有节点,源属性显然需要节点,以便可以选择,目标属性需要节点才能被找到并覆盖。
如果由于任何XPath/JSONPath表达式的匹配丢失而导致任何传输失败,则打印错误,并且步骤将失败或继续,具体取决于该传输选择了“失败错误”选项。 如果TestCase的“Fail on error”选项已按照TestCase Options所述设置,TestCase的执行将被中止。
1.1.1.2 一个例子:将版本号从响应转移到以下请求
假设我们有一个查询服务,返回一个随后要用于删除的版本号; 属性转移非常适用于提取版本号并将其写入可以由所有所需TestStep引用的属性。 开始了:
- 将查询请求添加并执行到一个空的TestCase,以便您有一个有效的响应来处理;
- 请求后创建Property-Transfer TestStep,并向其中添加属性传输;
- 将源属性配置为“查询请求的响应”,然后在源属性工具栏右侧选择“向导”按钮。 这将打开一个方便的向导,用于选择要传输的所需源节点(在标准soapUI中,您将必须手动创建生成的JSONPath语句)。
- 选择节点并按OK; soapUI为您生成相应的JSONPath语句;
现在,所有的源都设置完成,下一步是配置属性转移的目标,即应写入的位置。 有两个选择;
- 将其写入可以由需要使用version_seq的所有后续测试步骤引用的临时属性。 如果我们要在几个地方使用version_seq或者TestSteps,这是最好的解决方案
- 将其直接传输到应该使用该值的目标TestStep。 如果只想在一个地方使用该值,这将更容易
1.1.1.2.1 写入临时属性
将属性保存到我们使用名称“version_seq”定义的测试用例属性;
现在当执行时,version_seq被转移到指定的TestCase属性,并且可以稍后在通过标准属性扩展(或另一个属性转移)的任何请求中使用。
1.1.1.2.2 直接写入所需的目标TestStep
这更直接; 将目标设置为注销请求,并再次使用JSONPath向导(或JSONPath技术)创建目标JSONPath语句;
现在执行此操作时,源目标值将从响应中直接提取并写入请求消息。