华为云用户手册

从postman文件导入 接口自动化测试用例支持通过导入Postman文件，生成测试步骤。 导入Postman文件需满足以下要求： 支持Postman Collection v2.1标准。 仅支持Postman请求方法、请求URL、请求头、请求体生成测试步骤。 Postman请求体导入方式仅支持form-data、x-www-form-urlencode、raw。 Postman请求体form-data上传附件需要在测试步骤中单独上传。 单击“Postman”，弹出“导入Postman Colection文件”对话框。 上传需要导入的postman文件,单击“确定”，导入postman请求文件，完成测试步骤添加。

从接口/接口用例导入 用户可以将API设计的数据导入测试步骤，主要有两个来源：“从【接口用例】导入（推荐）”和“从【接口】导入”。 从【接口用例】导入（推荐） 在弹出的“从【接口用例】导入（推荐）”对话框上，选择需要导入的接口，即“API设计”中接口的调试用例，参考保存为用例。 单击“导入”，完成测试步骤添加。 从【接口】导入 在弹出的“从【接口】导入”对话框上，选择需要导入的接口，即“API设计”的接口数据。 单击“导入”，完成测试步骤添加。

新建变量 在“环境参数”页面，单击，即可添加一个变量，根据需要填写变量信息： 参数项 说明 名称 当前环境变量参数名，可使用“$${参数名}”形式进行引用。 类型 包括：文本、随机字符串、随机整数、时间戳、格式化时间戳、生成UUID、Base64编码、MD5哈希值、密码或认证信息、SHA512编码。 值 当前环境变量的值，支持加密显示。 描述 根据不同类型，自动添加默认描述，也可根据设计需要自定义描述。 敏感变量 勾选为敏感变量后，云测对参数值加密存储，在测试结果日志中使用星号覆盖处理。敏感数据类型适用并不限于个人信息、鉴权信息等，如：姓名、地址、用户名等。 动态变量 动态参数的值可以在用例执行过程中被赋值。动态参数初始值可为空，被赋值之后，此处显示的是最新值。 动态参数赋值方法：在用例测试步骤“响应提取”的“赋值给环境动态参数”中设置后，测试执行时，响应提取的内容将被赋值给动态参数。

参数使用 环境参数可以用于整个项目，如：测试步骤的参数、检查点、变量、URL等都可以引用环境参数。 环境参数的引用形式为“$${参数名}”，如：参数名为“hostname”，则可以使用“$${hostname}”来引用该参数。可以按环境上下文配置环境参数，如：类生产环境中hostname=stage.example.com，生产环境中hostname=prod.example.com。测试执行时可选择环境执行。

全局代理设置 使用系统代理 进入网络代理设置页面后，默认使用系统代理。 可根据需要选择是否优先使用系统环境变量HTTP_PROXY、HTTPS_PROXY、NO_PROXY，勾选后，CodeArts API会优先调用系统环境变量。 身份认证：请查看身份认证。 不使用代理 选择不使用代理时，此时CodeArts API不使用任何代理（包含系统代理）连接服务器。 自定义 选择自定义代理时，需配置“接口类型”、“代理服务器”、“身份认证”、“Proxy Bypass”。 接口类型：接口类型默认HTTP和HTTPS全选，支持两种协议类型的代理。 代理服务器：需输入代理服务器地址和端口。 身份认证：请查看身份认证。 Proxy Bypass：无需进行代理转发的IP或域名，可填入多个，以英文逗号进行分隔。

创建测试套件 自动化测试套件，实现用例串行/并行执行的策略，测试用例分块加速能力，有效提高资源池利用率，减少任务阻塞情况。并且可提前拦截产品缺陷，更加快速地发现问题。 在“API测试”主页，单击“新建测试套件”。 在“新建测试套件”页面，填写用例名称与描述。 单击，弹出“添加测试用例”对话框，选择需要添加到测试套件的测试用例，单击“确定”。 单击，弹出“执行策略”对话框，根据需要配置执行策略，单击“确定”。 定时类型：执行一次、周期性重复执行，周期性指设置一个执行频率，测试套按照这个频率周期重复执行。 任务开始时间：立即执行、指定开始时间。 执行时间区间：全天执行、指定执行区间，即指定套件执行的时间段。 用例超时时间：设置每个用例的最长执行时间，超过时间，用例则超时失败。 任务继续执行，直到最后一个用例执行完毕。可设置分钟级，小时级，天级。 回到当前测试套件页面，单击右上角“保存“，完成自动化测试套件创建。 父主题： 测试套件管理

