编写版本:v3.5.0
适用版本:v3.5.0+

Groovy脚本使用说明

简介:groovy脚本是维护在后端的ibps-excessive-root\modules\platform-excessive工程目录下,产品自带维护在下面脚本类中:

1、BpmnScript.java  //主要与工作流接口业务相关脚本
2、BusinessScript.java //主要业务逻辑相关脚本,比如:库存增/减,查询某个表在增加在另表等
3、CommonScript.java //通用脚本类,比如:获取当前用户信息、组织等
4、JdbcScript.java //主要与jdbc增加、更新、查询的脚本
5、ThridServiceScript.java //主要调用第三方接口相关脚本
6、ValidationScript.java //主要与数据唯一性做校验相关脚本

常用Bean列表

BeanID Bean说明 使用文档
cmd IBPS流程执行对象(任务、实例) 在这里http://doc.bpmhome.cn/docs/ibps_v3_develop/ActionCmd
execution Activiti任务执行对象 在这里http://doc.bpmhome.cn/docs/ibps_v3_develop/BpmDelegateTask
mybatisTemplateProvider SQL执行对象(基于Mybatis,事务一致) 在这里http://doc.bpmhome.cn/docs/ibps_v3_develop/MybatisTemplateProvider
jdbcScript SQL脚本对象(基于JdbcTemplate,事务不一致) 在这里http://doc.bpmhome.cn/docs/ibps_v3_develop/JdbcScript
bpmnScript 流程脚本对象 在这里http://doc.bpmhome.cn/docs/ibps_v3_develop/BpmnScript
businessScript 业务脚本对象 在这里http://doc.bpmhome.cn/docs/ibps_v3_develop/BusinessScript
cscript 通用脚本对象 在这里http://doc.bpmhome.cn/docs/ibps_v3_develop/CommonScript
thridServiceScript 第三方服务脚本对象 在这里http://doc.bpmhome.cn/docs/ibps_v3_develop/ThridServiceScript
validationScript 校验脚本对象 在这里http://doc.bpmhome.cn/docs/ibps_v3_develop/ValidationScript

说明:

  • 调用规则:BeanID.方法名进行调用方式,即:cscript.getCurrentName();
  • 本身产品维护的脚本类中没有用户相关的业务方法,可自定义脚本类进行增加,开发指导移步:自定义脚本开发范例

1、表单管理

登录系统,在【表单管理】-【表单管理】使用Groovy脚本主要在“默认值-动态脚本”、“选择器-范围脚本”、“标签和按钮-文本固定值动态脚本”的使用操作说明,如下图所示:

选择某条数据直接进入“表单设计器”,如下图:

1.1 默认值-动态脚本

选中某个控件,在设计右边选择“默认值”属性下拉选择“动态脚本”,比如:选中是“单行文本”控件,如下图:

点击“动态脚本”进入编写脚本代码编辑器,比如:获取当前用户账号可调用脚本代码“cscript.getAccount();”,如下图:

注意:脚本方法中返回的类型需要与业务对象定义的类型一致,比如:名称是字符串,年龄是数字,那么在后端脚本类方法返回的类型必须匹配一致!

  • CommonScript.java类中常调用方法说明:
方法 说明 返回类型 脚本调用方式
getAccount() 获取当前登录用户账号信息 字符串 cscript.getAccount();
getCurrentUserId() 获取当前登录用户ID信息 字符串 cscript.getCurrentUserId();
getCurrentName() 获取当前登录用户名称信息 字符串 cscript.getCurrentName();
getCurrentOrgName() 获取当前登录用户所在组织名信息 字符串 cscript.getCurrentOrgName();
getCurrentOrgId() 获取当前登录用户所在组织ID信息 字符串 cscript.getCurrentOrgId();
getCurrentPositionName() 获取当前登录用户所在的主岗位名称信息 字符串 cscript.getCurrentPositionName();
getCurrentPositionId() 获取当前登录用户所在的主岗位ID信息 字符串 cscript.getCurrentPositionId();
getCurDate() 获取系统当前日期,默认格式:yyyy-MM-dd 字符串 cscript.getCurDate();
getCurDateTime() 获取系统当前日期时间,默认格式:yyyy-MM-dd HH:mm:ss 字符串 cscript.getCurDateTime();

2、流程定义管理-设置事件脚本

登录系统,在【工作流程】-【流程定义管理】使用Groovy脚本主要在“事件设置”进行使用,如下图:

进入设置页面,选中节点信息在系统页面右边区域选择“事件设置”的“前置/后置脚本”,如下图:

说明

文档更新时间: 2022-08-08 17:18   作者:黄春艳