使用前准备

用户想将已有项目的测试用例对接到CodeArts TestPlan自动化测试工厂，需要按照以下条件进行准备：

购买功能测试增值特性

用户在功能测试购买页已购买测试自动化工厂增值特性，可参考测试自动化工厂增值特性。

接入执行器前准备

使用测试自动化工厂需要打通调度平台和执行器之间的网络连接，需要配置VPCEP，可参考配置VPC终端节点 VPCEP。
在配置VPC终端节点中，服务名称可在测试计划服务“测试执行 > 功能自动化 > > 执行器管理”中获取：

图1 获取终端节点服务名称

图2 配置VPC终端节点的服务名称

购买完成后，根据服务节点名称，记录“服务地址”。拼接协议类型（https）和端口号（固定为8043）得到可用的对接地址。如下图，拼接为https://192.168.0.214:8043。
准备ECS资源：测试自动化工厂特性需要依赖ECS资源打通云上云下网络，请参考申请弹性云服务器ECS，购买时请选择“华南-广州”局点，当前测试自动化测试工厂只支持该局点。若您已经有满足条件的ECS资源，可忽略此操作。

您可以根据“通用测试框架场景（满足多个测试框架接入）”或“自定义测试框架场景”，选择接入通用执行器或自主设计、改造的自定义执行机。

登录测试计划服务首页，单击“首页”，选择项目。
在导航栏单击“测试 > 测试执行”。
选择“功能自动化”。
单击“执行器管理 > 执行器接入”。
在弹框中，选择“通用测试框架场景”。
根据需要选择以下测试框架（默认为Pytest）：
- Pytest：用于Python语言的单元自动化测试框架，支持简单的单元测试和复杂的功能测试和接口自动化测试，可以很好地与Jenkins集成。
- Selenium：用于自动化Web应用程序测试的工具，支持多种浏览器和平台，并提供了多种编程语言的绑定，如 Python、Java、C# 等。
- Hypium：适用于构建跨设备应用的自动化测试体系，支持Python语言编写脚本，提供控件定位、多设备并行测试等核心功能。
- Appnium：用于自动化移动应用（iOS、Android）的测试，使用 WebDriver 协议，允许开发者使用 Selenium/WebDriver 的 API 来控制移动设备上的应用。
确认主机有访问外网方式，并且已安装JAVA8和Git。
输入“终端节点地址”，参考接入执行器前准备中的获取终端节点的服务地址。
单击“生成命令”。
单击，复制已生成的命令。
以管理员账户登录待安装主机，执行复制命令（windows通过git bash窗口），当显示【"success"】时，表示安装成功。
完成上述接入执行器步骤后，单击左侧导航栏“测试>测试执行”，选择“功能自动化”页签，单击“新建套件>创建任务”，在执行机列表中找到目标自执行器。

自定义测试框架场景需要开发并启动用户自定义的执行器（TepExecutor），TepExecutor开发示例您可以新建工单联系一线技术支持或您的客户经理获取。

登录测试计划服务首页，单击“首页”，选择项目。
在导航栏单击“测试 > 测试执行”。
选择“功能自动化”。
单击“执行器管理 > 执行器接入”。
在弹框中，选择“自定义测试框架场景”。
确认主机有访问外网方式，并且已安装JAVA8和Git。
输入“终端节点地址”，参考接入执行器前准备中的获取终端节点的服务地址。
单击“下载Agent包”，下载执行器代理（TepAgent）软件包并在本地目录解压。
启动TepAgent，您可以参考以下配置信息，修改配置文件。
- tep.name：用户可自定义执行机名称，该名称在创建功能自动化测试任务中的执行机列表中展示。tep.name需要在tep.productId维度下唯一，如果执行机名称重复，注册时会删除已有重复名的执行机。
- tep.type：执行机类型，对应用例的执行平台，可参考设置CodeArts TestPlan测试用例字段，配置“执行平台”字段后，功能自动化用例中可以选择该字段。
用户完成以上接入自定义执行器后，可单击左侧导航栏“测试>测试执行”，选择“功能自动化”页签，单击“新建套件>创建任务”，在执行机列表中找到tep.name名称的自定义执行机。