fix(openapi): add orQueries parameter to historic task instance query

related to CAM-13482

engine-rest/engine-rest-openapi/src/main/templates/lib/commons/history-task-instance-query-params.ftl

@@ -334,5 +334,19 @@
     "type": "boolean",
     "desc": "Only include tasks which have no candidate group. Value may only be `true`,
              as `false` is the default behavior."
+  },
+  "orQueries": {
+    "type": "array",
+    "dto": "HistoricTaskInstanceQueryDto",
+    "desc": "A JSON array of nested historic task instance queries with OR semantics.
+
+             A task instance matches a nested query if it fulfills at least one of the query's predicates.
+
+             With multiple nested queries, a task instance must fulfill at least one predicate of each query
+             ([Conjunctive Normal Form](https://en.wikipedia.org/wiki/Conjunctive_normal_form)).
+
+             All task instance query properties can be used except for: `sorting`, `withCandidateGroups`, ` withoutCandidateGroups`.
+
+             See the [User Guide](${docsUrl}/user-guide/process-engine/process-engine-api/#or-queries) for more information about OR queries."
   }
 }>

engine-rest/engine-rest-openapi/src/main/templates/paths/history/task/count/get.ftl

@@ -18,6 +18,7 @@
     <#include "/lib/commons/history-task-instance-query-params.ftl" >
     <@lib.parameters
         object = params
+        skip = ["orQueries"]  <#-- OR Queries not avaialble in GET -->
         last = last
     />
 

engine-rest/engine-rest-openapi/src/main/templates/paths/history/task/get.ftl

@@ -18,6 +18,7 @@
     <#include "/lib/commons/history-task-instance-query-params.ftl" >
     <@lib.parameters
         object = params
+        skip = ["orQueries"]  <#-- OR Queries not avaialble in GET -->
         last = last
     />
     <#include "/lib/commons/sort-params.ftl">