
# 导入CodeArts TestPlan接口自动化用例测试数据集
在设计接口自动化用例的脚本中，对于同一个测试逻辑需要读取其他数据，进行多轮参数数据组合，每一次对脚本进行手动配置将非常冗余。
CodeArts TestPlan支持数据驱动能力，支持导入Excel文件读取测试数据，复用到不同测试场景，高效生成并执行多轮接口自动化用例。
#### 前置条件
1. 接口测试用例的脚本中已配置可用的请求地址。
2. 需要将数据集Excel中的字段在接口自动化用例脚本中配置成局部参数，请参考[局部参数](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0016.html#cloudtest_01_0016__section1911995744510)。
 
#### 约束与限制
1. 最多上传100条数据集，最多上传50个参数字段。
2. 一次只能上传一个Excel文件，不支持批量上传。
3. 接口自动化用例测试数据集默认在接口用例调试的DEFAULT公共资源池下执行，不支持在自定义执行机资源下执行。
4. 当和已上传数据集相关的局部参数名称、是否敏感发生变化时，为保证展示和执行的正确性，请重新上传数据集文件
 
#### 操作步骤
1. 单击导航栏"测试 \> 测试用例" 。
2. 在"接口自动化"页签中单击目标用例名称，选择"脚本"页签。
3. 单击![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002071689741.png)图标。
4. 在弹框中，单击默认环境下拉栏，选择用例对应的目标环境。可参考[设置CodeArts TestPlan接口脚本的环境参数](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0052.html)。
5. 单击弹框中"下载示例"，将数据集表格下载到本地。
6. 在本地配置好"数据集描述"与"局部参数字段"，用户可根据需要增加多行数据，每一行将是测试用例执行的一轮。 
   - 数据集描述：非必填，长度范围为1-128个字节。
   
   - 表头字段：每个表头字段需要在用例脚本中已创建局部参数，大小写需要和对应的局部参数保持一致，参数值的规范参照[表1](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0016.html#cloudtest_01_0016__table6130103291413)进行填写。
   
   
   
   
7. 在弹框中单击![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002071776985.png "点击放大")图标，选择本地编辑好的Excel文件，单击"上传"。
   
   ![](https://support.huaweicloud.com/usermanual-testman/public_sys-resources/note_3.0-zh-cn.png)
   1. 最多上传100条数据集，最多上传50个参数字段。
   
   2. 一次只能上传一个Excel文件，不支持批量上传。
   
   3. 导入一次Excel后再次导入新的Excel，弹框中将会保留新导入Excel里的数据集数据，上一个导入的Excel数据将会被清除。
    
   
   
8. 导入成功的参数数据将显示在列表中。单击"清空当前数据集"可以将导入的参数数据全部删除。
9. 导入成功后，单击"关闭"。
10. 在URL请求中，在参数值的值里输入"$"，可以调用已配置的局部参数，执行测试用例时将读取该局部参数所属的参数值。导入数据集后执行接口自动化用例的操作请参考[接口自动化用例中导入数据集后多轮次执行](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0024.html#cloudtest_01_0024__section1471718343315)。
    
    ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002035756988.png "点击放大")
    
    
 
