编写版本: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 作者:黄春艳