Add due dates and claim time and claimed by to case and process instances (#4202)

* First batch of changes

* Update case instance and process instance due date and claim logic

* Add claim and unclaim to case and process instance REST endpoints

Author: tijsrademakers

modules/flowable-app-engine/src/main/resources/org/flowable/app/db/create/flowable.db2.create.app.sql

@@ -15,4 +15,4 @@ CREATE INDEX ACT_IDX_APP_DEF_DPLY ON ACT_APP_APPDEF(DEPLOYMENT_ID_);
 CREATE UNIQUE INDEX ACT_IDX_APP_DEF_UNIQ ON ACT_APP_APPDEF(KEY_, VERSION_, TENANT_ID_);
 
 insert into ACT_GE_PROPERTY
-values ('app.schema.version', '8.1.0.0', 1);
+values ('app.schema.version', '8.1.0.1', 1);

modules/flowable-app-engine/src/main/resources/org/flowable/app/db/create/flowable.h2.create.app.sql

@@ -15,4 +15,4 @@ CREATE INDEX ACT_IDX_APP_DEF_DPLY ON ACT_APP_APPDEF(DEPLOYMENT_ID_);
 CREATE UNIQUE INDEX ACT_IDX_APP_DEF_UNIQ ON ACT_APP_APPDEF(KEY_, VERSION_, TENANT_ID_);
 
 insert into ACT_GE_PROPERTY
-values ('app.schema.version', '8.1.0.0', 1);
+values ('app.schema.version', '8.1.0.1', 1);

modules/flowable-app-engine/src/main/resources/org/flowable/app/db/create/flowable.mssql.create.app.sql

@@ -15,4 +15,4 @@ CREATE NONCLUSTERED INDEX ACT_IDX_APP_DEF_DPLY ON ACT_APP_APPDEF(DEPLOYMENT_ID_)
 CREATE UNIQUE NONCLUSTERED INDEX ACT_IDX_APP_DEF_UNIQ ON ACT_APP_APPDEF(KEY_, VERSION_, TENANT_ID_);
 
 insert into ACT_GE_PROPERTY
-values ('app.schema.version', '8.1.0.0', 1);
+values ('app.schema.version', '8.1.0.1', 1);

modules/flowable-app-engine/src/main/resources/org/flowable/app/db/create/flowable.mysql.create.app.sql

@@ -17,4 +17,4 @@ ALTER TABLE ACT_APP_DEPLOYMENT MODIFY DEPLOY_TIME_ datetime(3);
 CREATE UNIQUE INDEX ACT_IDX_APP_DEF_UNIQ ON ACT_APP_APPDEF(KEY_, VERSION_, TENANT_ID_);
 
 insert into ACT_GE_PROPERTY
-values ('app.schema.version', '8.1.0.0', 1);
+values ('app.schema.version', '8.1.0.1', 1);

modules/flowable-app-engine/src/main/resources/org/flowable/app/db/create/flowable.oracle.create.app.sql

@@ -15,4 +15,4 @@ CREATE INDEX ACT_IDX_APP_DEF_DPLY ON ACT_APP_APPDEF(DEPLOYMENT_ID_);
 CREATE UNIQUE INDEX ACT_IDX_APP_DEF_UNIQ ON ACT_APP_APPDEF(KEY_, VERSION_, TENANT_ID_);
 
 insert into ACT_GE_PROPERTY
-values ('app.schema.version', '8.1.0.0', 1);
+values ('app.schema.version', '8.1.0.1', 1);

modules/flowable-app-engine/src/main/resources/org/flowable/app/db/create/flowable.postgres.create.app.sql

@@ -15,4 +15,4 @@ CREATE INDEX ACT_IDX_APP_DEF_DPLY ON ACT_APP_APPDEF(DEPLOYMENT_ID_);
 CREATE UNIQUE INDEX ACT_IDX_APP_DEF_UNIQ ON ACT_APP_APPDEF(KEY_, VERSION_, TENANT_ID_);
 
 insert into ACT_GE_PROPERTY
-values ('app.schema.version', '8.1.0.0', 1);
+values ('app.schema.version', '8.1.0.1', 1);

modules/flowable-app-engine/src/main/resources/org/flowable/app/db/upgrade/flowable.all.upgradestep.8100.to.8101.app.sql

@@ -0,0 +1 @@
+update ACT_GE_PROPERTY set VALUE_ = '8.1.0.1' where NAME_ = 'app.schema.version';

modules/flowable-cmmn-api/src/main/java/org/flowable/cmmn/api/CmmnRuntimeService.java

@@ -13,10 +13,12 @@
 package org.flowable.cmmn.api;
 
 import java.util.Collection;
+import java.util.Date;
 import java.util.List;
 import java.util.Map;
 
 import org.flowable.cmmn.api.runtime.CaseInstanceBuilder;
+import org.flowable.cmmn.api.runtime.CaseInstanceUpdateBuilder;
 import org.flowable.cmmn.api.runtime.CaseInstanceQuery;
 import org.flowable.cmmn.api.runtime.CaseInstanceStartEventSubscriptionBuilder;
 import org.flowable.cmmn.api.runtime.CaseInstanceStartEventSubscriptionDeletionBuilder;
@@ -50,6 +52,14 @@ public interface CmmnRuntimeService {
 
     CaseInstanceBuilder createCaseInstanceBuilder();
 
+    /**
+     * Create a {@link CaseInstanceUpdateBuilder}, that allows to update various properties of a case instance.
+     *
+     * @param caseInstanceId
+     *     id of the case instance to update, cannot be null
+     */
+    CaseInstanceUpdateBuilder createCaseInstanceUpdateBuilder(String caseInstanceId);
+
     PlanItemInstanceTransitionBuilder createPlanItemInstanceTransitionBuilder(String planItemInstanceId);
 
     void triggerPlanItemInstance(String planItemInstanceId);
@@ -421,6 +431,35 @@ public interface CmmnRuntimeService {
      */
     void updateBusinessStatus(String caseInstanceId, String businessStatus);
 
+    /**
+     * Sets the due date for the provided case instance.
+     *
+     * @param caseInstanceId
+     *     id of the case instance to set the due date, cannot be null
+     * @param dueDate
+     *     new due date value
+     */
+    void setCaseInstanceDueDate(String caseInstanceId, Date dueDate);
+
+    /**
+     * Claims the case instance by setting the given user as the assignee.
+     * When the case instance is already claimed by another user, an exception is thrown.
+     *
+     * @param caseInstanceId
+     *     id of the case instance to claim, cannot be null
+     * @param userId
+     *     user id of the user to claim the case instance
+     */
+    void claimCaseInstance(String caseInstanceId, String userId);
+
+    /**
+     * Unclaims the case instance by removing the assignee.
+     *
+     * @param caseInstanceId
+     *     id of the case instance to unclaim, cannot be null
+     */
+    void unclaimCaseInstance(String caseInstanceId);
+
     /**
      * Adds an event-listener which will be notified of ALL events by the dispatcher.
      *

modules/flowable-cmmn-api/src/main/java/org/flowable/cmmn/api/history/HistoricCaseInstance.java

@@ -40,6 +40,9 @@ public interface HistoricCaseInstance {
     String getCallbackType();
     String getReferenceId();
     String getReferenceType();
+    Date getDueDate();
+    Date getClaimTime();
+    String getClaimedBy();
     String getTenantId();
     String getEndUserId();
 

modules/flowable-cmmn-api/src/main/java/org/flowable/cmmn/api/runtime/CaseInstance.java

@@ -40,6 +40,9 @@ public interface CaseInstance {
     String getReferenceId();
     String getReferenceType();
     boolean isCompletable();
+    Date getDueDate();
+    Date getClaimTime();
+    String getClaimedBy();
     String getTenantId();
 
     /**