SmartFormController

类名：SmartFormController
说明：表单的控制器，用于控制表单的提交和展示，继承H3.SmartForm.SmartController类。

核心属性（保护访问）

属性名称	类型	描述
Request	SmartFormRequest	表单请求上下文，提供请求参数、用户信息、业务对象 schema 等核心数据访问入口。
ClientActivity	ClientActivity	当前流程活动（仅流程表单有效），用于获取流程节点权限（如字段可见性、可编辑性）。
IEngine	H3.IEngine	当前请求上下文关联的引擎实例，包含系统核心服务的访问入口。

核心常量（公共）

常量名称	类型	适用场景
Button_Edit	string	表单编辑操作标识。
Button_Submit	string	表单提交操作标识（普通表单 / 流程表单发起）。
Button_SubmitAndAdd	string	PC 端专属，提交后保留表单页面用于新增下一条数据。
Button_Read	string	流程抄送节点标记已读操作标识。
Button_Reject	string	流程审批节点驳回操作标识。
Button_Save	string	表单暂存操作标识（状态设为 "草稿"）。
Button_Remove	string	表单数据删除操作标识（含业务对象与关联流程）。
Button_Close	string	关闭表单页面操作标识。
Button_Print	string	表单打印操作标识。
Button_ViewInstance	string	查看流程实例状态操作标识。
Button_FinishInstance	string	强制结束流程实例操作标识。
Button_CancelInstance	string	作废流程实例操作标识。
Button_RetrieveInstance	string	流程节点取回操作标识（发起人 / 审批人撤回已提交任务）。
Button_Forward	string	流程任务转发给其他用户操作标识。
RejectTo_Start	string	驳回到流程发起节点的目标标识。
RejectTo_Previous	string	驳回到流程前一步节点的目标标识。
Param_PostValue	string	页面传递给后端的提交数据参数键。
Action_LoadSNSPost	string	加载表单社交评论（如审批意见）的动作标识。
Action_OnWorkflowInstanceStateChanged	string	流程状态变更事件标识（如流程从 "运行" 变为 "已结束"）。
DefaultApproveText	string	流程审批默认同意意见。
DefaultDisapproveText	string	流程审批默认不同意意见。

构造函数

功能

初始化表单控制器实例，接收请求上下文，为后续表单操作提供基础环境（如请求数据加载、核心服务关联）。

接口定义

public SmartFormController(SmartFormRequest request);

参数说明

参数名称	是否必填	类型	描述
request	是	SmartFormRequest	表单请求上下文，包含表单配置、用户信息、业务对象结构、筛选条件等核心数据。

OnLoad 方法（虚方法，子类可扩展）

功能

表单加载的扩展入口，允许子类自定义表单加载逻辑（如补充字段数据、调整字段权限）。

接口定义

protected virtual void OnLoad(LoadSmartFormResponse response);

参数说明

参数名称	类型	描述
response	LoadSmartFormResponse	表单加载响应对象，可修改数据、配置、错误信息等。

OnSubmit 方法（虚方法，子类可扩展）

功能

表单提交的扩展入口，允许子类自定义提交逻辑（如数据校验、额外业务处理）。

接口定义

protected virtual void OnSubmit(string actionName, 
                                H3.SmartForm.SmartFormPostValue postValue, 
                                H3.SmartForm.SubmitSmartFormResponse response);

参数说明

参数名称	类型	描述
actionName	string	提交动作标识（如 Button_Save、Button_Reject）。
postValue	SmartFormPostValue	提交数据（表单字段值、审批意见等）。
response	SubmitSmartFormResponse	提交响应对象，存储操作结果（成功 / 错误信息、刷新标识）。

OnWorkflowInstanceStateChanged 方法（虚方法）

功能

流程状态变更时的扩展入口（如流程从 "运行" 变为 "已结束"），允许子类自定义状态变更逻辑。

接口定义

protected virtual void OnWorkflowInstanceStateChanged(H3.Workflow.Instance.WorkflowInstanceState oldState,
                                                      H3.Workflow.Instance.WorkflowInstanceState newState);

参数说明

参数名称	类型	描述
oldState	WorkflowInstanceState	流程变更前状态（如 Running 运行中）。
newState	WorkflowInstanceState	流程变更后状态（如 Finished 已结束）。