topic Re: Email reviewers on parallel review workflow in Alfresco Archive

Email reviewers on parallel review workflow

ph73nt — Thu, 20 Jan 2011 17:20:28 GMT

Dear forumI edited the sample parallel review workflow in an attempt to email reviewers on initiation. I've been able to do something similar (by searching this forum) for the parallel group review and the adhoc task, but not this one. I'm suspicious that the problem is to do with the way I use bpm_

Re: Email reviewers on parallel review workflow

isloat — Mon, 24 Jan 2011 12:09:56 GMT

Hi,
I use the e-mail notification in another node. Not the start-task one:

 <start-state name="start">
      <task name="wf:submitParallelReviewTask" swimlane="initiator" />
      <transition name="" to="startreview" />
   </start-state>

   <node name="startreview">
        <action class="org.alfresco.repo.workflow.jbpm.ForEachFork">
            <foreach>#{bpm_assignees}</foreach>
            <var>user</var>
        </action>
        <transition name="transName" to="dosomething">
      <action class="org.alfresco.repo.workflow.jbpm.AlfrescoJavaScript">
          <script>
         var mail = actions.create("mail");
         mail.parameters.to = user.properties.email;
         mail.parameters.subject ="Document for approval";
         mail.parameters.from = initiator.properties.email;
         mail.parameters.text =  mail.parameters.text = initiator.properties.firstName + " "
                         + initiator.properties.lastName
                         + " has requested a document review: "
                         + "\u000D\u000D"
                         + bpm_workflowDescription
                         + "\u000D\u000D"
                         + "Log on to Alfresco here: http://10.136.1.176:8080/share";
         mail.execute(bpm_package);
          </script>
      </action>
   </transition>
   </node>‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

It works in my WF.

Good luck!

Re: Email reviewers on parallel review workflow

ph73nt — Wed, 26 Jan 2011 14:01:33 GMT

Good method, thanks, Neil

Re: Email reviewers on parallel review workflow

mthomas — Sun, 30 Jan 2011 23:33:01 GMT

This isn't working for me. The email gets sent but I the task isn't created for the assigned user. I recieve an error, "org.alfresco.service.cmr.workflow.WorkflowException: 00300001 Failed to signal transition null from workflow task jbpm$609."

<?xml version="1.0" encoding="UTF-8"?>

<process-definition xmlns="urn:jbpm.org:jpdl-3.1" name="wf:parallelreview">

    <swimlane name="initiator" />

    <start-state name="start">
        <task name="wf:submitParallelReviewTask" swimlane="initiator" />
        <transition name="" to="startreview"/>
    </start-state>

    <node name="startreview">
        <action class="org.alfresco.repo.workflow.jbpm.ForEachFork">
            <foreach>#{bpm_assignees}</foreach>
            <var>reviewer</var>
        </action>
   <transition name="transName" to="dosomething">
   <action class="org.alfresco.repo.workflow.jbpm.AlfrescoJavaScript">
   <runas>admin</runas>
           <script>
                var mail = actions.create("mail");
                mail.parameters.to = reviewer.properties.email;
                mail.parameters.subject ="Document for your review";
            mail.parameters.from = initiator.properties.email;
            mail.parameters.text =  mail.parameters.text = initiator.properties.firstName + " "
                         + initiator.properties.lastName
                         + " has requested a document review: "
                         + "\u000D\u000D"
                         + bpm_workflowDescription
                         + "\u000D\u000D"
                         + "Log on to Share here: ";
            mail.execute(bpm_package);
           </script>
         </action>
   </transition>        
        <event type="node-enter">
            <script>
                <variable name="wf_approveCount" access="write" />
                <expression>
                    wf_approveCount = 0;
                </expression>
            </script>
        </event>
        <transition name="review" to="review" />
    </node>

    <task-node name="review">
        <task name="wf:reviewTask">
            <assignment class="org.alfresco.repo.workflow.jbpm.AlfrescoAssignment">
               <actor>#{reviewer}</actor>
            </assignment>
            <event type="task-create">
                <script>
                    if (bpm_workflowDueDate != void) taskInstance.dueDate = bpm_workflowDueDate;
                    if (bpm_workflowPriority != void) taskInstance.priority = bpm_workflowPriority;
                </script>
            </event>
        </task>
        <transition name="approve" to="endreview">
            <script>
                <variable name="wf_approveCount" access="read,write" />
                <expression>
                    wf_approveCount = wf_approveCount +1;
                 </expression>
            </script>
        </transition>
        <transition name="reject" to="endreview" />
    </task-node>

    <join name="endreview">
        <transition to="isapproved" />
    </join>

    <decision name="isapproved">
        <event type="node-enter">
           <script>
              <variable name="wf_reviewerCount" access="write"/>
              <variable name="wf_requiredPercent" access="write"/>
              <variable name="wf_actualPercent" access="write"/>
              <expression>
                  wf_requiredPercent = wf_requiredApprovePercent;
                  wf_reviewerCount = bpm_assignees.size();
                  wf_actualPercent = ((wf_approveCount * 100) / wf_reviewerCount);
              </expression>
           </script>
        </event>
        <transition name="reject" to="rejected" />
        <transition name="approve" to="approved">
            <condition>#{wf_actualPercent >= wf_requiredApprovePercent}</condition>
        </transition>
    </decision>
               
    <task-node name="rejected">
        <task name="wf:rejectedParallelTask" swimlane="initiator" />
        <transition to="end" />
    </task-node>

    <task-node name="approved">
        <task name="wf:approvedParallelTask" swimlane="initiator" />
        <transition to="end" />
    </task-node>

    <end-state name="end"/>

