Camunda External Task Client (Java) 0.1.0-alpha1 Released

  • Blog
  • >
  • Camunda External Task Client (Java) 0.1.0-alpha1 Released

30 Day Free Trial

Bring together legacy systems, RPA bots, microservices and more with Camunda

Sign Up for Camunda Content

Get the latest on Camunda features, events, top trends, and more.


We are excited to release the first alpha of the Camunda External Task Client (Java).

A Workflow Engine typically calls Service Tasks actively. The Java client allows to break with this principle: remote and
independent Service Task workers continuously fetch tasks, perform the work and share the result with the Workflow Engine
once the work has been done.

The first preview version includes the following features:

  • Complete external tasks
  • Extend the lock duration of external tasks
  • Unlock external tasks
  • Report BPMN errors as well as failures
  • Share primitive and object typed process variables with the Workflow Engine


Let’s consider the following example to get a better understanding of how to use the Java client:

A Workflow of Granting Loans

Firstly, make sure that you have an up and running Camunda Workflow Engine.

Secondly, download and deploy the loan granting workflow to the Camunda Workflow Engine.

Next, create a Maven project and adjust the pom.xml by adding the following Maven coordinates:


Then create a main class and add the following lines to it:

// bootstrap the client
ExternalTaskClient client = ExternalTaskClient.create()

// subscribe to the topic
  .handler((externalTask, externalTaskService) -> {

    // retrieve a variable from the Workflow Engine
    int defaultScore = externalTask.getVariable("defaultScore");

    List<Integer> creditScores = 
      new ArrayList<>(Arrays.asList(defaultScore, 9, 1, 4, 10));

    // create an object typed variable
    ObjectValue creditScoresObject = Variables

    // set the recently created variable
    externalTask.setVariableTyped("creditScores", creditScoresObject);

    // complete the external task

    System.out.println("The External Task " + externalTask.getId() 
      + " has been completed!");


Thread.sleep(1000 * 60 * 5);

Finally, run the application. You should see the following output:

The External Task 1d375217-2cfe-11e8-96c2-769e8e30ca9b has been completed!
The External Task 0857150d-2cfe-11e8-96c2-769e8e30ca9b has been completed!

Now, you got a quick impression of how to use the Java client and how it behaves. This example can also be found
as a detailed step-by-step guide with all necessary project sources.

Please also see the documentation.

We are reliant on your feedback!
Feel free to share your ideas and suggestions with us in the forum.

Try All Features of Camunda

Related Content

Transition smoothly from design to implementation with an end-to-end business process. We'll show you how!
See how Funding Societies is taking advantage of process orchestration to automate their lending process, greatly improving outcomes for their customers.
Process blueprints can now be found on Camunda marketplace! Read on to learn how they can help you and how you can contribute.