Activiti6 Task查询API 映射 SQL

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

日志将avtiviti相关调整到DEBUG模式接口打印对应sql。

二、查询接口
2.1 taskAssignee
按照指派人查询，直接查询表 ACT_RU_TASK。
API：

taskService.createTaskQuery().taskAssignee(userId);

SQL：

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

2.2 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(?))

2.3 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(?))

2.4 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_ = ?))))

2.5 taskCandidateUser
API：

taskService.createTaskQuery().taskCandidateUser(userId);

SQL：
先查找用户所属的组（用户所属用户组的信息从 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_ = ?)

2.6 taskOwner
按照所属人查询
API：

taskService.createTaskQuery().taskOwner(userId);

SQL：

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

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

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