_formupdatelib

• _formupdatelib
  • 功能说明
    • 描述
    • 函数原型
    • 参数
    • 参数详解
      • config的数据格式：
      • arg的数据格式为：
      • other的数据格式：
    • 返回值
    • 备注
    • 演示示例
    • 安装包下载
  • 相关视频

功能说明

描述

『表单编辑插件事件』入口函数， 启用后通过“数据管理”或“分析报表 - 数据表”，对单条数据进行编辑提交表单时触发。

• 通过此事件，可以即时反馈相关信息给提交者，便于交互。
• 此事件触发有2个必要的条件：

①、表单类型没有限制。
②、表单属性里“表单编辑数据”选择为“功能插件”。

表单属性 - 启用表单编辑后端事件

• 事件触发流程：

触发事件后，前端页面会将"当前表单别名"，"表单数据信息"，"数据提交类型"传给后端对应的云应用中的"_formupdatelib"函数，然后执行"后端代码"并返回"返回结果"和"需要界面展示的数据"。

• 前置/后置触发：

当表单修改数据时，在修改数据前或在修改数据后触发"_formupdatelib"事件。默认为"前置触发"，详情请见后面的事件触发示意图 。
如果选择【前置触发】：表示前置提交，先执行后端代码，再修改数据，如果返回值的第一个参数为：False，则不会提交数据。
如果选择【后置触发】：表示后置提交，先修改数据，再执行后端代码，返回True或False对数据没有影响，只是给前端的提示。

函数原型

def _formupdatelib(config,formAlias,arg,action,other):

参数

名称	类型	描述
config	数组型	插件当前配置中的字段信息
formAlias	字符型	表单的别名
arg	数组：字典型	表单提交操作时传入的当前表单数据信息
action	整型	当前的操作动作：编辑时为2
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={
        {
            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个返回值（可选）	文本字符串（字符型）	返回文本内容给页面弹出提示
第3个返回值（可选）	json字符串（字符型）	返回结果可修改前端表单字段赋值与属性

类型	返回值1	返回值2	返回值3
前置返回	True：通过编辑操作	前端展示文本信息，为空无提示	参数无效
后置返回	True：通过编辑操作	前端展示文本信息，为空无提示	参数无效
前置返回	False：拦截编辑操作	前端展示文本信息，为空无提示	根据json字符串，修改前端表单字段赋值与属性
后置返回	False：通过编辑操作	前端展示文本信息，为空无提示	参数无效
没有返回	默认True：通过编辑操作	默认为空，为空无提示	参数无效

前置触发示意图：

后置触发示意图：

备注

1. arg的数值是数组类型，因此大家可以通过数组的形式操作它。
2. formupdatelib事件可以解决很多我们前端字段做不到的事情，例如： 批量录入数据，并自动计算相关内容； 新增/修改/删除数据后自动更新本表或其他表单数据； 以特殊格式或需求对提交的数据做特殊校验，如：会员卡、工作证校验等。

演示示例

• 暂无

安装包下载

• 暂无

相关视频

• 暂无