Activiti 开发案例之 API 映射 SQL 查询

前言

Activiti 自身提供了一套用户管理，但是在开发中业务系统本身就有一套用户管理系统，这时候就要把业务系统中的部分用户数据同步到 Activiti 用户表管理中。那么，如果不同步呢？不少开发者一开始以为必须要有用户才可以运行，其实 Task 的 Assignee，Candidate Users，Candidate Groups 信息已经以字符串形式保存在 act_ru_tak 和 ACT_RU_IDENTITYLINK 表中。只有少部分的查询 API 会用到 ACT_ID_* 表中的数据进行关联查询。

环境

软件	版本
SpringBoot	1.5.10
activiti-spring-boot-starter-basic	6.0

查询

taskAssignee

按照指派人查询，直接查询表 ACT_RU_TASK。

API：

taskService.createTaskQuery().taskAssignee(userId);

SQL：

select distinct RES.* from ACT_RU_TASK RES WHERE RES.ASSIGNEE_ = ?

taskCandidateGroup

按照分配组查询，没有用到 ACT_ID_* 表的数据。

API：

taskService.createTaskQuery().taskCandidateGroup("部门经理");

SQL：

SELECT DISTINCT
  RES.*
FROM ACT_RU_TASK RES
  INNER JOIN ACT_RU_IDENTITYLINK I
    ON I.TASK_ID_ = RES.ID_
WHERE RES.ASSIGNEE_ IS NULL
    AND I.TYPE_ = 'candidate'
    AND (I.GROUP_ID_ IN(?))

taskCandidateGroupIn

按照分配组查询，没有用到 ACT_ID_*表的数据。

API：

List<String> candidateGroups = new ArrayList<String>();
candidateGroups.add("部门经理");
candidateGroups.add("总裁");
taskService.createTaskQuery().taskCandidateGroupIn (candidateGroups);

SQL：

SELECT DISTINCT
  RES.*
FROM ACT_RU_TASK RES
  INNER JOIN ACT_RU_IDENTITYLINK I
    ON I.TASK_ID_ = RES.ID_
WHERE RES.ASSIGNEE_ IS NULL
    AND I.TYPE_ = 'candidate'
    AND (I.GROUP_ID_ IN(?))

taskCandidateOrAssigned

按照分配组 OR 指派人查询，用到了 ACT_ID_*表的数据，传入userId查询其所在权限组。

API:

taskService.createTaskQuery().taskCandidateOrAssigned(userId);

SQL:

首先查询用户所在组权限

SELECT
  g.*
FROM ACT_ID_GROUP g,
  ACT_ID_MEMBERSHIP membership
WHERE g.ID_ = membership.GROUP_ID_
    AND membership.USER_ID_ = ?

然后查询指派人任务或者指派人为空并且用户所在权限组的任务

SELECT DISTINCT
  RES.*
FROM ACT_RU_TASK RES
  LEFT JOIN ACT_RU_IDENTITYLINK I
    ON I.TASK_ID_ = RES.ID_
WHERE (RES.ASSIGNEE_ = ?
        OR (RES.ASSIGNEE_ IS NULL
            AND (I.USER_ID_ = ?
                  OR I.GROUP_ID_ IN(SELECT
                                      g.GROUP_ID_
                                    FROM ACT_ID_MEMBERSHIP g
                                    WHERE g.USER_ID_ = ?))))

taskCandidateUser

API：

taskService.createTaskQuery().taskCandidateUser(userId);

先查找用户所属的组（用户所属用户组的信息从 Activiti 的 ACT_ID_*表获取）

SELECT
  g.*
FROM ACT_ID_GROUP g,
  ACT_ID_MEMBERSHIP membership
WHERE g.ID_ = membership.GROUP_ID_
    AND membership.USER_ID_ = ?

如果找到了用户组信息

SELECT DISTINCT
  RES.*
FROM ACT_RU_TASK RES
  INNER JOIN ACT_RU_IDENTITYLINK I
    ON I.TASK_ID_ = RES.ID_
WHERE RES.ASSIGNEE_ IS NULL
    AND I.TYPE_ = 'candidate'
    AND (I.USER_ID_ = ?
          OR I.GROUP_ID_ IN(?))

如果找不到用户所属的组

SELECT DISTINCT
  RES.*
FROM ACT_RU_TASK RES
  INNER JOIN ACT_RU_IDENTITYLINK I
    ON I.TASK_ID_ = RES.ID_
WHERE RES.ASSIGNEE_ IS NULL
    AND I.TYPE_ = 'candidate'
    AND (I.USER_ID_ = ?)

按照所属人查询 taskOwner

API：

taskService.createTaskQuery().taskOwner(userId);

SQL：

SELECT DISTINCT
  RES.*
FROM ACT_RU_TASK RES
WHERE RES.OWNER_ = ?

日志

在 logback.xml 追加以下配置，就可以输出 Activiti 查询语句。

<!-- Activiti日志 -->
<logger name="org.activiti" level="INFO" />
<logger name="org.activiti.engine.impl.persistence.entity" level="DEBUG" />

说明

有些查询使用到 Activiti 自带的用户信息的，比如 taskCandidateOrAssigned，如果项目中使用了自己的权限系统，这些 API 是不灵光的，这里提供三种方案，仅供参考：

同步系统用户权限信息到 Activiti 自带用户组，不推荐。
修改源代码 Task.xml 中的查询SQL，把 Activiti 自带的用户表替换成业务系统用户表，不推荐。
用视图覆盖同名的ACT_ID_系列表，创建的视图要保证数据类型，推荐。