E9表单建模前端API:自定义函数与事件绑定实战

需积分: 44 7 下载量 62 浏览量 更新于2024-08-06 收藏 1.2MB PDF 举报
本资源主要介绍了在Cisco中型项目实战中如何利用E9API进行OA开发,特别是关于表单建模前端接口的应用。其中,重点讲解了两个关键功能:提交事件执行自定义函数和字段值变化触发事件。同时,提到了E9API的使用规范和一些常用的基础操作接口。 在7.1章节,提交事件执行自定义函数的目的是在表单提交时进行额外的验证或处理。开发者可以定义一个函数,如`checkCustomize`,该函数需返回一个布尔值,`true`表示允许表单继续提交,`false`则阻止提交。示例中展示了两种定义函数的方式:作为window对象的属性和传统的函数声明。无论哪种方式,都需要确保函数内部逻辑能正确判断是否允许表单流转。 7.2章节涉及的是字段值变化触发事件`bindPropertyChange`,这个事件在字段值改变时被调用。它依赖于DOM,并且传入三个参数:触发事件的字段DOM对象、字段标识(如'field27563')以及修改后的值。开发者可以通过监听这个事件来实现对字段变化的响应,例如日志记录或实时校验。 资源中提到的E9表单建模前端接口API被封装在全局对象`window.ModeForm`下,E9系统采用单页模式,推荐使用API接口而非jQuery或原生JS操作DOM。接口提供了将字段名称转换为字段ID的函数`convertFieldNameToId`,用于字段值获取的`getFieldValue`,以及用于修改字段值并自动触发联动的`changeFieldValue`。这些接口简化了表单交互的开发工作,提高了代码的复用性和可维护性。 例如,`convertFieldNameToId`函数接收字段名称、表单标识(默认为主表`main`)和是否需要前缀(默认为`true`),返回对应的字段ID。`getFieldValue`通过字段标示(如'field110')获取字段当前的值,而`changeFieldValue`不仅用于设置字段的新值,还能够处理联动效果,其参数包括字段标示和包含新值的对象,对于特殊场景如只读文本字段的展示方式也提供了控制选项。 总结起来,本资源详细介绍了Cisco中型项目实战中使用E9API进行OA开发的关键技术,包括自定义提交事件和字段值变化事件的处理,以及E9API提供的基础操作接口,为开发者提供了实用的指导。