自定义代码控件可在表单或页面上显示由代码生成的界面。例如,在采购申请的子列表中显示自动行号,或在自定义页面中显示根据数据列表生成的指标卡片。
添加控件
打开审批表单、数据列表表单或自定义页面设计器。
展开控件面板的「高级」分组,把「自定义代码」拖到画布上的区域或容器。
选中控件并打开内容设置。粘贴已有的控件脚本,或按照开发者快速入门编写并构建脚本后再粘贴。
配置输入并预览
如果代码声明了输入参数,在控件的「输入参数」中将它们与实际字段或值对应。子列表自动编号示例使用两个参数。
listId对应子列表控件的字段 ID。snField对应子列表中用于显示行号的字段 ID。
在设计器中选择「预览」,向测试子列表添加两行,检查行号是否连续。用有数据和无数据的记录分别检查控件,再在只读视图中确认显示。如果控件修改了表单数据,从表单正常保存,再重新打开记录核对。控件与动作开发文档
使用 AI 代码编辑器辅助编写
控件提供 AI 代码编辑器时,可以描述界面用途、输入字段和需要完成的操作。生成代码后先预览并调整,再回到目标表单或页面,用实际字段和使用角色验证结果。AI 代码编辑器说明
在按钮点击时执行脚本
在表单或页面中持续展示和交互时,使用自定义代码控件。需要在按钮点击后执行一次计算或数据处理时,在按钮调用的表单动作中添加「执行自定义代码」步骤。
下图以采购申请的自动行号为例,展示输入字段和预览结果的关系。
