This session starts with an overview of the custom action framework. Learn how to leverage Alfresco's action services to perform repeatable operations on your content. Understand Alfresco's built-in actions and discover how you can encapsulate your business logic in your own custom actions should you need to. Then you'll see how these software components can be reused on demand from the browser or automatically from folder rules, scheduled jobs and other sources. Finally you'll be brought fully up to date with recent feature development by Alfresco in this area.

1. Custom Action Framework 2 Neil Mc Erlean Ph.D. Senior Engineer, Alfresco twitter: @neilmcer

2. Custom Action Framework 3 Agenda Introduction features, capabilities recipe for custom action development Demo I - Dev Alfresco 3.4 action enhancements Demo II – ActionTrackingService Questions

3. Custom Action Framework 4 Introduction What is an action? Built-in actions. check-out create-thumbnail Parameters & conditions Composite actions [A]synchronous, persistable. Building blocks for app dev (e.g. RM module)

4. Action triggers 5 Programmatically from Java, JavaScript or over REST Action javaAction = actionService.createAction(name); javaAction.setParameterValue(“magicNumber”, 42); actionService.executeAction(javaAction, nodeRef); var jsAction = actions.create(name); jsAction.parameters[“magicNumber”] = 42; jsAction.execute(node); POST /api/actionQueue?async=true

5. The Action Services 6 Get Action Definitions Action Condition Definitions Parameter Constraints Create Action Action Condition Evaluate, Execute Actions ActionService Save Action Create Action (from saved node) public-services-context.xml action-services-context.xml RuntimeActionService

6. actionModel.xml (very abridged) 7 <type name="act:actionbase"> <associations> <child-association name="act:parameters”/> </associations> </type> <type name="act:action"> <parent>act:actionbase</parent> <properties> <property name="act:actionTitle”/> <property name="act:actionDescription”/> <property name="act:executeAsynchronously”/> <property name="act:runAsUser”/> </properties> <associations> <child-association name="act:conditions”/> <child-association name="act:compensatingAction”/> </associations> </type>

7. Writing a custom action 8 3 basic components

8. The Action Executer 9 abstract class ActionExecuterAbstractBase extends ParameterizedItemAbstractBase implements ActionExecuter { protected abstract void executeImpl(Action action, NodeRef actionedUponNodeRef); } public abstract class ParameterizedItemAbstractBase { protected abstract void addParameterDefinitions(List<ParameterDefinition> paramList); }

9. The resource file(s) 10 config/alfresco/messages/foo-config.properties {a}.title=My title {a}.description=My desc. {a}.{param-name}.display-label=My display label {a} is action bean name

10. Spring configuration 11 <beans> <bean id="imageWatermarkActionBase” class="org.alfresco.repo.watermarks.ImageWatermarkingAction" parent="action-executer"> </bean> <bean id="watermarkResourceBundles" class="org.springframework.extensions.surf.util.ResourceBundleBootstrapComponent"> <property name="resourceBundles"> <list> <value>alfresco.messages.watermark-config</value> </list> </property> </bean> </beans>

11. Custom Action Framework 12 Demo I – Watermarks and QR codes ?

12. What are QR codes? 13 QR codes 2-d barcode TM Denso Wave, Inc. ISO’d & license-free iPhone & Android apps Popular in Japan Appearing in Ireland. Hyperlinks for the physical world?

13. Using QR codes 14 How to Launch a “QR Reader” app Point your phone’s camera at the QR code Done :)

14. QR codes in the media 15

15. Demo I 16 Watermarks and QR codes

16. Architecture 17

17. Demo I ctd. 18 See Eclipse & Share UI watermarks-context.xml watermark-config.properties WatermarkPositioning.java ImageWatermarkingAction.java barcodes-context.xml QrCodeProvider.java

18. 19

19. 20

21. act:allowedExecutionstatuses 23 <constraint name="act:allowedExecutionstatuses” type="LIST"> <parameter name="allowedValues"> <list> <value>New</value> <value>Pending</value> <value>Running</value> <value>Completed</value> <value>Cancelled</value> <value>Failed</value> </list> </parameter> </constraint>

22. Running actions REST API 24 GET /api/running-actions? type={type?}&nodeRef={nodeRef?} GET /api/running-action/{action_tracking_id} POST /api/running-actions?nodeRef={nodeRef?} DELETE /api/running-action/{action_tracking_id}

23. Demo II 25 Action Tracking Service

24. Questions? 26 wiki.alfresco.com forums.alfresco.com issues.alfresco.com twitter: @neilmcer

25. 27 Shape & Color Palette Normal Text Normal Text Normal Text

26. 28