跳转到主要内容

配置自定义代码控件

在易企办表单或页面中添加自定义代码控件,绑定输入参数,并预览字段和运行结果。

自定义代码控件可在表单或页面上显示由代码生成的界面。例如,在采购申请的子列表中显示自动行号,或在自定义页面中显示根据数据列表生成的指标卡片。

添加控件

  1. 打开审批表单、数据列表表单或自定义页面设计器。

  2. 展开控件面板的「高级」分组,把「自定义代码」拖到画布上的区域或容器。

  3. 选中控件并打开内容设置。粘贴已有的控件脚本,或按照开发者快速入门编写并构建脚本后再粘贴。

配置输入并预览

如果代码声明了输入参数,在控件的「输入参数」中将它们与实际字段或值对应。子列表自动编号示例使用两个参数。

  • listId 对应子列表控件的字段 ID。

  • snField 对应子列表中用于显示行号的字段 ID。

在设计器中选择「预览」,向测试子列表添加两行,检查行号是否连续。用有数据和无数据的记录分别检查控件,再在只读视图中确认显示。如果控件修改了表单数据,从表单正常保存,再重新打开记录核对。控件与动作开发文档

使用 AI 代码编辑器辅助编写

控件提供 AI 代码编辑器时,可以描述界面用途、输入字段和需要完成的操作。生成代码后先预览并调整,再回到目标表单或页面,用实际字段和使用角色验证结果。AI 代码编辑器说明

在按钮点击时执行脚本

在表单或页面中持续展示和交互时,使用自定义代码控件。需要在按钮点击后执行一次计算或数据处理时,在按钮调用的表单动作中添加「执行自定义代码」步骤。

下图以采购申请的自动行号为例,展示输入字段和预览结果的关系。

易企办自定义代码输入示意。采购申请明细的子列表控件和行号字段分别映射到 listId 和 snField,新增两行后检查编号是否连续。

这是否解答了您的问题?