更新时间：2025-08-22 GMT+08:00
使用前准备
用户想将已有项目的测试用例对接到CodeArts TestPlan自动化测试工厂，需要按照以下条件进行准备：
购买功能测试增值特性
- 用户在功能测试购买页已购买测试自动化工厂增值特性，可参考测试自动化工厂增值特性。
接入执行器前准备
- 使用测试自动化工厂需要打通调度平台和执行器之间的网络连接，需要配置VPCEP，可参考配置VPC终端节点 VPCEP。
在配置VPC终端节点中，服务名称可在测试计划服务中获取：
图1 获取终端节点服务名称
图2 配置VPC终端节点的服务名称
购买完成后，根据服务节点名称，记录“服务地址”。拼接协议类型（https）和端口号（固定为8043）得到可用的对接地址。如下图，拼接为https://192.168.0.214:8043。
- 准备ECS资源：测试自动化工厂特性需要依赖ECS资源打通云上云下网络，请参考申请弹性云服务器ECS，购买时请选择“华南-广州”局点，当前测试自动化测试工厂只支持该局点。若您已经有满足条件的ECS资源，可忽略此操作。
您可以根据“通用测试框架场景”或“自定义测试框架场景”，选择接入通用执行器或自主设计、改造的自定义执行机。
- 登录测试计划服务首页，单击“首页”，选择项目。
- 在导航栏单击。
- 选择“功能自动化”。
- 单击。
- 在弹框中，选择“通用测试框架场景”。
- 输入“终端节点地址”，参考接入执行器前准备中的获取终端节点的服务地址。
- 单击“生成命令”。
- 单击
，复制已生成的命令。 - 以管理员账户登录待安装主机，执行复制命令（windows通过git bash窗口），当显示【"success"】时，表示安装成功。
- 完成上述接入执行器步骤后，单击左侧导航栏“测试>测试执行”，选择“功能自动化”页签，单击“新建套件>创建任务”，在执行机列表中找到目标自执行器。
自定义测试框架场景需要开发并启动用户自定义的执行器（TepExecutor），TepExecutor开发示例您可以新建工单联系一线技术支持或您的客户经理获取。
- 登录测试计划服务首页，单击“首页”，选择项目。
- 在导航栏单击。
- 选择“功能自动化”。
- 单击。
- 在弹框中，选择“自定义测试框架场景”。
- 输入“终端节点地址”，参考接入执行器前准备中的获取终端节点的服务地址。
- 单击“下载Agent包”，下载执行器代理（TepAgent）软件包并在本地目录解压。
- 启动TepAgent，您可以参考以下配置信息，修改配置文件。
- tep.name：用户可自定义执行机名称，该名称在创建功能自动化测试任务中的执行机列表中展示。tep.name需要在tep.productId维度下唯一，如果执行机名称重复，注册时会删除已有重复名的执行机。
- tep.type：执行机类型，对应用例的执行平台，可参考设置CodeArts TestPlan测试用例字段，配置“执行平台”字段后，功能自动化用例中可以选择该字段。
- 用户完成以上接入自定义执行器后，可单击左侧导航栏“测试>测试执行”，选择“功能自动化”页签，单击“新建套件>创建任务”，在执行机列表中找到tep.name名称的自定义执行机。
后续对自定义执行器的操作，可参考执行器管理。
