设置CodeArts TestPlan接口脚本的检查点

设置建议

推荐用户设置检查点。针对接口类请求，请提供判断响应码的检查点。

当检查点设置为空，不论接口的响应码是什么，都会判断结果为成功。

检查点说明

测试检查点又名断言，通过检查接口响应是否符合预期，判定系统是否满足预期。

在接口自动化用例详情中，测试步骤的“检查点”页签中可以定义测试检查点。

检查点内容包括属性、比较符和目标值定义。

字符串提取说明

在设置检查点或者响应提取时，若使用设置属性栏的表达式无法满足需求，则可以在“高级提取类型”处选择“字符串提取”功能。

使用字符串截取功能， “类型值”输入框有两个：

• 第一个框表示起始索引。首位用“0”表示，起始索引包含在截取的字符串中。
• 第二个框表示结束索引。结束索引不包含在截取的字符串中。

正则表达式说明

在设置检查点或者响应提取时，若使用设置属性栏的表达式无法满足需求，或者配合高级类型提取下的字符串提取功能也不能满足需求时，则可以在“高级提取类型”处选择“正则表达式”来提取。

正则表达式引擎使用Java正则表达式引擎。

比较符说明

测试计划服务支持以下比较类型：

响应码检查

将响应码与目标值进行比较，例如：检查响应码是否等于“200”。

响应头检查

将响应头中字段的值和目标值进行比较，例如：检查响应头中“content-type”的值是否等于“text/plain;charset=UTF-8”。

响应体（JSON）检查

1. 检查响应体（JSON）中对象字段的值。例如：

   响应体结构如下：

   

   检查响应体对象中字段名为“status”的值，检查点配置如下：

   

2. 检查响应体（JSON）中某个数组的对象的字段值（数组条件采用下标确定对象，下标从0开始）。例如：

   响应体结构如下：

   

   检查响应体“result”数组的第1个元素对象字段名为“userId”的值，检查点配置如下：

   

3. 检查响应体（JSON）中某个数组的对象的字段值（数组条件采用模糊匹配功能确定对象）。例如：

   响应体结构如下：

   

   1. 检查响应体“result”数组下“name”是“啤酒”的所有对象取第1个之后获取id的值，检查点配置如下：

      

      

      当获取的数组下的对象只有一个，“[0]”可以省略，示例中的表达式可以写为“result[name==啤酒].id”。

   2. 检查响应体“result”数组下“name”是“啤酒”的并且“obj”对象下属性“a”的值是“2”的对象的id值，检查点配置如下：

      

变量检查

检查比较全局变量，局部变量，响应提取后的变量值和目标值。例如：

• 检查全局变量“hostIp”的值是否等于“127.0.0.1”。
• 检查局部变量“local”的值是否等于“text”。
• 检查响应提取后的变量“name”的值是否等于“白酒”。

  

示例：根据给定的key:value从响应体中获取字符串

检查体的“属性”字段，可输入下标为“key:value”格式的数组，用以实现根据给定的“key:value”从响应体中获取满足该条件的json串。

“key:value”之间支持以下连接符：

数组下标支持以“&&”连接的多组“key:value”条件，表示提取的JSON串需要同时满足所有的“key:value”条件。例如：student[age>20&&gender=女]，表示提取条件为年龄大于20岁且性别为女。

数组的搜索条件中支持嵌套数组，在此情况下子嵌套条件中的对象必须全部满足条件，才能使得子条件成立。

• 若value值为空对象，则需要使用$null，即key==$null。
• 若value值是null串（"null"），则使用null，即key==null。
• 若value值是空串（""），则可以不写，即key==。
• 如果检查点的属性值中value含有特殊字符，需要使用单引号或者双引号作为边界符

  eg：name=="zhangsan(ab)"

以下面的响应体（JSON格式）为例：

{
	"status": "success",
	"result": [
		{
			"name": "啤酒",
			"数量": "20",
			"地址": "A3库房10号货架",
			"obj": {
				"a": 1,
				"b": "test",
				"c": "测试"
			},
			"array": [
				{
					"id": 1,
					"name": "aaa"
				},
				{
					"id": 2,
					"name": "bbb"
				}
			]
		},
		{
			"name": "啤酒",
			"数量": "10",
			"地址": "A3库房10号货架",
			"obj": {
				"a": 1,
				"b": "test",
				"c": "测试"
			},
			"array": [
				{
					"id": 1,
					"name": "aaa"
				},
				{
					"id": 2,
					"name": "bbb"
				}
			]
		},
		{
			"name": "白酒",
			"数量": "20",
			"地址": "A3库房10号货架",
			"obj": {
				"a": 1,
				"b": "test",
				"c": "测试"
			},
			"array": [
				{
					"id": 1,
					"name": "aaa"
				},
				{
					"id": 2,
					"name": "bbb"
				}
			]
		},
		{
			"name": "白酒",
			"数量": "30",
			"地址": "A3库房10号货架",
			"obj": {
				"a": 1,
				"b": "test",
				"c": "测试"
			},
			"array": [
				{
					"id": 3,
					"name": "aaa"
				},
				{
					"id": 4,
					"name": "bbb"
				}
			]
		},
		{
			"name": null,
			"数量": "10",
			"地址": "A3库房10号货架",
			"obj": {
				"a": 2,
				"b": "test",
				"c": "测试"
			},
			"array": [
				{
					"id": 5,
					"name": "aaa"
				},
				{
					"id": 6,
					"name": "bbb"
				}
			]
		},
		{
			"name": "",
			"数量": "10",
			"地址": "A3库房10号货架",
			"obj": {
				"a": 2,
				"b": "test",
				"c": "测试"
			},
			"array": [
				{
					"id": 5,
					"name": "aaa"
				},
				{
					"id": 6,
					"name": "bbb"
				}
			]
		}
	],
	"condition": [
		{
			"name": "啤酒",
			"数量": "120",
			"地址": "A1库房15号货架"
		}
	],
	"reason": null
}

从响应体中获取数据与对应的表达式如下表所示：

若需要检查（JSON格式）name是白酒、且数量大于20的数据是不是“[{"name": "白酒","数量": "30","地址": "A3库房10号货架","obj": {"a": 1,"b": "test","c": "测试"},"array": [{"id": 3,"name": "aaa"},{"id": 4,"name": "bbb"}]}]”，则检查点各字段的配置可参考下表：

示例：根据JsonPath从响应体中获取数据

JsonPath详情可参见官网。

以下面的响应体（JSON格式）为例：

{
    "store": {
        "book": [
            {
                "category": "reference",
                "author": "Nigel Rees",
                "title": "Sayings of the Century",
                "price": 8.95
            },
            {
                "category": "fiction",
                "author": "Evelyn Waugh",
                "title": "Sword of Honour",
                "price": 12.99
            },
            {
                "category": "fiction",
                "author": "Herman Melville",
                "title": "Moby Dick",
                "isbn": "0-553-21311-3",
                "price": 8.99
            },
            {
                "category": "fiction",
                "author": "J. R. R. Tolkien",
                "title": "The Lord of the Rings",
                "isbn": "0-395-19395-8",
                "price": 22.99
            }
        ],
        "bicycle": {
            "color": "red",
            "price": 19.95
        }
    },
    "expensive": 10
}

JsonPath表达式可以使用点符号或者括号符号，例如：

• $.store.book[0].title
• $['store']['book'][0]['title']

JsonPath表达式与其对应的含义如下表所示：

若使用length函数或者size函数，则多次调用时不要使用深度扫描（即“..”符号），例如“$..book.length()”返回书的数量，此时需要确定路径，改为“$.store.book.length()”。