E9表单建模API:添加明细与初始值设置详解

需积分: 44 7 下载量 97 浏览量 更新于2024-08-06 收藏 1.2MB PDF 举报
在"Cisco 中型项目实战"中,章节"添加明细及设置初始值"详细介绍了如何在泛微OA E9系统中使用E9表单建模前端接口API进行操作。该部分的核心内容围绕以下几个方面: 1. 添加明细行与设置初始值: - 函数`addDetailRow`用于动态添加表单的明细行,如`ModeForm.addDetailRow("detail_2", {field111: {value: "初始值"}})`。如果初始值是浏览框类型,需提供符合格式的值数组,如`{field110: {value: [{'id': 'id1', 'name': '11'}]}}`。 2. 字段操作接口: - `convertFieldNameToId`函数是一个重要的工具,用于将字段名称转换为对应的ID,支持多表单和不同环境的代码复用。例如,`var fieldid = ModeForm.convertFieldNameToId("zs")`或`var fieldid = ModeForm.convertFieldNameToId("zs_mx", "detail_1", false)`。 - `getFieldValue`函数用于获取单个字段的值,传入字段标识如`field110`,返回字段的当前值。 - `changeFieldValue`用于修改单个字段的值,它会自动触发联动效果。对于非浏览按钮字段,传递`{value: "修改的值"}`,而对于浏览按钮,提供数组格式的特殊对象,并在特定条件下使用`showhtml`属性。 3. 限制与建议: - E9系统采用单页模式,鼓励开发者通过API接口操作,而非jQuery或原生JS直接操作DOM,以提高代码的灵活性和耦合度。 - 所有这些接口都封装在全局对象`window.ModeForm`中,便于在整个项目中统一管理和调用。 这个章节提供了在泛微OA E9项目中如何利用API进行表单构建和管理的重要技术细节,包括添加表单明细、处理字段标识和值的操作,以及遵循的最佳实践。熟练掌握这些API有助于提升在实际项目中的开发效率和代码质量。