E9表单建模前端接口API:获取明细选中行操作

需积分: 44 7 下载量 198 浏览量 更新于2024-08-06 收藏 1.2MB PDF 举报
"本文主要介绍了在Cisco中型项目实战中,如何使用E9API和OA开发接口进行表单操作,特别是获取选中行的主键ID和下标。该功能适用于泛微OA系统,所有接口均封装在全局对象window.ModeForm中。" 在E9表单建模的前端接口API中,提供了多个方便开发者的接口,这些接口主要用于表单的交互和数据操作。在3.11部分,我们学习了如何获取明细选中行的主键ID。这个功能需要的最低版本是KB900190800。`getDetailCheckedRowKey`函数接受一个参数`detailMark`,它是一个字符串,用于标识明细表。例如,如果明细表的标识是`detail_1`,调用`ModeForm.getDetailCheckedRowKey("detail_1")`将会返回选中行的主键ID,如`101`、`102`等。 紧接着,在3.12部分,介绍了获取明细选中行的下标。同样,这个功能也需要最低版本KB900190800。虽然函数`getDetailCheckedRowIndexStr`的详细用法没有给出,但可以推测它应该返回选中行的索引字符串,这在处理多行数据时非常有用。 E9API的设计强调了单页模式,并推荐开发者使用API接口而非jQuery或原生JS操作DOM。为了进一步提高代码的可复用性和解耦,E9提供了一些基础操作接口。 2.1 `convertFieldNameToId`函数是一个关键接口,它能将字段名称转换为字段ID。这对于处理动态表单和不同环境下的代码通用性至关重要。函数接收三个参数:字段名称(必需)、表单标示(非必需,默认为主表`main`)和是否需要field字符串前缀(非必需,默认为true)。通过这个函数,开发者可以轻松地根据字段名称获取其ID,例如`ModeForm.convertFieldNameToId("zs")`。 2.2 `getFieldValue`接口用于获取单个字段的值,需要传入字段标示,形如`field${字段ID}_${明细行号}`。例如,要获取ID为110的字段值,可以调用`ModeForm.getFieldValue("field110")`。 2.3 `changeFieldValue`接口允许修改单个字段的值,并且在修改后会自动触发关联的联动效果。它需要两个参数:字段标示和值信息。值信息是一个JSON对象,包含待修改的值,以及可能的特殊对象(如浏览按钮信息)和特定属性(如文本字段的`showhtml`)。例如,要改变ID为110的字段值,可以写成`ModeForm.changeFieldValue("field110", {value: "新的值"})`。 以上所述的接口都是E9API的一部分,它们为开发者提供了高效、灵活的方式来处理表单数据,无论是获取选中行的信息还是进行数据的修改,都极大地提升了开发效率和代码的可维护性。在实际的Cisco中型项目中,熟练掌握这些接口的使用,能够帮助开发者更好地实现OA系统的功能扩展和定制化需求。