nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

As we transition to the new Hyland Community, some post links may be temporarily disrupted as we finalize redirects. We apologize for the inconvenience and are working to resolve this as quickly as possible. Details.

what does 'involvedUser' mean ?

heymjo

Hi,

The javadoc of TaskQuery.involvedUser says

/** Only select tasks for which there exist an {@link IdentityLink} with the given user */

but what does that really mean ? As an API user you would normally not deal with identity links so the description is kind of technical and means not much to me, unless i drill down to the identitylink javadoc which is not that helpful either to understand. Can someone just in plain terms say what 'involvedUser' means, something like candidateUser + member of candidateGroup + assigned tasks ?

See also http://forums.activiti.org/en/viewtopic.php?f=6&t=1671. The activiti-webapp2 has a component dedicated to this, so involvedUser must be an important workflow concept in Activiti ..

Thanks
Jorg

Find more posts tagged with

Comments

trademak

Hi,

Involved user means that the user has been linked to the task.
So think of it as a possible assignee of the task or somebody who can look at the status of a user task.

Best regards,

heymjo

So think of it as a possible assignee of the task or somebody who can look at the status of a user task.

Yet a possible assignee != a candidate user apparently, see Frederik's last message on the linked forum thread where he says

So if the user is a candidate for a task, the query will not return those tasks.

Also when you say

Involved user means that the user has been linked to the task.

–> linking users to tasks means executing AddIdentityLinkCmd right ? There are in taskservice 5 methods that do this

<br>&nbsp; public void setAssignee(String taskId, String userId) {<br>&nbsp;&nbsp;&nbsp; commandExecutor.execute(new AddIdentityLinkCmd(taskId, userId, null, IdentityLinkType.ASSIGNEE));<br>&nbsp; }<br>&nbsp; <br>&nbsp; public void setOwner(String taskId, String userId) {<br>&nbsp;&nbsp;&nbsp; commandExecutor.execute(new AddIdentityLinkCmd(taskId, userId, null, IdentityLinkType.OWNER));<br>&nbsp; }<br>&nbsp; <br>&nbsp; public void addCandidateUser(String taskId, String userId) {<br>&nbsp;&nbsp;&nbsp; commandExecutor.execute(new AddIdentityLinkCmd(taskId, userId, null, IdentityLinkType.CANDIDATE));<br>&nbsp; }<br>&nbsp; <br>&nbsp; public void addCandidateGroup(String taskId, String groupId) {<br>&nbsp;&nbsp;&nbsp; commandExecutor.execute(new AddIdentityLinkCmd(taskId, null, groupId, IdentityLinkType.CANDIDATE));<br>&nbsp; }<br>&nbsp; <br>&nbsp; public void addUserIdentityLink(String taskId, String userId, String identityLinkType) {<br>&nbsp;&nbsp;&nbsp; commandExecutor.execute(new AddIdentityLinkCmd(taskId, userId, null, identityLinkType));<br>&nbsp; }<br><br>&nbsp; public void addGroupIdentityLink(String taskId, String groupId, String identityLinkType) {<br>&nbsp;&nbsp;&nbsp; commandExecutor.execute(new AddIdentityLinkCmd(taskId, null, groupId, identityLinkType));<br>&nbsp; }<br>

addCandidateUser adds an identity link yet it was said above that candidateusers do not cause a user to be 'involved' in a task.

This is all a bit confusing to me, so what am I missing ? :?

trademak

Hi,

If you set a candidate user on a task, a task query will return this task when you query on involvedUser.
It will not return the task if you only set the person as owner, assignee or in a candidate group.
You can also add a custom user identity link and the involvedUser will return these tasks also.

Best regards,

heymjo

This does not make sense

I made a quick test on a simple 2 step process definition. What it does first is testing if user "jorg" is a candidate user for a task. This returns true. Then i test for the number of tasks he's an involved user for, this returns 0. Then i add him as a candidate user to the same task he is already a candidate user for, and now all of a sudden he's an involved user on that task ?????????

<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; // "jorg" should have one task after the processinstance was created<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; List<Task> myTasks =<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; processEngine.getTaskService().createTaskQuery().processDefinitionId(processDefinition.getId())<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; .taskCandidateUser("jorg").list();<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Assert.assertNotNull(myTasks);<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Assert.assertTrue(myTasks.size() == 1);<br><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; // now see if he's involved user on any task of the the process instance<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Assert.assertTrue(<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; processEngine.getTaskService().createTaskQuery().processDefinitionId(processDefinition.getId())<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; .taskInvolvedUser("jorg").list().size() == 0);<br><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; // now add myself to the task as candidate user<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; processEngine.getTaskService().addCandidateUser(myTasks.get(0).getId(), "jorg");<br><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; // and now all of a sudden i'm involved user on the task <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Assert.assertTrue(<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; processEngine.getTaskService().createTaskQuery().processDefinitionId(processDefinition.getId())<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; .taskInvolvedUser("jorg").list().size() == 1);<br><br>

the process definition is very simple, user "jorg" has the ROLE_EDIT permission assigned.

<br><definitions id="definitions"<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; targetNamespace="<a href="http://activiti.org/bpmn20" rel="nofollow noopener noreferrer">http://activiti.org/bpmn20</a>"<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; xmlns:activiti="<a href="http://activiti.org/bpmn" rel="nofollow noopener noreferrer">http://activiti.org/bpmn</a>"<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; xmlns="<a href="http://www.omg.org/spec/BPMN/20100524/MODEL" rel="nofollow noopener noreferrer">http://www.omg.org/spec/BPMN/20100524/MODEL</a>"><br><br>&nbsp; <process id="ProcessVarSecurity"><br><br>&nbsp;&nbsp;&nbsp; <startEvent id="begin"/><br><br>&nbsp;&nbsp;&nbsp; <sequenceFlow id="flow1" sourceRef="begin" targetRef="createReport"/><br><br>&nbsp;&nbsp;&nbsp; <userTask id="createReport" name="create the report" activiti:candidateGroups="ROLE_EDIT"/><br><br>&nbsp;&nbsp;&nbsp; <sequenceFlow id="flow2" sourceRef="createReport" targetRef="verifyReport"/><br><br>&nbsp;&nbsp;&nbsp; <userTask id="verifyReport" name="verify the report" activiti:candidateGroups="ROLE_EDIT"/><br><br>&nbsp;&nbsp;&nbsp; <sequenceFlow id="flow3" sourceRef="verifyReport" targetRef="end"/><br><br>&nbsp;&nbsp;&nbsp; <endEvent id="end"/><br><br>&nbsp; </process><br><br></definitions><br>

Please enlighten me, i still don't get the concept of involvedUser and its usefullness.