_datahelperlib

• _datahelperlib
• 功能说明
  • 描述
  • 函数原型
  • 参数
  • 参数详解
    • config的数据格式：
    • triggerType：
    • outputInfo的数据格式为：
    • arg的数据格式为：
      • 通用arg：
      • 带控件触发信息的arg
      • 带流程信息的arg
      • 带报表弹出表单初始化信息的arg
  • 返回值
  • 备注
  • 演示示例
  • 安装包下载
• 相关视频

功能说明

描述

数据助手事件：当在数据助手编辑界面中的执行动作选择【功能插件】且触发模式为【功能插件】，那么表单进行相关操作时，就会触发此功能函数，最后根据代码里的数据返回来进行相关处理 此事件触发有1个必要的条件：

①、数据助手界面里，【执行动作】选择【功能插件-功能插件】并进行插件设置

• 数据助手界面：

函数原型

def _datahelperlib(config,triggerType,outputInfo,arg,other):

参数

名称	类型	描述
config	数组型	插件当前配置中的字段信息
triggerType	字符型	功能助手的操作类型
outputInfo	数组型	功能助手的输出表的表头和数据信息
arg	数组型	在不同的操作类型下有不同的数据内容，通用信息包含客户端ip，操作人id，浏览器信息，源表别名
other	数组型	附加信息，暂时只有前面插件的所有结果集信息，没有的话为空数组

参数详解

config的数据格式：

• 请查阅各类插件控件的参数说明。

triggerType：

triggerType	说明
initialize	表单初始化
submit	表单提交数据
updateform	表单编辑数据
deleteform	表单删除数据
event	表单控件触发
flownodeforward	流程提交
flownodesave	流程暂存
flownodeback	流程回退
flownodetransfer	流程转交
flownodeclose	流程关闭
datatable_menu	数据表菜单
editInitialize	表单编辑初始化
floweditInitialize	流程节点初始化
schedule	计划任务
batch_menu	报表菜单
import	数据导入

outputInfo的数据格式为：

{
    'data':[{
        '_widget_1607153981478':'11',
        '_widget_1607153981479':'22',
        '_widget_1607153981480':'33',
        'subform':[{
            '_widget_1607153981481':'11',
            '_widget_1607153981482':'22',
            '_widget_1607153981483':'33'
        }]
    }],
    'header':{
        '_widget_1607153981478':{
            'name':'_widget_1607153981478',
            'text':'单行文本',
            'type':'text'
        },
        '_widget_1607153981479':{
            'name':'_widget_1607153981479',
            'text':'多行文本',
            'type':'textarea'
        },
        '_widget_1607153981480':{
            'name':'_widget_1607153981480',
            'text':'数字',
            'type':'number'
        },
        'subform':{
            'items':{
                '_widget_1607153981481':{
                    'name':'_widget_1607153981481',
                    'text':'单行文本',
                    'type':'text'
                },
                '_widget_1607153981482':{
                    'name':'_widget_1607153981482',
                    'text':'多行文本',
                    'type':'textarea'
                },
                '_widget_1607153981483':{
                    'name':'_widget_1607153981483',
                    'text':'数字',
                    'type':'number'
                }
            },
            'name':'subform',
            'text':'子表单',
            'type':'subform'
        }
    }
}

名称	描述
data	输入数据
header	表头信息
_widget	字段id
subform	子表单信息
name	字段id
text	字段标题
type	字段类型

arg的数据格式为：

通用arg：

{
    'formAlias':'test',
    'formData':{
        "单行文本":{
                "data":"11",
                "widgetType":"text"
            },
            "多行文本":{
                "data":"11",
                "widgetType":"textarea"
            },
            "子表单":{
                "data":[{
                    "单行文本2":{
                        "data":"11",
                        "widgetType":"text"
                    }
                }],
                "widgetType":"subform"
            },
            "数字":{
                "data":100,
                "widgetType":"number"
            }
    },
    'clientIp':'175.10.233.62',
    'operator':'547a48c50eccde5ac8c0883b',
    'useragent':'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/87.0.4280.88 Safari/537.36'
}

名称	描述
formAlias	源表别名
formData	源表的数据
operator	当前操作人的userid
clientIp	客户端ip
useragent	访问此表的userid信息和浏览器信息

带控件触发信息的arg

{
    'clientIp':'xxx.xxx.xxx.xxx',
    'formAlias':'545f0f4d224f947922b60e75',
    'operator':'55cb7d57f7a190e382857117',
    'useragent':'Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/70.0.3538.25 Safari/537.36 Core/1.70.3823.400 QQBrowser/10.7.4307.400',
    'widgetValue':{
        'data':'11',
        'widgetNameAlias':'单行文本',
        'widgetType':'text'
    }
}

名称	描述
widgetValue	控件信息
data	控件数据
widgetNameAlias	控件别名
widgetType	控件类型

带流程信息的arg

{
    'clientIp':'xxx.xxx.xxx.xxx',
    'flow':{
        'flowId':0,
        'flowIdAlias':'节点0',
        'flowVer':'1'
    },
    'formAlias':'545f0f4d224f947922b60e75',
    'operator':'55cb7d57f7a190e382857117',
    'useragent':'Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/70.0.3538.25 Safari/537.36 Core/1.70.3823.400 QQBrowser/10.7.4307.400'
}

名称	描述
flow	流程信息
flowId	流程节点
flowIdAlias	流程节点别名
flowVer	流程版本

带报表弹出表单初始化信息的arg

{
    'clientIp':'xxx.xxx.xxx.xxx',
    'formAlias':'545f0f4d224f947922b60e75',
    'initSource':{
        'menuInfo':{
            'name':'菜单1'
        },
        'sourceAlias':'5f564e8621e4afb7e9f2549b',
        'type':'tablemenu',
        'widgetAlias':'_widget_1607157672906'
    },
    'operator':'55cb7d57f7a190e382857117',
    'useragent':'Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML,like Gecko) Chrome/70.0.3538.25 Safari/537.36 Core/1.70.3823.400 QQBrowser/10.7.4307.400'
}

名称	描述
initSource	弹出表单的来源信息
menuInfo	显示的菜单信息（name：菜单名称）
sourceAlias	报表别名
type	菜单类型（tablemenu：表示数据表菜单，batchmenu：表示报表菜单）
widgetAlias	数据表别名

返回值

返回值接受多个返回值。

• 第一个返回值为True（真）时，会继续往下执行数据助手的功能
• 第一个返回值为False（假）时，前端展示提示并终止执行数据助手的功能 （如果没有返回值时第一个返回值默认为True（真），第二个返回值默认为空）

备注

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

演示示例

• 暂无

安装包下载

• 暂无

相关视频

• 暂无