E9表单建模API:字段操作与表单控制

需积分: 44 7 下载量 67 浏览量 更新于2024-08-06 收藏 1.2MB PDF 举报
"本文档介绍了在泛微OA E9API中进行OA开发接口的使用,特别是关于表单顶部按钮和右键菜单置灰的操作,以及一些常用的表单字段操作接口。" 在【标题】提到的"表单顶部按钮右键菜单置灰-cisco 中型项目实战"中,主要涉及到了在E9表单开发中如何控制表单的交互状态。通过`ModeForm.controlBtnDisabled`函数可以实现表单顶部按钮和右键菜单的置灰与恢复操作。当`isDisabled`参数为`true`时,所有按钮将被置灰并不可操作,而当`isDisabled`参数为`false`时,按钮将恢复可操作状态。这个功能在提交表单或执行某些需要禁用用户交互的操作时特别有用,以防止用户在处理过程中做出额外的改变。 【描述】中还提到了一个名为`getSelectShowName`的函数,用于获取选择框字段的显示值。这个函数适用于选择框类型(包括单选和复选)的字段,它会根据`fieldMark`参数指定的字段标识获取显示名称。如果选择了多个选项,它们会使用`splitChar`参数指定的分隔符连接成一个字符串。如果没有提供`splitChar`,默认使用逗号作为分隔符。例如,`ModeForm.getSelectShowName("field10_0")`将获取字段`field10_0`的显示值。 【标签】"泛微OA E9API OA开发接口"表明这些功能是泛微协同办公系统E9版本中的API接口,主要用于OA系统的开发工作。 【部分内容】中详细列举了一些E9表单建模前端接口API。这些接口统一封装在全局对象`window.ModeForm`下,旨在提供对表单的各种操作,如字段ID转换、获取和修改字段值等。其中: - `convertFieldNameToId`函数用于将字段名称转换为字段ID,支持多表单和多环境下的代码通用。它可以接受字段名称、表单标示(默认为主表`main`)和是否需要前缀`field`作为参数。 - `getFieldValue`函数用于获取指定字段的值,需要提供字段标示,格式为`field${字段ID}_${明细行号}`。 - `changeFieldValue`函数则用于修改字段的值,它会自动触发相关的联动逻辑。输入的参数包括字段标示和一个包含新值信息的对象,对于非浏览按钮字段,只需提供`value`属性;对于浏览按钮或只读文本字段,可能还需要提供其他属性,如`showhtml`。 这些接口的使用可以帮助开发者更便捷地操作E9表单,实现动态表单和复杂的业务逻辑。在实际开发中,根据需求合理运用这些API,能够提高代码的效率和灵活性。