feat(restAPI): add withJobsRetrying to rest and openAPI

engine-rest/engine-rest-openapi/src/main/templates/lib/commons/history-process-instance.ftl

@@ -113,6 +113,12 @@
     "desc": "Only include unfinished process instances. Value may only be `true`, as `false` is the default behavior."
   },
 
+  "withJobsRetrying": {
+    "type": "boolean",
+    "desc": "Only include process instances which are associated with jobs that have encountered exceptions and still
+     have retries left. Value may only be `true`, as `false` is the default behavior."
+  },
+
   "withIncidents": {
     "type": "boolean",
     "desc": "Only include process instances which have an incident. Value may only be `true`, as `false` is the default behavior."

engine-rest/engine-rest/src/main/java/org/camunda/bpm/engine/rest/dto/history/HistoricProcessInstanceQueryDto.java

@@ -85,6 +85,7 @@ public class HistoricProcessInstanceQueryDto extends AbstractQueryDto<HistoricPr
   private Boolean rootProcessInstances;
   private Boolean finished;
   private Boolean unfinished;
+  private Boolean withJobsRetrying;
   private Boolean withIncidents;
   private Boolean withRootIncidents;
   private String incidentType;
@@ -209,6 +210,11 @@ public void setUnfinished(Boolean unfinished) {
     this.unfinished = unfinished;
   }
 
+  @CamundaQueryParam(value = "withJobsRetrying", converter = BooleanConverter.class)
+  public void setWithJobsRetrying(Boolean withJobsRetrying) {
+    this.withJobsRetrying = withJobsRetrying;
+  }
+
   @CamundaQueryParam(value = "withIncidents", converter = BooleanConverter.class)
   public void setWithIncidents(Boolean withIncidents) {
     this.withIncidents = withIncidents;
@@ -449,6 +455,9 @@ protected void applyFilters(HistoricProcessInstanceQuery query) {
     if (unfinished != null && unfinished) {
       query.unfinished();
     }
+    if (withJobsRetrying != null && withJobsRetrying) {
+      query.withJobsRetrying();
+    }
     if (withIncidents != null && withIncidents) {
       query.withIncidents();
     }

engine-rest/engine-rest/src/test/java/org/camunda/bpm/engine/rest/history/HistoricProcessInstanceRestServiceQueryTest.java

@@ -793,6 +793,40 @@ public void testProcessQueryUnfinishedAsPost() {
     Assert.assertEquals(null, returnedEndTime);
   }
 
+  @Test
+  public void testQueryWithJobsRetrying() {
+    given()
+      .queryParam("withJobsRetrying", true)
+      .then()
+      .expect()
+      .statusCode(Status.OK.getStatusCode())
+      .when()
+      .get(HISTORIC_PROCESS_INSTANCE_RESOURCE_URL);
+
+    InOrder inOrder = inOrder(mockedQuery);
+    inOrder.verify(mockedQuery).withJobsRetrying();
+    inOrder.verify(mockedQuery).list();
+  }
+
+  @Test
+  public void testQueryWithJobsRetryingAsPost() {
+    Map<String, Boolean> body = new HashMap<String, Boolean>();
+    body.put("withJobsRetrying", true);
+
+    given()
+      .contentType(POST_JSON_CONTENT_TYPE)
+      .body(body)
+      .then()
+      .expect()
+      .statusCode(Status.OK.getStatusCode())
+      .when()
+      .post(HISTORIC_PROCESS_INSTANCE_RESOURCE_URL);
+
+    InOrder inOrder = inOrder(mockedQuery);
+    inOrder.verify(mockedQuery).withJobsRetrying();
+    inOrder.verify(mockedQuery).list();
+  }
+
   @Test
   public void testQueryWithIncidents() {
     given()