During the last few days I updated the Alfresco Process Services SDK in order to support the latest version 1.10 and improve the test suite. The first release of this project was published in June 2019 and the latest version released is APS SDK 1.1.0 and you can download it from the Github project.

What’s new in APS SDK 1.1.0

Added support for the latest APS version

I introduced Maven profiles for managing the different versions of dependencies for APS platform. A dedicated Maven profile is provided for each recent APS version to make easier any upgrade of your customizations and test it against another version in a quick way.

You can build your extensions using the following Maven command:

mvn clean package -Paps1.10

By default the project is configured for APS 1.9.0.5 using an active profile aps1.9, this means that running the following Maven command:

mvn clean package

It is equivalent of the following one:

mvn clean package -Paps1.9

Added support for running integration tests

The most important feature of this SDK is that you can implement and run your own unit tests but with the latest version you can also implement and run your own integration tests.

This will facilitate to cover the entire stack in terms of test execution. Considering to have custom REST endpoints, listeners, service tasks, email templates and so on, now you can test it from the REST API to the internal business logic.

Run your integration tests with the following command:

mvn clean integration-test

Extended 4-eyes principle example

The 4 eyes principle process included in the SDK was extended with new custom components taken from the official Alfresco documentation. In this latest version will find:

A 4 eyes principle app and process definition
Custom service task
Custom listener
Unit test for covering all the process steps (happy path)
Custom Enterprise REST endpoint (with authentication)
Custom REST endpoint (no authentication)
Integration test for the process and custom endpoints

4 eyes principle process definition diagram provided in APS SDK 1.1.0

Contributions

Contributions are welcome from the overall Alfresco community, don’t be shy, fork the project and contribute to make this SDK better and make great APS projects.

Special thanks to Carlo Cavallieri and Jessica Foroni for isolating the base integration test implementation.