批量修改E9表单字段值与显示属性:Cisco实战API

需积分: 44 7 下载量 191 浏览量 更新于2024-08-06 收藏 1.2MB PDF 举报
在Cisco中型项目实战中,批量修改字段值或显示属性是一个关键功能,用于管理和调整表单数据。两个主要的方法是`changeSingleField`和`changeMoreField`,它们分别针对单个字段和多个字段的操作。 1. `changeSingleField`函数: - 这个函数接受三个参数:`fieldMark`(字符串,表示字段标识,格式为`field${字段ID}_${明细行号}`)、`valueInfo`(JSON,包含要修改的值,如`{value: "修改的值"}`)以及`variableInfo`(JSON,可选,用于变更属性,例如设置为只读,即`{viewAttr: 3}`)。 - 通过这个函数,可以同时修改字段值并设定其显示属性,比如设置某字段为只读模式。 - 示例展示了如何调用此函数来修改特定字段并改变其视图属性。 2. `changeMoreField`函数: - 与`changeSingleField`不同,`changeMoreField`处理批量修改操作,它接收一个`changeDatas`数组(包含多个`changeData`对象,每个对象包含`fieldMark`和`valueInfo`),以及`changeVariable`(同样可能是JSON,用于批量变更属性)。 - 这个函数适用于需要一次更改多个字段的情况,提升了效率,并且能够保持一致性,避免逐个单独操作。 E9表单建模前端接口API提供了这些核心功能,以适应E9系统的单页模式。推荐使用API接口进行操作,而不是jQuery或原生JS直接操作DOM,以确保代码的灵活性、可维护性和兼容性。API封装在全局对象`window.ModeForm`中,包括: - `convertFieldNameToId`函数:用于将字段名称转换为ID,支持多表单和多环境的通用性,允许指定表单标识符和是否添加前缀。 - `getFieldValue`函数:获取单个字段的当前值,输入字段标识即可。 - `changeFieldValue`函数:修改单个字段值,可能触发联动机制。 通过这些API,开发者可以在构建E9系统时高效地控制表单数据的展示和编辑,增强了业务流程的灵活性和定制化。在实际项目中,了解和熟练运用这些接口至关重要,尤其是在处理复杂的数据更新和显示逻辑时。