_formsubmitlib
功能说明
描述
『表单提交插件事件』入口函数，启用后在“表单提交”时触发。
- 通过此事件，可以即时反馈相关信息给提交者，便于交互。
- 此事件触发有3个必要的条件：
①、表单类型没有限制”。
②、表单属性里“表单提交数据”选择为“功能插件”。
③、表单其他属性里“允许提交数据”选择为“是”（默认：是）
| 表单属性 - 启用表单提交后端事件 | 确保：允许提交数据“开启” |
|---|---|
 |
 |
- 事件触发流程：
触发事件后，前端页面会将"当前表单别名"，"表单数据信息"，"数据提交类型" 传给后端对应的云应用中的"_formsubmitlib"函数，然后执行"后端代码"并返回"返回结果"和"需要界面展示的数据"。
- 前置/后置触发：
当表单提交数据时，在提交数据前或在提交数据后触发"_formsubmitlib"事件。默认为"前置触发"，详情请见后面的事件触发示意图 。
如果选择【前置触发】：表示前置提交，先执行后端代码，再提交数据，如果返回值的第一个参数为：False，则不会提交数据。
如果选择【后置触发】：表示后置提交，先提交数据，再执行后端代码，返回True或False对数据没有影响，只是给前端的提示。
函数原型
def _formsubmitlib(config,formAlias,arg,action,other):参数
| 名称 | 类型 | 描述 |
|---|---|---|
| config | 数组型 | 插件当前配置中的字段信息 |
| formAlias | 字符型 | 表单的别名 |
| arg | 数组：字典型 | 表单提交操作时传入的当前表单数据信息 |
| action | 整型 | 当前的操作动作：提交/提交并打印时为1 |
| other | 数组：字典型 | 附加信息，暂时只有前面插件的所有结果集信息（多插件配置时），没有的话为空数组 |
参数详解
config的数据格式：
- 请查阅各类插件控件的参数说明。
arg的数据格式为：
{
"formName":"流程事件表单",
"子表单":{
"data":[
{
"多行文本2":{
"data":"22",
"widgetType":"textarea",
"visible":True
},
"单行文本2":{
"data":"11",
"widgetType":"text",
"visible":True
}
}
],
"widgetType":"subform",
"visible":True
},
"dataId":"5a29b3c98303d4efbe0d4bf8",
"clientIp":"175.8.178.125",
"多行文本":{
"widgetType":"textarea",
"visible":True,
"data":"1234"
},
"flow":{
"flowIdAlias":"节点1",
"candidateId":"547a48c50eccde5ac8c0883b",
"flowId":1,
"flowVer":"1",
"backNode":0,
"backNodeChargers":[
"547a48c50eccde5ac8c0883b"
],
"operator":"547a48c50eccde5ac8c0883b"
},
"单行文本":{
"widgetType":"text",
"visible":True,
"data":"1234"
},
"operator":"547a48c50eccde5ac8c0883b"
}| 名称 | 描述 | 表单类型 |
|---|---|---|
| formName | 表单标题 | 事件表单，流程事件表单 |
| operator | 操作人id | 事件表单，流程事件表单 |
| clientIp | 客户端ip | 事件表单，流程事件表单 |
| dataId | 数据id | 事件表单，流程事件表单 |
| 单行文本，多行文本，子表单等字段 | 字段别名和对应的值 目前只支持3种属性（visible：是否可见，data：字段的数据，widgetType：字段类型） | 事件表单，流程事件表单 |
| flow | 只有流程表单才会有此参数 包含多个属性：flowVer：流程版本（通用） flowIdAlias：当前触发的流程节点（通用） operator：当前节点的操作人的userid（通用）candidateId：转交人的userid（仅流程转交时才有） backNode：回退节点id（仅流程回退时才有）backNodeChargers：回退节点负责人的userid（仅流程回退时才有）flowId：节点id | 流程事件表单 |
other的数据格式：
{
"libResult":[
{
"result":True,
"text":"插件1的数据",
"name":"测试插件",
"datas":{
"单行文本":{
"data":"单行文本的数据"
},
"多行文本":{
"data":"多行文本的数据"
}
}
},
{
"result":True,
"text":"插件2的数据",
"name":"测试插件",
"datas":{
"单行文本":{
"data":"单行文本的数据"
},
"多行文本":{
"data":"多行文本的数据"
}
}
}
]
}| 名称 | 描述 |
|---|---|
| libResult | 前面插件的结果集信息，有几个插件就有几个子数组 |
| result | 插件的逻辑型返回值 |
| datas | 插件的数组型返回值 |
| text | 插件的文本型返回值 |
| name | 插件的名称 |
返回值
返回值接受多个返回值。
| 名称 | 类型 | 描述 |
|---|---|---|
| 第1个返回值 | Boolean（逻辑型） | 返回结果为True（真）或False（假） |
| 第2个返回值（可选） | 文本字符串（字符型） | 返回文本内容给页面弹出提示 |
| 第3个返回值（可选） | json字符串（字符型） | 返回结果可修改前端表单字段赋值与属性 |
| 类型 | 返回值1 | 返回值2 | 返回值3 |
|---|---|---|---|
| 前置返回 | True：通过提交操作 | 前端展示文本信息，为空提示“提交成功” | 参数无效 |
| 后置返回 | True：通过提交操作 | 前端展示文本信息，为空提示“提交成功” | 参数无效 |
| 前置返回 | False：拦截提交操作 | 前端展示文本信息，为空提示“提交成功” | 根据json字符串，修改前端表单字段赋值与属性 |
| 后置返回 | False：通过提交操作 | 前端展示文本信息，为空提示“提交成功” | 参数无效 |
| 没有返回 | 默认True：通过提交操作 | 默认为空，前端展示“提交成功” | 参数无效 |
| 前置触发示意图： |
|---|
 |
| 后置触发示意图： |
|---|
 |
备注
- arg的数值是数组类型，因此大家可以通过数组的形式操作它。
- formsubmitlib事件可以解决很多我们前端字段做不到的事情，例如： 批量录入数据，并自动计算相关内容； 新增/修改/删除数据后自动更新本表或其他表单数据； 以特殊格式或需求对提交的数据做特殊校验，如：会员卡、工作证校验等。
演示示例
- 暂无
安装包下载
- 暂无
相关视频
- 暂无