User Story (Required on creation):

In the Java External Task Client, I can access the exception code introduced with CAM-14083.

Functional Requirements (Required before implementation):

• All External Task operations (complete, lock, unlock, set variables, handle failures, handle bpmn error, extend lock) triggered in the client can lead to exceptions that should contain the exception code provided by the process engine.
• The error code is accessible when "fetch and lock" fails

Technical Requirements (Required before implementation):

• The API methods defined in org.camunda.bpm.client.task.ExternalTaskService trigger Engine REST API endpoints; when an operation fails, each of these methods can throw an exception. These exceptions should expose the exception code [1] that the engine produced.
• When a "fetch and lock" request fails and an ErrorAwareBackoffStrategy is configured, the error code can be retrieved from the exception.
• The feature is tested using integration tests under client/src/it.
• Docs
  • Javadocs exist.
  • Breaking changes and deprecation notices are documented in the migration guide.

Limitations of Scope (Optional):

-

Hints (optional):

The exception types in the client might benefit from being overhauled to make their semantics clear. E.g., NotResumedException and NotAcquiredException are thrown based on the HTTP status code that is also reused for other error situations.

[1] https://stage.docs.camunda.org/manual/develop/reference/rest/overview/#exception-codes