创建接口自动化测试用例-华为云

测试计划 CODEARTS TESTPLAN-设置CodeArts TestPlan接口脚本的测试用例参数:内置参数

内置参数内置参数是将HTTP/HTTPS响应的对应部分参数化，在检查点、响应提取功能中的“来源”选项中可以选择内置参数。测试计划服务中的内置参数如下表：内置参数参数说明是否支持多级取值用途举例响应体（json）表示接口返回的响应体。是检查点的属性字段参数传递的属性字段检查点：判断响应体中的id等于100。设置方法：设置检查点来源为响应体（JSON），属性为id（前提条件响应体JSON串有id字段），设置比较符为等于（字符串、不区分大小写），设置目标值为100。响应头表示接口返回的响应头。是检查点的属性字段参数传递的属性字段检查点：判断响应头中的token等于abcd。设置方法：设置来源为响应头，属性为token（前提条件响应头有token），设置比较符为等于（字符串、不区分大小写），设置目标值为abcd。响应码表示接口返回的响应码。否检查点的属性或值字变量的属性字段检查点：判断响应码等于200。设置方法：设置来源为响应码，设置比较符为等于（数字），设置目标值为200。内置参数支持多级取值，例如响应体为“{"result":{"appId":12}}”时，则取appId的格式为：来源选择响应体，属性为“result.appId”。如果result是数组格式。则属性为“result[i].appId”，其中，i为非负整数。

测试计划 CODEARTS TESTPLAN 创建接口自动化测试用例

测试计划 CODEARTS TESTPLAN-设置CodeArts TestPlan接口脚本的测试用例参数:局部参数

局部参数局部参数使用范围是当前测试用例，如：测试步骤的参数、检查点、变量等都可以引用局部参数。局部参数引用形式为“${参数名}”，如：参数名为“hostIp”，则可以使用“${hostIp}”来引用该参数。局部参数主要配置项如下：表1 参数主要配置项配置项是否必填描述名称是支持中英文、数字、点号、中文短横线、下划线的半角字符，并且长度范围是1~300。类型是支持文本、随机字符串、随机整数、时间戳、格式化时间戳、生成UUID、Base64编码、MD5哈希值、密码或认证信息、SHA512编码。详情介绍请参考表2。描述否对参数的简要描述，上限为3000字符。默认为当前参数类型的描述。单击“文本框”后，用户可以直接输入文本描述。单击，输入一个json，单击“Json转换”，可以给没有换行的Json添加换行和缩进，单击“回填”添加成功。值否用户可以为不同类型的参数赋值，详情请参考表2。敏感变量否勾选为敏感数据后，测试计划对参数值加密存储，在测试结果日志中使用星号覆盖处理。敏感数据类型适用并不限于个人信息、鉴权信息，例如姓名、地址、用户名等。动态变量否动态参数的值可以在用例执行过程中被赋值。动态参数初始值可为空，被赋值之后，此处显示的是最新值。动态参数赋值方法：在用例测试步骤“响应提取”的“赋值给环境动态参数”中设置后，在测试执行时，响应提取的内容将被赋值给动态参数。表2 参数类型名称描述文本上限为10000字符，支持设置“敏感参数”、“动态参数” ，默认为否。随机字符串随机生成指定长度字符串，随机字符串的变量值长度校验范围【1-9999】，不支持设置“敏感参数”及“动态参数”。随机整数随机生成指定范围整数，区间范围校验为【-999999999~999999999】，不支持设置“敏感参数”及“动态参数” 。例如：设置【-9999,9999】，会获取这个区间内的随机整数。时间戳无需输入，生成当前整数时间戳，不支持设置“敏感参数”及“动态参数”。格式化时间戳参数的值默认为当前时间戳，用户可以单击右侧的下拉栏，选择需要的转化后格式。具体参数类型请参加表1，不支持设置“敏感参数”及“动态参数”。例如：1.yyyy-MM-dd HH:mm:ss：33250825252000 , 预期值为3023-09-05 20:20:52。 2.yyyy-MM-dd：33250825252000，预期值为3023-09-05。生成UUID 无需输入，不支持设置“敏感参数”及“动态参数”。 Base64编码使用Base64方法编码参数，上限为256字符，不支持设置“敏感参数”及“动态参数”。 MD5哈希值使用指定参数生成MD5哈希值，上限为256字符，不支持设置“敏感参数”及“动态参数”。密码或认证信息上限为256字符，不支持设置“敏感参数”及“动态参数”。默认勾选“敏感参数”。 SHA512编码上限为256字符，不支持设置“敏感参数”及“动态参数”。默认勾选“敏感参数”。数组数组的内容是json数组格式，上限为10000字符，不支持设置“敏感参数”及“动态参数”。局部参数配置方法如下：在界面新建变量进入接口自动化用例编辑的“脚本”页签，单击图标。单击左上方“新建变量”，输入参数名、类型、值。全部参数设置完毕，单击“保存”。从本地批量导入变量进入接口自动化用例编辑的“脚本”页签，单击图标。单击“导入”。在弹框中单击“下载模板”。按照模板中的格式要求填写参数信息，返回页面，在弹框中单击，上传编写好的文档，单击“确定”。查看导入结果：导入成功：列表中将新增参数，新增的参数条数与Excel中编辑的行数相同。导入失败：页面右上角会显示弹框提示失败，单击“详情”可以查看错误原因，修改后请重新导入。

