泛微OA前端开发接口方法和自定义方方法总结注释

泛微OA前端开发接口方法和自定义方方法总结注释 适用于刚接触泛微OA前端开发的小白和不了解泛微OA开发的老手 有什么问题可以私信问我 前端代码开发方式 方式1：模板上代码块，针对单个节点，在显示/打印/移动模板单独配置 方式2：【路径管理】-打开具体路径-【基础设置】-【自定义页面】，针对此路径下所有节点所有模板生效 方式3：【路径管理】-【应用设置】-【流程表单自定义页面设置】，针对系统所有非模板模式的场景(PC及移动)。注意此页面为全局custompage，应避免写ready、checkCustomize等全局函数，只定义些函数体 特别注意：方式二、方式三禁止引入init_wev8.js。 如遇配置不生效，请先将代码块/custompage仅写alert确认是否生效，再逐步排查错误原因 表单字段相关操作，不推荐使用jQuery，禁止原生JS直接操作DOM结构！ 泛微OA是一款企业级的办公自动化系统，其前端开发涉及到一系列接口方法和自定义方法，以实现对工作流、表单、页面等的定制。以下是对这些方法的详细解释： 1. **模板上代码块**：这是最基础的前端开发方式，针对单个节点，在显示、打印或移动模板中单独配置代码，适用于特定场景的个性化定制。 2. **自定义页面**：在【路径管理】-【基础设置】-【自定义页面】中配置，这种方式会影响到路径下所有节点的所有模板，适合全局性的功能调整。 3. **流程表单自定义页面设置**：通过【路径管理】-【应用设置】-【流程表单自定义页面设置】，这会影响系统所有非模板模式的场景，包括PC和移动端。但需要注意，这里的custompage是全局的，不应编写全局函数，如ready和checkCustomize，只定义函数体即可。 **注意事项**： - 方式二和方式三禁止引入`init_wev8.js`，因为这可能导致配置不生效。 - 遇到问题时，首先确认代码块/custompage是否生效，通过简单的`alert`测试，然后逐步排查错误。 - 不推荐使用jQuery操作表单字段，同时禁止直接使用原生JS操作DOM结构，以保证系统的稳定性和兼容性。 **接口方法和自定义方法**： - `WfForm.getBrowserShowName(fieldId)`：返回指定字段在浏览器中的显示值。 - `WfForm.bindFieldChangeEvent(fieldId, callback)`：绑定字段变化事件，常用于下拉框，获取字段值的变化。 - `WfForm.getFieldValue(fieldId)`：获取单个字段的值。 - `WfForm.getSelectShowName(fieldId)`：获取选择框字段的显示值。 - `WfForm.getBrowserShowName(fieldId)`：获取非日期时间类型浏览按钮的显示值。 - `WfForm.changeFieldValue(fieldId, options)`：改变字段的显示值。 - `WfForm.changeFieldAttr(fieldId, attr)`：改变字段属性，参数1表示属性类型，如1表示只读，2表示编辑，3表示必填，4表示隐藏。 **事件绑定**： - 使用`jQuery.bindPropertyChange()`可绑定字段属性改变事件，例如检查复选框状态来改变其他字段的属性。 **注册自定义事件**： - `WfForm.OPER_xxx`系列常量用于注册拦截事件，例如`OPER_SAVE`表示保存操作，`OPER_SUBMIT`表示提交操作等。注册的事件可在指定动作执行前触发，可以决定是否阻断或放行后续操作，支持异步处理，防止请求阻塞。 这些方法和注意事项为泛微OA的前端开发者提供了基础的工具和指导，通过灵活运用，可以构建出符合企业需求的定制化OA系统。在实际开发过程中，应遵循最佳实践，确保代码的可维护性和系统的稳定性。