内置参数 内置参数是将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为非负整数。

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

接口自动化用例系统关键字 接口自动化测试将常见的操作封装成关键字供用户使用，用于提升编写接口测试用例的效率。 使用系统关键字高阶特性，需要开通TestPlan专业版套餐或CodeArts专业版以上套餐。 表1 系统关键字一览表 分类 关键字集 认证类 认证类—GetIAMToken 认证类—OAuth2ForOneAccess 数据库操作类 数据库类—MySQLQuery 数据库类—MySQLUpdate 数据库类—MySQLInsert 数据库类—MySQLDelete 数据库类—OpenGaussQuery 数据库类—OpenGaussUpdate 数据库类—OpenGaussInsert 数据库类—OpenGaussDelete 数据库类—PostgreSQLQuery 数据库类—PostgreSQLUpdate 数据库类—PostgreSQLInsert 数据库类—PostgreSQLDelete 数据库类—MongoDBQuery 数据库类—MongoDBInsert 数据库类—MongoDBUpdate 数据库类—MongoDBDelete 中间件类 中间件类—RedisGet 中间件类—RedisSet 中间件类—OBSWrite 中间件类—OBSDelete 中间件类—OBSQuery 中间件类—KafkaProducer 中间件类—KafkaConsumer 协议类 协议类—TCP 协议类—UDP 协议类—WSConnect 协议类—WSRequest 协议类—WSWriteOnly 协议类—WSReadOnly 协议类—WSDisConnect 协议类—MQTTConnect 协议类—MQTTDisconnect 协议类—MQTTPublish 协议类—MQTTSubscribe 协议类—DubboClient 具体请参考CodeArts Testplan的接口自动化用例系统关键字。

关键字库入口 在“脚本”页签，页面右侧展示“关键字库”。 通过Swagger文件导入的关键字放置在关键字库的“接口”页签中，详细操作请参考接口关键字。 关键字用例和组合关键字放置在关键字库的“组合”页签中，支持从0到1创建新的组合关键字，详细操作请参考组合关键字。 认证类、数据库操作类、中间件类、协议类等实用关键字放置在“系统”页签中，详细操作请参考接口自动化用例关键字。 单击关键字库中“名称”下拉列表，可以按照“名称”、“描述”，搜索对应的关键字。

接口关键字 接口关键字中定义单个接口的请求，可以通过导入Swagger文件、保存自定义URL请求等方式生成。 导入Swagger文件生成数据 在右侧“关键字库”界面，单击“导入接口”。 在弹出的“导入接口”页面，单击“点击添加文件或拖拽上传”，选择配置好的Swagger接口文档，单击“确定”，完成Swagger文件导入。 文档导入成功后，系统自动解析生成脚本模板，脚本模板包含了接口的基本描述信息。可以从“关键字库”界面单击“+”或直接拖拽接口添加至测试步骤，只需要按模板输入接口参数就可以进行测试。 具体请参考CodeArts Testplan的接口关键字。

响应体（JSON）检查 检查响应体（JSON）中对象字段的值。例如： 响应体结构如下： 检查响应体对象中字段名为“status”的值，检查点配置如下： 检查响应体（JSON）中某个数组的对象的字段值（数组条件采用下标确定对象，下标从0开始）。例如： 响应体结构如下： 检查响应体“result”数组的第1个元素对象字段名为“userId”的值，检查点配置如下： 检查响应体（JSON）中某个数组的对象的字段值（数组条件采用模糊匹配功能确定对象）。例如： 响应体结构如下： a.检查响应体“result”数组下“name”是“啤酒”的所有对象取第1个之后获取id的值，检查点配置如下： 当获取的数组下的对象只有一个，“[0]”可以省略，示例中的表达式可以写为“result[name==啤酒].id”。 b.检查响应体“result”数组下“name”是“啤酒”的并且“obj”对象下属性“a”的值是“2”的对象的id值，检查点配置如下：