测试计划 CODEARTS TESTPLAN 创建接口自动化测试用例

测试计划 CODEARTS TESTPLAN-设置CodeArts TestPlan接口脚本的环境参数:环境参数值使用内置函数的设置说明

环境参数值使用内置函数的设置说明环境参数不支持内置函数嵌套，如果有嵌套则原样输出。环境参数支持的内置函数如表1。表1 环境参数支持的内置函数表序号函数描述 1 $random_string(intA) 生成指定长度随机字符串 2 $random_int(intA, intB) 生成指定范围随机数 3 $timestamp() 获取当前时间戳 4 $timestamp_format(String A, String B) 时间戳转日期 5 $uuid() 生成UUID 6 $encode_base64(StringA) 生成Base64编码 7 $md5(StringA) 生成MD5哈希值 8 $sha512(StringA) 生成SHA512编码环境参数支持内置函数使用举例如下。正常场景：引用$random_string(intA)，输出$random_string(intA)。正常场景：函数前后拼接字符，按照字符串解析，原样输出。例如引用aa$random_string(10)或者$random_string(10)aa，则输出aa$random_string(10)或者$random_string(10)aa。异常场景：传参所需一个参数，实际传两个参数，例如$random_string(1,1) ，执行时抛出异常。传参类型和实际函数所需参数类型不匹配，例如$random_string(fff)或$random_string() ，执行时抛出异常。

测试计划 CODEARTS TESTPLAN 创建接口自动化测试用例

测试计划 CODEARTS TESTPLAN-设置CodeArts TestPlan接口脚本的环境参数:动态变量说明

动态变量说明测试套件中的多个用例间可能存在上下文关系，后执行的用例依赖先执行用例中接口的返回结果。例如所有的接口都需要鉴权信息，且鉴权信息有时效性，如果在每个用例里都去获取鉴权信息，用例的测试步骤会显得冗余，不易维护。使用动态全局变量即可避免上述问题，在第一个执行的用例中获取鉴权信息后赋值给动态全局变量，后面执行的用例直接使用动态全局变量即可，无需重复获取鉴权信息。设置动态变量。在“接口自动化测试用例列表”页面，单击页面右侧“更多”，选择“环境参数”。选中动态变量列的复选框，单击“保存”，将全局参数设置为动态参数。赋值动态变量。在接口自动化用例中，选择URL请求的“响应提取”标签下，单击匹配列的“添加”按钮。在“赋值给环境动态参数”下拉列表中希望赋值的全局动态参数。使用动态变量。在测试用例中使用动态变量。在需要使用全局动态变量的用例中，引用动态全局变量，引用方式请参见环境参数引用形式。在测试套件中使用动态全局变量。将2和3中的用例按顺序添加到测试套件中，选择“串行执行”，即可让使用动态变量的用例执行时使用到动态全局变量被赋值的最新值。并行执行时动态变量的赋值和使用顺序不能保证，因此不推荐在并行执行时使用动态全局变量。

测试计划 CODEARTS TESTPLAN 创建接口自动化测试用例

测试计划 CODEARTS TESTPLAN-设置CodeArts TestPlan接口脚本的环境参数:环境参数设置方法

环境参数设置方法进入接口自动化用例编辑的“脚本”页签，单击图标。单击“新建变量”，输入参数信息，单击“确定”。配置项说明参数名参数的名称。类型参数的类型。支持文本、随机字符串、随机整数、时间戳等多种类型。值参数的值。描述对参数的描述。敏感参数勾选为敏感数据后，对参数值加密存储，在测试结果日志中使用星号覆盖处理。敏感数据类型适用并不限于个人信息、鉴权信息，例如姓名、地址、用户名等。动态参数动态参数设置，动态参数的值可以在用例执行过程中被赋值。动态参数初始值可为空，被赋值之后，此处显示的是最新值。在用例测试步骤“响应提取”的“赋值给环境动态参数”列中设置后，在测试执行时，响应提取的内容将被赋值给动态参数。详细介绍请参见动态变量说明。页面中会有一个默认环境。如果需要设置其它环境为默认环境，单击该环境卡片右上角图标，在下拉列表中选择“设为默认环境”。

测试计划 CODEARTS TESTPLAN 创建接口自动化测试用例

测试计划 CODEARTS TESTPLAN-设置CodeArts TestPlan接口脚本的环境参数:环境参数引用形式

环境参数引用形式环境参数的引用形式为“$${参数名}”。例如：参数名为“hostname”，则可以使用“$${hostname}”来引用该参数。根据需要可以对环境参数进行分组配置管理，例如：参数hostname在类生产环境中的值为“stage.example.com”，在生产环境中的值为“prod.example.com”，测试脚本使用“$${hostname}”引用该参数，执行测试时选择不同环境执行，实现一套接口自动化用例在所有环境复用。

测试计划 CODEARTS TESTPLAN 创建接口自动化测试用例

云服务器内容精选

创建接口自动化测试用例

7*24

备案

专业服务

退订

建议反馈

售前咨询热线