</process-definition>
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Re: Email reviewers on parallel review workflow

ph73nt — Mon, 31 Jan 2011 10:30:52 GMT

Hi

Your "doSomething" transition doesn't do anything - but it has to go somewhere (hence transition null). I use transition to="review." Here's my whole process definition:


<?xml version="1.0" encoding="UTF-8"?>

<process-definition xmlns="urn:jbpm.org:jpdl-3.1" name="wf:parallelreview">

    <swimlane name="initiator" />

    <start-state name="start">
      <task name="wf:submitParallelReviewTask" swimlane="initiator" />
      <transition name="" to="startreview" />
   </start-state>

   <node name="startreview">
      <action class="org.alfresco.repo.workflow.jbpm.ForEachFork">
          <foreach>#{bpm_assignees}</foreach>
          <var>reviewer</var>
      </action>
      <event type="node-enter">
          <script>
              <variable name="wf_approveCount" access="write" />
              <expression>
                  wf_approveCount = 0;
              </expression>
          </script>
      </event>
      <transition name="review" to="review">
        <action class="org.alfresco.repo.workflow.jbpm.AlfrescoJavaScript">
            <script>
               var mail = actions.create("mail");
               mail.parameters.to = reviewer.properties.email;
               mail.parameters.subject ="Document for approval";
               mail.parameters.from = initiator.properties.email;
               mail.parameters.text =  mail.parameters.text = initiator.properties.firstName + " "
                               + initiator.properties.lastName
                               + " has requested a document review: "
                               + "\u000D\u000D"
                               + bpm_workflowDescription
                               + "\u000D\u000D"
                               + "Log on to Alfresco here: http://10.136.1.176:8080/share";
               mail.execute(bpm_package);
            </script>
        </action>
     </transition>
   </node>

    <task-node name="review">
        <task name="wf:reviewTask">
            <assignment class="org.alfresco.repo.workflow.jbpm.AlfrescoAssignment">
               <actor>#{reviewer}</actor>
            </assignment>
            <event type="task-create">
                <script>
                    if (bpm_workflowDueDate != void) taskInstance.dueDate = bpm_workflowDueDate;
                    if (bpm_workflowPriority != void) taskInstance.priority = bpm_workflowPriority;         
                </script>
            </event>
        </task>
        <transition name="approve" to="endreview">
          <action class="org.alfresco.repo.workflow.jbpm.AlfrescoJavaScript">
            <script>
              <variable name="wf_approveCount" access="read,write" />
                <expression>
                    wf_approveCount = wf_approveCount +1;
                 </expression>
            </script>
         </action>
            <script>

            </script>
        </transition>
        <transition name="reject" to="endreview" />
    </task-node>

    <join name="endreview">
        <transition to="isapproved" />
    </join>

    <decision name="isapproved">
        <event type="node-enter">
           <script>
              <variable name="wf_reviewerCount" access="write"/>
              <variable name="wf_requiredPercent" access="write"/>
              <variable name="wf_actualPercent" access="write"/>
              <expression>
                  wf_requiredPercent = wf_requiredApprovePercent;
                  wf_reviewerCount = bpm_assignees.size();
                  wf_actualPercent = ((wf_approveCount * 100) / wf_reviewerCount);
              </expression>
           </script>
        </event>
        <transition name="reject" to="rejected" />
        <transition name="approve" to="approved">
            <condition>#{wf_actualPercent >= wf_requiredApprovePercent}</condition>
        </transition>
    </decision>
               
    <task-node name="rejected">
        <task name="wf:rejectedParallelTask" swimlane="initiator" />
        <transition to="end" />
    </task-node>

    <task-node name="approved">
        <task name="wf:approvedParallelTask" swimlane="initiator" />
        <transition to="end" />
    </task-node>

    <end-state name="end"/>

</process-definition>
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Hope this helps and I hope I haven't left my email address in it (again). I found that process definitions started to make sense when I installed the Eclipse plugin (as in the wiki workflow page) as you get to draw yourself a process map first and then fill in the extra details later (like swimlane, scripts etc) so transitions take care of themselves.

Neil

Re: Email reviewers on parallel review workflow

mthomas — Mon, 31 Jan 2011 19:09:12 GMT

That does help, THANKS!
I also found that I could place the script in the "task-create" event.
My next attempt is to send an email notification when the task is reassigned. Do you know which file I edit to add the email script to the "reassign" button?

-Michael

Re: Email reviewers on parallel review workflow

ph73nt — Tue, 01 Feb 2011 14:54:48 GMT

I'm afraid not; I haven't yet got that far. I'd like to know the answer, though 🙂

Re: Email reviewers on parallel review workflow

mthomas — Tue, 01 Feb 2011 15:14:31 GMT

I posted the question here
http://forums.alfresco.com/en/viewtopic.php?f=34&t=37083