易企办开发者 / 自定义代码
易企办自定义代码
为易企办的表单和应用页面补充可复用的业务界面，按场景选择控件、自定义动作或服务端集成。
自定义代码适合放在哪里
| 使用位置 | 业务用途 | 需要核对 |
|---|---|---|
审批表单 | 审批摘要、预算对照和补充录入 | 发起、任务和只读页面的字段与编辑权限 |
数据列表表单 | 记录编辑、查找选择和关联记录展示 | 记录权限、字段格式和保存行为 |
自定义页面 | 指标卡、筛选器和业务工作台 | 数据来源、查询范围和页面变量 |
表单或页面动作 | 页面加载、按钮点击后的脚本处理 | 动作触发条件、执行结果和异常分支 |
读取配置与运行上下文
用 inputParameters 定义设计者可配置的参数，用 requiredFields 声明当前表单字段。运行时根据宿主传入的字段、只读状态和 SDK 展示对应内容。
宿主接口随产品版本和使用位置变化。当前列表表单、自定义页面和审批表单需要分别检查可用方法。
选择控件或动作
| 类型 | 入口 | 适用情形 |
|---|---|---|
自定义代码控件 | render(context, fieldsValues, readonly) | 需要持续显示信息、接受交互或随字段变化重新渲染 |
自定义代码动作 | execute(context, fieldsValues) | 用户点击或页面事件触发一次脚本，完成后交回动作链 |
把常用设计做成可复用组件
让字段映射、标题和显示条件可配置。在不同表单与角色中验证加载、只读、错误和空数据状态。
每个可交付模板应包含完整代码、参数说明、示例配置、输出格式和验收步骤。跨应用、需要长期运行或处理密钥的操作，按系统设计放在可信服务端。