E9表单建模:修改单字段值与基础操作接口实战

需积分: 44 7 下载量 88 浏览量 更新于2024-08-06 收藏 1.2MB PDF 举报
在Cisco中型项目实战中,关于泛微OA E9 API的OA开发接口章节,主要聚焦于E9表单建模的前端操作。这个部分的核心知识点包括: 1. 修改单个字段值:`changeFieldValue`函数是一个关键接口,用于修改表单中的特定字段值。这个方法接受两个参数:`fieldMark`(表示字段的标识符,格式为`field${字段ID}_${明细行号}`)和`valueInfo`(一个JSON对象,包含修改后的值及其详细信息)。如果字段涉及联动逻辑,修改后会自动触发相应的联动效果。例如,可以使用以下代码片段来修改字段值: ```javascript ModeForm.changeFieldValue("field11_2", { value: "2,3", specialobj: [ { id: "2", name: "张三" }, { id: "3", name: "李四" } ] }); ``` 对于文本框类型的字段,还可以设置`showhtml`属性来控制显示值,如: ```javascript ModeForm.changeFieldValue("field123", { value: "0.23", showhtml: "23%" }); ``` 2. 基础操作接口: - `convertFieldNameToId`函数:用于将字段名称转换为对应的ID,支持多表单和多环境,提高代码的通用性和解耦。通过提供字段名称、表单标识(如主表或明细表)以及是否添加前缀,可以动态获取字段ID。例如: ```javascript var fieldid = ModeForm.convertFieldNameToId("zs"); var fieldid = ModeForm.convertFieldNameToId("zs_mx", "detail_1"); var fieldid = ModeForm.convertFieldNameToId("zs_mx", "detail_1", false); ``` - `getFieldValue`函数:用于获取单个字段的当前值,输入字段标识,返回字段的值。 这些API接口的设计原则强调了E9表单操作的高效性和规范性,避免了直接操作DOM的复杂性和不稳定性,推荐开发者在进行表单数据交互时使用这些封装好的函数。通过理解和熟练运用这些功能,可以更好地管理和更新泛微OA E9中的表单数据。