FOUR-24420 Add support to back tasks in the process

ProcessMaker/Http/Controllers/Api/V1_1/TaskController.php

@@ -14,6 +14,7 @@
 use ProcessMaker\Http\Resources\V1_1\TaskScreen;
 use ProcessMaker\Models\ProcessRequest;
 use ProcessMaker\Models\ProcessRequestToken;
+use ProcessMaker\Nayra\Contracts\Bpmn\ActivityInterface;
 use ProcessMaker\ProcessTranslations\TranslationManager;
 
 class TaskController extends Controller
@@ -151,4 +152,27 @@ public function showInterstitial($taskId)
 
         return $response;
     }
+
+    /**
+     * Move a token to a different task
+     * @param Request $request
+     * @param int $taskId
+     *
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function moveToken(Request $request, $taskId)
+    {
+        $task = ProcessRequestToken::findOrFail($taskId);
+        // find element id from process request
+        $targetTaskId = $request->input('target_task_id');
+        $defs = $task->processRequest->getVersionDefinitions();
+        $targetTask = $defs->getElementInstanceById($targetTaskId);
+        if (!($targetTask && $targetTask instanceof ActivityInterface)) {
+            return response()->json(['message' => 'Task not found'], 404);
+        }
+
+        $task->update(['element_id' => $targetTask->getId(), 'element_name' => $targetTask->getName()]);
+
+        return response()->json(['message' => 'Token moved successfully']);
+    }
 }

routes/v1_1/api.php

@@ -29,6 +29,10 @@
             // Route to show the interstitial screen of a task
             Route::get('/{taskId}/interstitial', [TaskController::class, 'showInterstitial'])
                 ->name('show.interstitial');
+
+            // Route to move a token to a different task
+            Route::post('/{taskId}/move', [TaskController::class, 'moveToken'])
+                ->name('move.token');
         });
 
         // Cases Endpoints