【组件】AgileBPM 工作台配置

2022-03-07 22:17:19 928 阅读 AI 写同款 · GEO 优化AI 选题数据监测一键分发 ›

对AgileBpm低代码平台的整体逻辑梳理本文章基于AgileBpm低代码平台及个人理解 AgileBpm整体项目逻辑划分比较清楚，能按照开发文档对各个部分进行基本的了解。 Agilebpm模块分析基础模块 Base 平台模块 Platform 业务对象+表单模块 Bus+Form 前端模块 Bpm-explorer 模块间依赖关系 1. 基础模块BASE base-api 提供通用请求入参、返回参数、基础实体、基础service/dao API定义、异常规范、校验定义 base-core 提供常用工具类、基础A. 阅读详情

工作台配置

面板前端目前是基于bootstrap 、angularjs 双向绑定的内容展示块。
提供多种不同的面板模板，不同的模板由不同的指令来渲染，模板会提供相应的案例内容。
您可以通过配置模板加载相应的数据来渲染出需要展示的内容

添加面板

系统管理->工作台配置点击添加

属性

名字：面板展示的标题
别名：面板内容数据的别名，eg:UserInfo,面板内容中可以用来展示数据内容
数据类型：数据类型支持Springbean 接口、自定义查询、iframe(则直接内嵌一个url)
数据来源：数据来源则是数据类型相应的值。（接口入参支持空或者queryfilter）
宽：面板所占屏幕的百分比
高：面板所占屏幕的px
更多链接：若配置则面板头部出现更多的按钮。点击后则新窗口跳转相应链接
自动刷新间隔：若配置则会自动刷新
类型：类型默认为basic，为基础模板，不同模板会有相应指令去解析内容
内容：为模板的内容，具体配置请参考模板介绍
调试预览：及时进行调试预览展示情况

面板授权

面板管理列中，对单个面板进行授权
有权限的面板才能被用户所添加和使用。可以通过用户、角色、组织等维度进行授权。若无权限则可以配置为“所有人”。

配置默认布局与布局调整

默认布局可以配置一套默认的面板布局。若用户没有自行调整布局则会默认使用当前布局。

布局调整

可以拖动头部来调整顺序，可以拖拽左侧和下侧来调整面板大小。
当触发面板调整后，会出现一些功能按钮

保存：保存当前调整
还原本次修改 ：若未保存，将重置本次修改。
使用默认宽高：将面板的宽高调整为面板配置的宽高
还原至默认布局：将使用系统配置的默认布局
添加面板 ：将获取个人拥有的权限的所有面板。选择并添加至当前工作台中

调整完毕，点击保存，将保存当前布局调整的配置信息。

基础数据模板

别名为数据来源获取的数据key,使用bootstrap布局，使用angularjs的指令标签来展示数据如：

<p class="text-info">{{userInfo.email}}</p>
<p class="text-info">{{userInfo.weixin}}</p>
<p class="text-info">{{userInfo.mobile}}</p>

效果图

列表数据模板案例

列表数据模板使用basic指令解析，需要接口返回数组格式的json。如下

可以配置加载数据所需的过滤参数

ng-model="param.xxx" 
//如条件区配置了 param.subject input框，则在搜索时，会将subject 值 post到后端
ng-click="loadPanelData()"
//该指令提供的刷新方法，会重新从服务器获取数据并渲染至页面

服务器获取参数并执行查询

public List getPendingOrder_biz_v2(QueryFilter queryFilter) {
	DefaultQueryFilter filter = (DefaultQueryFilter) queryFilter;
	//前端提供的param都会存与filter的params中
	
	String subject  = (String) filter.getParams().get("subject_");
	//将参数作为一种过滤条件
	if(StringUtil.isNotEmpty(subject)){
		filter.addFilter("task.subject_","%"+ subject + "%", QueryOP.LIKE);
	}
	//设置默认数据分页
	DefaultPage page = new DefaultPage();
	page.setLimit(10);
	filter.setPage(page);
	//将查询到的十条数据返回给前端
	return getPendingOrder_biz_v2(ContextUtil.getCurrentUserId(),queryFilter);
}

模板内容

<!- 头部搜索框-->
<div class="row">
	<div class="col-sm-7 m-b-xs">
		<div data-toggle="buttons" class="btn-group">
			<label class="btn btn-sm btn-default active"> <input type="radio" name="param.isTodo" value="1">待办</label>
			<label class="btn btn-sm btn-default"> <input type="radio" name="param.isTodo" value="2">已办</label>
		</div>
	</div>
	<div class="col-sm-5">
		<div class="form-inline">
			<input type="text" placeholder="搜索关键字" class="input-sm form-control" ng-model="param.subject_" > 
			<button type="button" ng-click="loadPanelData()" class="btn btn-sm btn-primary fa-search"></button>
		</div>
	</div>
</div>
<!- 列表数据展示-->
 <div class="table-responsive">
	<table class="table table-striped">
		<thead>
			<tr>
				<th>任务名称</th>
				<th>任务标题</th>
				<th>创建时间</th>
			</tr>
		</thead>
		<tbody>
			<tr ng-repeat="task in list">
				<td>{{task.name}}</td>
				<td><a ng-click="openFullWindow('/bpm/task/taskComplete.html?taskId='+this.task.id,loadPanelData)" >{{task.subject}}</a> </td>
				<td>{{task.createTime}}</td>
			</tr>
		</tbody>
	</table>
</div>

打开列表新页面处理完任务后刷新当前面板

在列表中传入 openFullWindow('url',loadPanelData)

url 即要打开的页面地址
loadPanelData 即当前刷新面板的方法

在新页面中可以通过 window.hasParentReload() 方法触发当前面板的刷新，其实就是把面板刷新方法赋值给了新的打开window，然后在新页面调用面板刷新即可。

效果图

图表模板

图标模板基于百度echarts 4，目前系统在预览界面使用的开发版源码（有常见的警告和错误提示），工作台界面则使用的常用版本。所以仅支持常用图表。

图标通过 echarts指令解析，需要面板类型选择echarts。

服务器返回数据格式要求
ECharts 4 开始支持了 dataset 组件用于单独的数据集声明，从而数据可以单独管理，被多个组件复用，并且可以基于数据指定数据到视觉的映射。这在不少场景下能带来使用上的方便。

我们这里要求服务器返回统一的数据格式为dataset.source赋值

饼状图数据集与配置

接口返回数据格式要求如下

[["交易保",5950],["提放保",3748],["赎楼E",1815],["买付保",3456]]

配置信息（配置在面板的展示内容中）可以根据文档配置更多属性

{
	"title": {},
	"legend": {},
	"tooltip": {},
	"dataset": {
		"source": []
	},
	"series": [{
		"type": "pie"
	}]
}

如此配置就完成了饼图的开发。结果如图

柱状图与折线图

如下接口返回数据集表达了三个产品在不同年度销售数量，默认第一列为产品项。

 [
    ["product","交易保","提放保","赎楼E"],  
    ["2015",161,5672,3626],
    ["2016",3751,1443,4807],
    ["2017",1456,1151,5432],
    ["2018",5661,1712,3321]
]

柱状图提供了默认的配置支持，所以不需要任何额外配置。若有特殊配置需要，可以将配置设置到面板的展示内容中，会自动覆盖默认配置