E9表单建模:扩展浏览按钮与显示值接口

需积分: 44 7 下载量 168 浏览量 更新于2024-08-06 收藏 1.2MB PDF 举报
"本文档主要介绍了在Cisco中型项目实战中如何获取和扩展浏览按钮的功能,以及E9表单建模前端接口API的使用。文档涵盖了设置浏览按钮的数据范围限制、添加URL参数以及获取显示值的方法,并提供了相关接口的详细说明和使用示例。此外,还强调了E9系统采用单页模式,推荐使用API接口而非jQuery或原生JS操作DOM。" 在【标题】中提到的"获取浏览按钮的显示值"和"扩展浏览按钮取数接口参数值"是两个关键知识点: 1. **扩展浏览按钮取数接口参数值**: 这个功能允许开发者控制浏览按钮的可选数据范围,可以进行范围限制,也可以根据表单字段的值来过滤数据。实现这一功能的关键在于接口的扩充,通过`appendBrowserDataUrlParam`函数,将额外的URL参数传递给服务器接口。例如,要给浏览按钮395增加一个名为`customerid`的URL参数,值为`2`,可以这样调用: ```javascript ModeForm.appendBrowserDataUrlParam("field395", {"customerid": "2"}); ``` 这里的`fieldMark`是字段标识,`jsonParam`是扩展的URL参数,以JSON键值对形式存在。 2. **获取浏览按钮的显示值**: `getBrowserShowName`函数用于获取浏览按钮的显示名称,如果有多条记录,它们将以指定的`splitChar`字符分隔。例如,要获取字段标识为`field110`的浏览按钮的显示名称,可以使用: ```javascript var showNames = ModeForm.getBrowserShowName("field110", ", "); ``` 这将返回一个由逗号分隔的字符串,包含所有显示名称。 【标签】"泛微OA E9API OA开发接口"表明这些操作适用于泛微OA系统的E9版本,其中API接口是进行OA开发的重要工具。 在【部分内容】中,还提到了E9表单建模前端接口API的一些基础操作接口: 1. **将字段名称转换成字段id**: 使用`convertFieldNameToId`函数可以将字段名称转换为字段ID,支持主表和明细表的区分。例如,将字段名称`zs`转换为ID: ```javascript var fieldId = ModeForm.convertFieldNameToId("zs"); ``` 可以通过传递不同的`symbol`和`prefix`参数来适应不同场景。 2. **获取单个字段值**: `getFieldValue`函数用于获取字段的当前值,例如获取字段标识为`field110`的值: ```javascript var fieldValue = ModeForm.getFieldValue("field110"); ``` 3. **修改单个字段值**: `changeFieldValue`函数用于修改字段值,并会自动触发相关的联动效果。例如,修改字段标识为`field110`的值: ```javascript ModeForm.changeFieldValue("field110", {value: "新值"}); ``` 这些接口的使用,可以帮助开发者更高效地构建和交互E9表单,实现复杂的业务逻辑和用户界面控制。在实际开发中,应遵循文档提供的示例和说明,确保代码的正确性和兼容性。