Liferay7 BPM门户开发之23: 了解内置工作流(Kaleo Workflow)

时间:2022-12-29 18:02:04

Liferay内置的工作流是企业版的功能,虽然简单粗糙,但依然不支持社区版。
既然要用更强大的Activiti来替代它,那就非常有必要学习一下内置工作流的一些思想,以便借鉴。

它的特点:

  • 实体的工作流操作可以通过service layer进行集成;
  • 需要添加4个额外的字段来跟踪流程状态;
  • 通过Service Builder来建立字段,然后更新service layer;
  • 视图层UI可以显示实体的工作流状态。

实体集成逻辑

比如,发布一个实体类的工作流支持,首先添加注解:

@Component(
property = {"model.class.name=com.my.app.package.model.FooEntity"},
service = WorkflowHandler.class
)

开发XXXWorkflowHandler,实现Override 三个方法

package com.liferay.docs.foo.workflow;

...
public class FooEntityWorkflowHandler extends BaseWorkflowHandler { public static final String CLASS_NAME = FooEntity.class.getName(); @Override
public String getClassName() { return CLASS_NAME;
} @Override
public String getType(Locale locale) {
return LanguageUtil.get(locale, "model.resource" + CLASS_NAME);
} @Override
public Object updateStatus(int status,
Map<String, Serializable> workflowContext) throws PortalException,
SystemException { long userId = GetterUtil.getLong(
(String)workflowContext.get(WorkflowConstants.CONTEXT_USER_ID));
long fooEntityId = GetterUtil.getLong(
(String)workflowContext.get(
WorkflowConstants.CONTEXT_ENTRY_CLASS_PK)); ServiceContext serviceContext = (ServiceContext)workflowContext.get(
"serviceContext"); return FooEntityLocalServiceUtil.updateStatus(
userId, fooEntityId, status, serviceContext); }
}

为了记录实体的当前流程状态,必须要有以下4个字段(通过Service Builder)
service.xml中添加:

<column name="status" type="int" />
<column name="statusByUserId" type="long" />
<column name="statusByUserName" type="String" />
<column name="statusDate" type="Date" />

比如在更新实体时,自动通过这4个字段,把实体和流程状态相关联:

fooEntity.setStatus(status);
fooEntity.setStatusByUserId(user.getUserId());
fooEntity.setStatusByUserName(user.getFullName());
fooEntity.setStatusDate(serviceContext.getModifiedDate(now)); fooEntityPersistence.update(fooEntity);

启动一个和实体关联的流程:

WorkflowHandlerRegistryUtil.startWorkflowInstance(fooEntity.getCompanyId(),
fooEntity.getGroupId(), fooEntity.getUserId(), FooEntity.class.getName(),
fooEntity.getPrimaryKey(), fooEntity, serviceContext);

如果实体属于Assets,那在为实体设置工作流字段后,就可以添加任何附加的逻辑方法。
例如,如果想根据其工作流状态来设置可见性(未审批就不显示):

if (status == WorkflowConstants.STATUS_APPROVED) {
  assetEntryLocalService.updateEntry(
    FooEntity.class.getName(), fooEntityId, fooEntity.getDisplayDate(),
    null, true, true);
}
else {
  assetEntryLocalService.updateVisible(
    fooEntity.class.getName(), entryId, false);
}

为了在视图中展示,需要设置finder (service.xml)

<finder name="G_S" return-type="Collection">
<finder-column name="groupId"></finder-column>
<finder-column name="status"></finder-column>
</finder>

实现一个Getter:

public List<FooEntity> getFooEntities(long groupId, int status)
throws SystemException {
return fooEntityPersistence.findByG_S(groupId,
WorkflowConstants.STATUS_APPROVED);
} jsp UI: <liferay-ui:search-container-results
results="<%=FooEntityLocalServiceUtil.getFooEntities(scopeGroupId,
fooEntityId(), Workflowconstants.STATUS_APPROVED, searchContainer.getStart(),
searchContainer.getEnd())%>"
...

流程设计器

这个属于企业版功能,有点弱

Liferay7 BPM门户开发之23: 了解内置工作流(Kaleo Workflow)

这个有点意思:
设置启动任务的签收者,

Liferay7 BPM门户开发之23: 了解内置工作流(Kaleo Workflow)

一共有6种类型:

  • 创建者
  • 某角色
  • 角色ID
  • 通过一个代码段来指定
  • 特定的用户
  • 通过资源

在Kaleo中,只有这6种节点,这实在可怜,恐怕要实现复杂的流程将依靠编写大量的代码来实现。

现在知道为啥Kaleo叫workflow而不是叫BPM了吧,因为其不能实现业务流程集成,但实现仅简单顺序流程,还是没有问题的。

  • Condition: 通过脚本来实现条件逻辑(script包含几种语言:Beanshell、Drl、Groovy、JavaScript、Python、Ruby),这有点不太友好和方便;
  • Fork: 并行处理
  • Join: Fork并行后的汇总,这个可以实现会签,比如说一个节点由领导A、领导B同时审核才能结束,往下走;
  • Join XOR: 异或逻辑的汇总,通俗的说就是实现抢签,有点像Activiti的候选组的概念,比如说一个节点由领导A、领导B审核,随便一个领导先审核了,节点就结束,往下走;
  • State: 状态节点,比如开始、结束就是属于这个类型;
  • Task: 任务节点,比如审批、填写表单....

Liferay7 BPM门户开发之23: 了解内置工作流(Kaleo Workflow)

一个XML的描述文件:

Liferay7 BPM门户开发之23: 了解内置工作流(Kaleo Workflow)