本章节适用于用例编辑者阅读。

    用例，通俗来讲，就是多个接口的集合，在用例中，接口按照顺序依次执行。在星空API自动化测试中，我们通常将对某个业务单据的一系列操作看作是一个用例进行测试。

    进入项目管理者创建好的项目中，选择测试用例菜单，创建用例并添加接口。再结合智能生成功能快速生成其他接口，即可快速完成用例编写。最后启动用例测试并查看测试结果。

1. 创建用例-从业务领域选择单据

    创建一个用例有多种方法，最常用的是从业务领域选择单据。

    可以点击用例树上方的新增按钮进入添加用例向导。

    点击“从业务领域选择单据”功能可以将需要测试的业务对象快速添加到项目中。

    根据筛选条件过滤需要的用例，快速勾选您所需要添加的业务领域/子系统/业务对象，点击“→”按钮，添加至右侧树，（可以勾选右侧树中的业务对象后点击“←”删除），再点击右下角的“确定”按钮，即可将勾选的内容添加到项目中，形成项目的用例树。

（系统支持重复添加相同的业务领域/子系统/业务对象，但每次添加用例时同一个业务对象只能选择一次）

2. 创建用例-从接口在线测试历史导入

    另一个创建用例的方法：从接口在线测试历史导入，需要先进入顶部菜单中的“API文档”页面后，点击“API在线测试”跳转在线测试页面，点击“启动测试”后就会生成一个测试历史记录。

    添加用例时选择“从接口在线测试历史导入”，找到需要导入的保存接口记录对应行（注：目前只允许保存接口的数据加入项目），点击“加入项目”即可。

3. 同步元数据

    创建用例完成后会自动跳转至用例树界面，如果当前默认加载的用例对应的业务对象没有同步过元数据，系统将会立即自动同步。若因某些原因同步失败后，用户可以在用例信息中点击“重新同步元数据”手动再次同步。

    只要是定制化项目，无论是否为定制化/扩展菜单中的业务对象，都需要同步元数据，元数据同步成功与否关系到用例接口后续的编辑操作。

4. 编辑用例

    点击用例上方的“编辑用例”按钮，可以编辑测试用例名称等字段。修改后点击“提交”即可。

    测试用例名称：默认为“业务对象名称_添加次数”，用户可以自定义

    编码字段：自动化参数，即单据的唯一编码字段，单据时默认为FBillNo，其他默认为FNumber。

    集成用户：自动化参数，测试执行时该用例使用的集成用户，为空时使用环境配置中的集成用户。

    替换编码值：自动化参数，默认勾选。

    即每次执行保存接口时系统会自动生成一个编码，后续查询删除等接口的请求参数的Number/Numbers的值会自动替换为该编码。

    替换组织ID：自动化参数，默认不勾选。

    即每次执行时会替换请求参数中的CreateOrgId/FCreateOrgId的值为环境配置信息中的组织ID的值。

    替换单据ID：自动化参数，默认不勾选。

    即执行保存/暂存/查看接口后获得返回的单据ID，替换后续接口的请求参数中的Id/Ids的值。

    用例说明：默认为空，用户可以修改。

5. 删除用例

    接口列表为空的用例被称为“无效用例”，反之称为“有效用例”。

（在用例树中，有效用例为蓝色，无效用例为灰色。）

    无效用例支持批量删除，勾选用例树中的无效用例后，点击用例树上方的删除按钮，在弹出窗口中点击“确认”即可。

    有效用例的删除，需要选择用例树中的某个用例，点击上方的“删除用例”按钮，在弹出窗口中点击“确认”即可。

    注意：被删除的用例无法恢复！请谨慎操作！

6. 用例排序

    用例树的排序即项目执行用例的排序。

    当用例树中拥有一个以上的用例时，可以点击某个用例按住拖动，拖到用例树中希望调整的地方放开即可。

只允许在同一个父级下的对象间拖动排序。