_formdeletelib
功能说明
描述
『表单删除插件事件』入口函数,启用后通过“数据管理”或“分析报表 - 数据表”,对单条数据进行删除输出确定后触发。(全部删除时不触发)
- 通过此事件,可以即时反馈相关信息给提交者,便于交互。
- 此事件触发有2个必要的条件:
①、表单类型没有限制。
②、表单属性里“表单删除数据”选择为“功能插件”。
表单属性 - 启用表单删除后端事件 |
---|
- 事件触发流程:
触发事件后,前端页面会将"当前表单别名","表单数据信息","数据提交类型"传给后端对应的云应用中的"_formdelete"函数,然后执行"后端代码"并返回"返回结果"和"需要界面展示的数据"。
- 前置/后置触发:
当表单删除数据时,在删除数据前或在删除数据后触发_formdelete事件。默认为"前置触发",详情请见后面的事件触发示意图 。
如果选择【前置触发】:表示前置提交,先执行后端代码,再删除数据,如果返回值的第一个参数为:False,则不会提交数据。
如果选择【后置触发】:表示后置提交,先删除数据,再执行后端代码,返回True或False对数据没有影响,只是给前端的提示。
函数原型
def _formdeletelib(config,formAlias,arg,action,other):
参数
参数 | 类型 | 描述 |
---|---|---|
config | 数组型 | 插件当前配置中的字段信息 |
formAlias | 字符型 | 表单的别名 |
arg | 数组:字典型 | 表单提交操作时传入的当前表单数据信息 |
action | 整型 | 当前的操作动作:删除时为3 |
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(删除,批量删除,清空数据时才有) | 事件表单,流程事件表单 |
dataId | 数据id(删除单条数据和批量删除时有,清空全部数据时无) | 事件表单,流程事件表单 |
batch | 批量删除时为True,其他为False | 事件表单,流程事件表单 |
clearAll | 清空数据时为True,其他为False | 事件表单,流程事件表单 |
单行文本,多行文本,子表单等字段 | 字段别名和对应的值(删除单条数据时有,批量删除和清空全部数据时无) 目前只支持3种属性(visible:是否可见,data:字段的数据,widgetType:字段类型) | 事件表单,流程事件表单 |
other的数据格式:
{
libResult={
{
datas={
单行文本={
data="单行文本的数据"
},
多行文本={
data="多行文本的数据"
}
},
result=True,
text="插件1的数据",
name="测试插件"
},
{
datas={
单行文本={
data="单行文本的数据"
},
多行文本={
data="多行文本的数据"
}
},
result=True,
text="插件2的数据",
name="测试插件"
},
...
}
}
名称 | 描述 |
---|---|
libResult | 前面插件的结果集信息,有几个插件就有几个子数组 |
result | 插件的逻辑型返回值 |
datas | 插件的数组型返回值 |
text | 插件的文本型返回值 |
name | 插件的名称 |
返回值
返回值接受多个返回值。
名称 | 类型 | 描述 |
---|---|---|
第1个返回值 | Boolean(逻辑型) | 返回结果为True(真)或False(假) |
第2个返回值(可选) | 文本字符串(字符型) | 返回文本内容给页面弹出提示 |
类型 | 返回值1 | 返回值2 |
---|---|---|
前置返回 | True:通过删除操作 | 前端展示文本信息,为空无提示 |
后置返回 | True:通过删除操作 | 前端展示文本信息,为空无提示 |
前置返回 | False:拦截删除操作 | 前端展示文本信息,为空无提示 |
后置返回 | False:通过删除操作 | 前端展示文本信息,为空无提示 |
没有返回 | 默认True:通过删除操作 | 默认为空,为空无提示 |
前置触发示意图: |
---|
后置触发示意图: |
---|
备注
- arg的数值是数组类型,因此大家可以通过数组的形式操作它。
- formdeletelib事件可以解决很多我们前端字段做不到的事情,例如: 批量录入数据,并自动计算相关内容; 新增/修改/删除数据后自动更新本表或其他表单数据; 以特殊格式或需求对提交的数据做特殊校验,如:会员卡、工作证校验等。
演示示例
- 暂无
安装包下载
- 暂无
相关视频
- 暂无