检查点说明 测试检查点即请求结果的断言，通过检查接口响应是否符合预期，判定系统是否满足预期。 在接口自动化用例中，测试步骤的“检查点”页签中可以定义测试检查点。 检查点内容包括属性、比较符和目标值定义。 字段 说明 重试次数 如果检查点失败，重新执行该测试步骤的次数，重试次数范围：0~5的正整数。 重试间隔 如果检查点失败，每次重试的间隔时长，单位为ms，重试间隔范围：0~10,000的正整数。 来源 被检测字段的来源，如响应体（JSON）、响应头、响应码、变量。 属性 若来源是响应码，属性可为空。详细介绍请参见响应码检查。 若来源是响应头，属性为响应头中字段的名称。详细介绍请参见响应头检查。 若来源是响应体（JSON），属性有两种填写方法： 普通提取表达式（非“$”开头），例如“item.name”。 取字段中的值，支持嵌套取值。详细介绍请参见响应体（JSON）检查。 从响应体中提取数组时，下标可以是数字，也可以是“key:value”表达式，详细介绍请参见示例：根据给定的key:value从响应体中获取字符串。 JsonPath表达式(“$.”或“$[”开头)，例如“$.store.book[0].title”。 详细介绍请参见示例：根据JsonPath从响应体中获取数据。 若来源是变量，属性为全局变量，局部变量，响应提取后的变量。详细介绍请参见变量检查。 高级提取类型 可选项，使用高级提取类型，辅助提取检查点信息，若选择不涉及，则视为不使用额外的方式匹配。 目前有两种方式： 字符串提取，也就是字符串的截取。 正则表达式，即使用正则方式对来源字符串进行过滤。 高级提取类型优先使用字符串提取功能，若不能满足需求可考虑使用正则表达式。 类型值 高级提取类型中所需的参数。 比较符 支持数字、字符串、JSON对象比较、类型比较等多种比较符，详细介绍请参见比较符说明。 目标值 检查点期望值。目标值支持使用内置参数，请参考内置参数了解如何使用内置参数。 例如，检查响应体（JSON格式）中“item.name”字段的第零位（首位）到第四位之间是不是petty，参数配置如下： 字段 值 来源 响应体（JSON） 属性 item.name 高级提取类型 字符串提取 类型值 0、5 比较符 等于(字符串) 目标值 petty

比较符说明 支持以下比较类型： 比较类型 比较符 是否需要填入值 举例 数字比较 等于(数字) 不等于(数字) 大于等于(数字) 小于等于(数字) 大于(数字) 小于(数字) 是 响应码 等于 200 响应码 不等于 200 响应码 大于等于 200 响应码 小于等于 200 响应码 大于 200 响应码 小于 200 字符串比较 等于(字符串、区分大小写) 不等于(字符串、区分大小写) 等于(字符串、不区分大小写) 包含(字符串) 不包含(字符串) 是 响应体中的属性param1 等于 test 响应体中的属性param2 不等于 test 响应体中的属性param3 等于 TEST 响应体中的属性param4包含 tri 响应体中的属性param5不包含 tri 正则比较 正则表达式 是 响应体中的属性param1 正则表达式 ^[A-Za-z0-9]{1,32}$ 通用比较 是空（该字段是否为空，即是否没有该字段） 不是空（该字段是否不为空，即是否有该字段） 否 响应体中的属性param1 是空 响应体中的属性param2 不是空 Json数组比较 JSON数组为空数组（json数组是否为空数组） JSON数组为非空数组（json数组是否为非空数组） 否 响应体中的属性param1 JSON数组为空数组 响应体中的属性param2 JSON数组为非空数组 JSON数组的大小（json数组的大小是否为...） 是 响应体中的属性param1 JSON数组的大小 类型比较 是JSON类型（是否是json对象类型） 是JSON数组类型（是否是json数组类型） 否 响应体中的属性param1 是JSON类型 响应体中的属性param2 是JSON数组类型 Json对象比较 JSON等于（json等于） 是 响应体中的属性param1 JSON等于 {"name":"zhangsan"}

响应提取 响应提取是提取接口响应结果的某一部分，命名为参数，供后续测试步骤参数化调用。响应提取需要在前序测试步骤定义，后续测试步骤使用。 在前序测试步骤中，在“响应提取”页签创建要传递的参数。响应提取来源用到内置参数，请参考内置参数了解如何使用内置参数。响应提取同时支持正则表达式的匹配，提取出与给定正则表达式匹配的返回值。 在后续测试步骤中，通过“${参数名}”方式引用前序测试步骤创建的响应提取。后续步骤的URL、请求头、请求体中均可以引用此参数。如果在JSON格式的请求体中引用此参数，请在参数外使用英文引号，如： { id: "用例ID" name:"${name}" } 响应提取支持根据给定的“key:value”获取字符串，详细配置可参考示例：根据给定的key:value从响应体中获取字符串。 字段 说明 出参名称 用于之后使用${出参名称}来引用此参数，名称使用字母数字下划线。 来源 被检测字段的来源，如响应体（JSON）、响应头、响应码。 属性 若来源是响应码，属性为空。详细介绍请参见响应码检查。 若来源是响应头，属性为响应头中字段的名称。详细介绍请参见响应头检查。 若来源是响应体（JSON），属性有两种填写方法： 普通提取表达式（非“$”开头），例如“item.name”。 取字段中的值，支持嵌套取值。详细介绍请参见响应体（JSON）检查。 从响应体中提取数组时，下标可以是数字，也可以是“key:value”表达式，详细介绍请参见示例：根据给定的key:value从响应体中获取字符串。 JsonPath表达式(“$.”或“$[”开头)，例如“$.store.book[0].title”。 详细介绍请参见示例：根据JsonPath从响应体中获取数据。 高级提取类型 可选项，使用高级提取类型，辅助提取响应结果信息，若选择不涉及则视为不使用额外的方式匹配。 目前有两种方式： 字符串提取，也就是字符串的截取。 正则表达式，即使用正则方式对来源字符串进行过滤。 高级提取类型优先使用字符串提取功能，若不能满足需求可考虑使用正则表达式。 赋值给环境动态参数 将响应提取后的值赋值给动态变量，用于后续测试引用。请参考新建变量，如何设置动态变量。 父主题： 测试用例管理

创建测试套件 自动化测试套件，实现用例串行/并行执行的策略，测试用例分块加速能力，有效提高资源池利用率，减少任务阻塞情况。并且可提前拦截产品缺陷，更加快速地发现问题。 在“API测试”主页，单击“新建测试套件”。 在“新建测试套件”页面，填写用例名称与描述。 单击，弹出“添加测试用例”对话框，选择需要添加到测试套件的测试用例，单击“确定”。 单击，弹出“执行策略”对话框，根据需要配置执行策略，单击“确定”。 定时类型：执行一次、周期性重复执行，周期性指设置一个执行频率，测试套按照这个频率周期重复执行。 任务开始时间：立即执行、指定开始时间。 执行时间区间：全天执行、指定执行区间，即指定套件执行的时间段。 用例超时时间：设置每个用例的最长执行时间，超过时间，用例则超时失败。 任务继续执行，直到最后一个用例执行完毕。可设置分钟级，小时级，天级。 回到当前测试套件页面，单击右上角“保存“，完成自动化测试套件创建。 父主题： 测试套件管理

内置参数 内置参数是将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为非负整数。

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

接口自动化用例系统关键字 接口自动化测试将常见的操作封装成关键字供用户使用，用于提升编写接口测试用例的效率。 使用系统关键字高阶特性，需要开通TestPlan专业版套餐或CodeArts专业版以上套餐。 表1 系统关键字一览表 分类 关键字集 认证类 认证类—GetIAMToken 认证类—OAuth2ForOneAccess 数据库操作类 数据库类—MySQLQuery 数据库类—MySQLUpdate 数据库类—MySQLInsert 数据库类—MySQLDelete 数据库类—OpenGaussQuery 数据库类—OpenGaussUpdate 数据库类—OpenGaussInsert 数据库类—OpenGaussDelete 数据库类—PostgreSQLQuery 数据库类—PostgreSQLUpdate 数据库类—PostgreSQLInsert 数据库类—PostgreSQLDelete 数据库类—MongoDBQuery 数据库类—MongoDBInsert 数据库类—MongoDBUpdate 数据库类—MongoDBDelete 中间件类 中间件类—RedisGet 中间件类—RedisSet 中间件类—OBSWrite 中间件类—OBSDelete 中间件类—OBSQuery 中间件类—KafkaProducer 中间件类—KafkaConsumer 协议类 协议类—TCP 协议类—UDP 协议类—WSConnect 协议类—WSRequest 协议类—WSWriteOnly 协议类—WSReadOnly 协议类—WSDisConnect 协议类—MQTTConnect 协议类—MQTTDisconnect 协议类—MQTTPublish 协议类—MQTTSubscribe 协议类—DubboClient 具体请参考CodeArts Testplan的接口自动化用例系统关键字。

接口关键字 接口关键字中定义单个接口的请求，可以通过导入Swagger文件、保存自定义URL请求等方式生成。 导入Swagger文件生成数据 在右侧“关键字库”界面，单击“导入接口”。 在弹出的“导入接口”页面，单击“点击添加文件或拖拽上传”，选择配置好的Swagger接口文档，单击“确定”，完成Swagger文件导入。 文档导入成功后，系统自动解析生成脚本模板，脚本模板包含了接口的基本描述信息。可以从“关键字库”界面单击“+”或直接拖拽接口添加至测试步骤，只需要按模板输入接口参数就可以进行测试。 具体请参考CodeArts Testplan的接口关键字。

关键字库入口 在“脚本”页签，页面右侧展示“关键字库”。 通过Swagger文件导入的关键字放置在关键字库的“接口”页签中，详细操作请参考接口关键字。 关键字用例和组合关键字放置在关键字库的“组合”页签中，支持从0到1创建新的组合关键字，详细操作请参考组合关键字。 认证类、数据库操作类、中间件类、协议类等实用关键字放置在“系统”页签中，详细操作请参考接口自动化用例关键字。 单击关键字库中“名称”下拉列表，可以按照“名称”、“描述”，搜索对应的关键字。

检查点说明 测试检查点即请求结果的断言，通过检查接口响应是否符合预期，判定系统是否满足预期。 在接口自动化用例中，测试步骤的“检查点”页签中可以定义测试检查点。 检查点内容包括属性、比较符和目标值定义。 字段 说明 重试次数 如果检查点失败，重新执行该测试步骤的次数，重试次数范围：0~5的正整数。 重试间隔 如果检查点失败，每次重试的间隔时长，单位为ms，重试间隔范围：0~10,000的正整数。 来源 被检测字段的来源，如响应体（JSON）、响应头、响应码、变量。 属性 若来源是响应码，属性可为空。详细介绍请参见响应码检查。 若来源是响应头，属性为响应头中字段的名称。详细介绍请参见响应头检查。 若来源是响应体（JSON），属性有两种填写方法： 普通提取表达式（非“$”开头），例如“item.name”。 取字段中的值，支持嵌套取值。详细介绍请参见响应体（JSON）检查。 从响应体中提取数组时，下标可以是数字，也可以是“key:value”表达式，详细介绍请参见示例：根据给定的key:value从响应体中获取字符串。 JsonPath表达式(“$.”或“$[”开头)，例如“$.store.book[0].title”。 详细介绍请参见示例：根据JsonPath从响应体中获取数据。 若来源是变量，属性为全局变量，局部变量，响应提取后的变量。详细介绍请参见变量检查。 高级提取类型 可选项，使用高级提取类型，辅助提取检查点信息，若选择不涉及，则视为不使用额外的方式匹配。 目前有两种方式： 字符串提取，也就是字符串的截取。 正则表达式，即使用正则方式对来源字符串进行过滤。 高级提取类型优先使用字符串提取功能，若不能满足需求可考虑使用正则表达式。 类型值 高级提取类型中所需的参数。 比较符 支持数字、字符串、JSON对象比较、类型比较等多种比较符，详细介绍请参见比较符说明。 目标值 检查点期望值。目标值支持使用内置参数，请参考内置参数了解如何使用内置参数。 例如，检查响应体（JSON格式）中“item.name”字段的第零位（首位）到第四位之间是不是petty，参数配置如下： 字段 值 来源 响应体（JSON） 属性 item.name 高级提取类型 字符串提取 类型值 0、5 比较符 等于(字符串) 目标值 petty

比较符说明 支持以下比较类型： 比较类型 比较符 是否需要填入值 举例 数字比较 等于(数字) 不等于(数字) 大于等于(数字) 小于等于(数字) 大于(数字) 小于(数字) 是 响应码 等于 200 响应码 不等于 200 响应码 大于等于 200 响应码 小于等于 200 响应码 大于 200 响应码 小于 200 字符串比较 等于(字符串、区分大小写) 不等于(字符串、区分大小写) 等于(字符串、不区分大小写) 包含(字符串) 不包含(字符串) 是 响应体中的属性param1 等于 test 响应体中的属性param2 不等于 test 响应体中的属性param3 等于 TEST 响应体中的属性param4包含 tri 响应体中的属性param5不包含 tri 正则比较 正则表达式 是 响应体中的属性param1 正则表达式 ^[A-Za-z0-9]{1,32}$ 通用比较 是空（该字段是否为空，即是否没有该字段） 不是空（该字段是否不为空，即是否有该字段） 否 响应体中的属性param1 是空 响应体中的属性param2 不是空 Json数组比较 JSON数组为空数组（json数组是否为空数组） JSON数组为非空数组（json数组是否为非空数组） 否 响应体中的属性param1 JSON数组为空数组 响应体中的属性param2 JSON数组为非空数组 JSON数组的大小（json数组的大小是否为...） 是 响应体中的属性param1 JSON数组的大小 类型比较 是JSON类型（是否是json对象类型） 是JSON数组类型（是否是json数组类型） 否 响应体中的属性param1 是JSON类型 响应体中的属性param2 是JSON数组类型 Json对象比较 JSON等于（json等于） 是 响应体中的属性param1 JSON等于 {"name":"zhangsan"}

响应体（JSON）检查 检查响应体（JSON）中对象字段的值。例如： 响应体结构如下： 检查响应体对象中字段名为“status”的值，检查点配置如下： 检查响应体（JSON）中某个数组的对象的字段值（数组条件采用下标确定对象，下标从0开始）。例如： 响应体结构如下： 检查响应体“result”数组的第1个元素对象字段名为“userId”的值，检查点配置如下： 检查响应体（JSON）中某个数组的对象的字段值（数组条件采用模糊匹配功能确定对象）。例如： 响应体结构如下： a.检查响应体“result”数组下“name”是“啤酒”的所有对象取第1个之后获取id的值，检查点配置如下： 当获取的数组下的对象只有一个，“[0]”可以省略，示例中的表达式可以写为“result[name==啤酒].id”。 b.检查响应体“result”数组下“name”是“啤酒”的并且“obj”对象下属性“a”的值是“2”的对象的id值，检查点配置如下：

响应提取 响应提取是提取接口响应结果的某一部分，命名为参数，供后续测试步骤参数化调用。响应提取需要在前序测试步骤定义，后续测试步骤使用。 在前序测试步骤中，在“响应提取”页签创建要传递的参数。响应提取来源用到内置参数，请参考内置参数了解如何使用内置参数。响应提取同时支持正则表达式的匹配，提取出与给定正则表达式匹配的返回值。 在后续测试步骤中，通过“${参数名}”方式引用前序测试步骤创建的响应提取。后续步骤的URL、请求头、请求体中均可以引用此参数。如果在JSON格式的请求体中引用此参数，请在参数外使用英文引号，如： { id: "用例ID" name:"${name}" } 响应提取支持根据给定的“key:value”获取字符串，详细配置可参考示例：根据给定的key:value从响应体中获取字符串。 字段 说明 出参名称 用于之后使用${出参名称}来引用此参数，名称使用字母数字下划线。 来源 被检测字段的来源，如响应体（JSON）、响应头、响应码。 属性 若来源是响应码，属性为空。详细介绍请参见响应码检查。 若来源是响应头，属性为响应头中字段的名称。详细介绍请参见响应头检查。 若来源是响应体（JSON），属性有两种填写方法： 普通提取表达式（非“$”开头），例如“item.name”。 取字段中的值，支持嵌套取值。详细介绍请参见响应体（JSON）检查。 从响应体中提取数组时，下标可以是数字，也可以是“key:value”表达式，详细介绍请参见示例：根据给定的key:value从响应体中获取字符串。 JsonPath表达式(“$.”或“$[”开头)，例如“$.store.book[0].title”。 详细介绍请参见示例：根据JsonPath从响应体中获取数据。 高级提取类型 可选项，使用高级提取类型，辅助提取响应结果信息，若选择不涉及则视为不使用额外的方式匹配。 目前有两种方式： 字符串提取，也就是字符串的截取。 正则表达式，即使用正则方式对来源字符串进行过滤。 高级提取类型优先使用字符串提取功能，若不能满足需求可考虑使用正则表达式。 赋值给环境动态参数 将响应提取后的值赋值给动态变量，用于后续测试引用。请参考新建变量，如何设置动态变量。 父主题： 测试用例管理

个人空间 个人空间是用户存放个人文件的空间，仅用户自己可见。创建用户时若分配了个人空间且空间为启用状态则用户个人空间页面可见。 个人空间页面主要由文件(夹)辅助操作和文件(夹)列表/卡片视图两部分组成。 图1 个人空间列表页 文件(夹)辅助操作 操作按钮：提供上传、新建、下载、移动、复制、删除等操作。 已选中X个文件/文件夹：以灰色字体展示当前列表/卡片视图下文件(夹)总个数或已选中文件(夹)个数。 ：按照文件(夹)名称关键字搜索个人空间下的文件(夹)，支持模糊搜索。 ：通过“全部类型”下拉框选择列表/卡片视图中展示的文件(夹)类型。 ：单击后以列表视图展示个人空间文件(夹)。 ：单击后以卡片视图展示个人空间文件(夹)。 文件(夹)列表/卡片视图 列表视图中展示文件(夹)名、文件大小、格式、更新时间。支持按照文件(夹)名、文件大小、格式、更新时间升序或降序排列。默认按照更新时间降序排列，文件夹排序始终在上方。若文件为图片文件，则文件名中展示图片缩略图，单击可查看图片原图。 卡片视图中展示文件(夹)名、更新时间，根据文件(夹)格式展示对应图标。默认按照更新时间降序排列，文件夹排序始终在上方。若文件为图片文件，则卡片中展示图片缩略图，单击可查看图片原图。 文件(夹)列表/卡片视图都提供文件(夹)管理操作，包括： 上传/下载文件 新建文件夹 重命名/移动/复制/删除/收藏与取消收藏/搜索/分享文件(夹) 转发个人文件至本部门团队空间 查看文件(夹)详细信息 父主题： 用户中心界面一览

收藏 用户在个人空间和团队空间收藏的文件(夹)可以在收藏列表中查看。 图1 收藏页面 收藏页面主要由文件(夹)辅助操作和收藏文件列表/卡片视图两部分组成。 文件(夹)辅助操作 操作按钮：提供取消收藏操作。 已选中X个文件/文件夹：以灰色字体展示当前列表/卡片视图文件(夹)总个数或已选中文件(夹)个数。 ：通过“全部类型”下拉框选择列表/卡片视图中展示的文件(夹)类型。 ：单击后以列表视图展示当前团队空间文件(夹)。 ：单击后以卡片视图展示当前团队空间文件(夹)。 收藏文件列表/卡片视图 列表视图中展示收藏的文件(夹)名称、文件大小、格式、所在空间以及收藏时间，默认按照收藏时间倒序排列展示，支持按照文件格式进行过滤，单击文件(夹)所在空间即可跳转至文件(夹)所在目录。 卡片视图中展示收藏的文件(夹)名称以及收藏时间，根据文件(夹)格式展示对应图标。 文件(夹)列表/卡片都提供收藏与取消收藏操作。 父主题： 用户中心界面一览

回收站 KooDrive将回收站分为个人回收站和团队回收站，个人空间和团队空间无需留存的文件被删除后进入到回收站，管理员可以操作拥有管辖权的所有团队回收站里的文件(夹)。普通用户只能操作自己个人回收站的文件夹。 回收站页面主要由文件(夹)辅助操作和文件(夹)列表/卡片视图两部分组成。 图1 回收站页面 文件(夹)辅助操作 操作按钮：提供清空、恢复、彻底删除操作。 已选中X个文件/文件夹：以灰色字体展示当前列表/卡片视图下文件(夹)总个数或已选中文件(夹)个数。 ：按照文件(夹)名称关键字搜索当前个人回收站或部门回收站的文件(夹)，支持模糊搜索。 ：通过“全部类型”下拉框选择列表/卡片视图中展示的文件(夹)类型。 ：单击后以列表视图展示个人回收站或部门回收站文件(夹)。 ：单击后以卡片视图展示个人回收站或部门回收站文件(夹)。 文件(夹)列表/卡片视图 列表视图中展示回收站里文件(夹)名、归属者、大小、原始目录、删除时间。支持按照文件(夹)名、大小、删除时间升序或降序排列。 卡片视图中展示文件(夹)名、删除时间，根据文件(夹)格式展示对应图标。 文件(夹)列表/卡片视图都提供回收站文件(夹)管理操作，包括： 清空、恢复、彻底删除团队回收站文件(夹) 清空、恢复、彻底删除个人回收站文件(夹) 父主题： 用户中心界面一览

操作步骤 登录KooDrive服务业务面。 目前仅支持使用华为账号登录KooDrive服务业务面。 进入任意文件列表页面。例如进入某一团队空间文件列表页面。 在文件列表右上角“全部类型”下拉框中选择“文档”、“表格”或“PPT”，过滤出所需文件类型。 过滤后缀格式为pdf文件时请选择“其他”。 在线预览文件。 单击待预览文件的文件名，进入协作文档预览页面，例如预览的是一个word文档。 在协作文档预览页面可以通过翻页方式查看文档内容，还可以下载、收藏该文档。 下载：单击右上角，在浏览器“下载内容”中可以查看下载该文件。 收藏：单击右上角，在收藏列表页面可以查看收藏该文件。 在线协同编辑文件。 在协作文档预览页面右上方单击“在线编辑”，进入文件编辑页面编辑文件。 若多人正在共同编辑此文档时，文档右侧展示所有协同编辑人的头像。 修改文档内容后，保存新的文档版本。 手动保存：键盘键入Ctrl+S或者在协作文档预览页面右上方单击“退出编辑”。 自动保存：一分钟内未修改文件内容，自动保存。

约束与限制 目前仅支持预览文件的最新版本。 支持在线预览的文件类型及后缀格式如表1所示。 表1 支持在线预览的文件类型及格式 文件类型 文件后缀格式 文字文件 doc，dot，wps，wpt，docx，dotx，docm，dotm，rtf ，txt，mht，mhtml，htm，html 表格文件 xls，xlt，et，xlsx，xltx，csv，xlsm，xltm，ett 演示文件 ppt，pptx，pptm，ppsx，ppsm，pps，potx，potm，dpt，dps，pot 版式文件 pdf ，ofd 支持在线编辑的文件类型及后缀格式如表2所示。 表2 支持在线编辑的文件类型及格式 文件类型 文件后缀格式 文字文件 doc，dot，wps，wpt，docx，dotx，docm，dotm 表格文件 xls，xlt，et，xlsx，xltx，xlsm，xltm 演示文件 ppt，pptx，pptm，ppsx，ppsm，pps，potx，potm，dpt，dps 版式文件 pdf