
# 设置CodeArts TestPlan接口脚本的响应提取
#### 约束与限制
最大支持40个响应提取参数。
#### 功能介绍
响应提取是提取接口响应结果的某一部分，命名为参数，供后续测试步骤参数化调用。响应提取需要在前序测试步骤定义，后续测试步骤使用。
用户可根据需要将响应参数中涉及敏感信息进行脱敏配置，可参考[敏感参数配置](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_1334.html#cloudtest_01_1334__li94901931135618)。
- 在前序测试步骤中，在"响应提取"页签创建要传递的参数。响应提取的来源需要用到内置参数，请参考[内置参数](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0016.html#cloudtest_01_0016__section81678094617)了解如何使用内置参数。响应提取同时支持正则表达式的匹配，提取出与给定正则表达式匹配的返回值。
- 在后续测试步骤中，通过**${参数名}** 方式引用前序测试步骤创建的响应提取。后续步骤的URL、请求头、请求体中均可以引用此参数。如果在JSON格式的请求体中引用此参数，请在参数外使用英文引号，如：
  ```
  {
  id: "用例ID"
  name:"${name}"
  }
  ```
  
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002628859296.png "点击放大")
  
  
  
- 响应提取支持根据给定的"key:value"获取字符串，详细配置可参考[示例：根据给定的key:value从响应体中获取字符串](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0014.html#cloudtest_01_0014__section120775010296)。
  
  | 字段        | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
  |:---|:---|
  | 出参名称      | 用于之后使用${出参名称}来引用此参数，名称使用字母数字下划线。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
  | 来源        | 被检测字段的来源，如响应体（JSON）、响应头、响应码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
  | 属性        | 在属性中，支持输入$调用全局变量、局部变量、内置函数。 - 若来源是响应码，属性为空。详细介绍请参见[响应码检查](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0014.html#cloudtest_01_0014__section141201393352)。  - 若来源是响应头，属性为响应头中字段的名称。详细介绍请参见[响应头检查](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0014.html#cloudtest_01_0014__section438394113715)。  - 若来源是响应体（JSON），属性有两种填写方法： 1. 普通提取表达式（非"$"开头），例如"item.name"。 取字段中的值，支持嵌套取值。详细介绍请参见[响应体（JSON）检查](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0014.html#cloudtest_01_0014__section17628184743710)。 从响应体中提取数组时，下标可以是数字，也可以是"key:value"表达式，详细介绍请参见[示例：根据给定的key:value从响应体中获取字符串](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0014.html#cloudtest_01_0014__section120775010296)。   2. JsonPath表达式("$."或"$\["开头)，例如"$.store.book\[0\].title"。 详细介绍请参见[示例：根据JsonPath从响应体中获取数据](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0014.html#cloudtest_01_0014__section2099319192146)。      |
  | 高级提取类型    | 可选项，使用高级提取类型，辅助提取响应结果信息，若选择不涉及则视为不使用额外的方式匹配。 目前有两种方式： - 字符串提取，也就是字符串的截取，详见[字符串提取说明](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0014.html#cloudtest_01_0014__section12292171152915)。  - 正则表达式，即使用正则方式对来源字符串进行过滤，详见[正则表达式说明](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0014.html#cloudtest_01_0014__section18771133514191)。   高级提取类型优先使用字符串提取功能，若不能满足需求可考虑使用正则表达式。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
  | 赋值给环境动态参数 | 将响应提取后的值赋值给动态参数，用于后续测试引用该[动态参数](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0052.html#cloudtest_01_0052__section939718309373)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
     
  
