Learn how to create custom workflows for managing your editorial processes.This presentation covers Magnolia CMS process modelling and custom tasks, as well as how to implement a work item handler for executing custom tasks and configuring and putting the pieces together.

1. TASKS AND
WORKFLOW
AUGUST 28, 2014
Photo Credit:

2. ESPEN JERVIDALO
SENIOR SOFTWARE ENGINEER

3. AGENDA
!
Introduction
publication workflow
Tasks
Workflow
process modelling

4. MAGNOLIA 4.5
OpenWFE as workflow engine
Work Item Inbox
MAGNOLIA 4.5
OpenWFE as workflow engine
Work Item Inbox
OpenWFE discontinued
!
OpenWFE discontinued

5. WORKFLOW 5.0 - 5.2
jBPM 5
rudimentary integration
incremental fixes

6. WORKFLOW 5.3
bundled w/ Magnolia 5.2.x
jBPM 6
rewritten persistence, configuration simplified

7. NOTIFICATIONS
Similar to emails
What’s the status?
“Ooops I just deleted the message”

8. WORKFLOW 5.4
bundled w/ Magnolia 5.3
Introducing Tasks

9. DEMO

10. process jBPM engine
publication workflow
GOT IT?
Call Activity
processes
Work Item Handler
Human Task

11. .

12. TASKS
AWESOME

13. TASKS MODULE
completely self contained
CE Bundle

14. DEMO

15. Create a Task
!
!
Task task = new Task();
!
// this maps to your task definition
task.setName(“yourTask”);
!
// relevant data for e.g. displaying in the Pulse.
task.setContent(new HashMap() {{
.put(“some”, “data”)
}});
!
// set actors
task.setActorIds(“susan”, “peter”)
!
tasksManager.addTask(task);

16. Use TaskManger
!
/**
* Inject the TaskManager into your classes.
*/
@Inject
public MyClass(TasksManager tasksManager) {
this.taskManager = taskManager
}
!

17. Email Notifications
!
TaskEmailService implements TaskEventHandler {
!
@Inject
public(@Named(SystemEventBus.NAME) EventBus eventBus) {
eventBus.addHandler(TaskEvent.class, this);
}
!
@Override
public void taskResolved(TaskEvent taskEvent) {
// send email code goes here
}
!
…
}

18. THINK TASKS
Can I do XY with workflow?
We want to do XY with Workflow!

19. Photo Credit: flying time by Luke Ma
WORKFLOW

21. PROCESS BASICS

22. YOUR MODULE
Your starting point
Don’t use Magnolia’s modules

23. PROCESS
Start with a simple process
Learning by doing

24. public class LogWorkItemHandler implements WorkItemHandler {
!
private static final Logger log = LoggerFactory.getLogger(LogWorkItemHandler.class);
!
@Override
public void executeWorkItem(WorkItem workItem, WorkItemManager manager) {
String parameter = (String) workItem.getParameter("whatever");
!
log.error(parameter);
manager.completeWorkItem(workItem.getId(), new HashMap<String, Object>());
}
Work !
@Override
Item Handler
public void abortWorkItem(WorkItem workItem, WorkItemManager manager) {
!
}
}

25. THANK
YOU!

26. QUESTIONS?

27. RESOURCES
Magnolia’s Worflow documentation
Including tutorial in the Academy
http://documentation.magnolia-cms.com/display/DOCS/Workflow
!
Official jBPM documentation
!
Samples used in webinar available on Git:
http://git.magnolia-cms.com/git/forge/jbpm-email-sample.git
branch: webinar