FOUR-15859: On Process End - Start a request for another selected process

ProcessMaker/Http/Resources/Task.php

@@ -38,6 +38,7 @@ class Task extends ApiResource
         'interstitial',
         'userRequestPermission',
         'process',
+        'elementDestination',
     ];
 
     private $process = null;

ProcessMaker/Models/ProcessRequest.php

@@ -1057,9 +1057,9 @@ public function getProcessVersionAlternativeAttribute(): string | null
     /**
      * Retrieves the destination of the first closed end event.
      *
-     * @return ?string Returns a string value representing the element destination of the first closed end event.
+     * @return ?array Returns a string value representing the element destination of the first closed end event.
      */
-    public function getElementDestination(): ?string
+    public function getElementDestination(): ?array
     {
         $endEvents = $this->tokens()
             ->where('element_type', 'end_event')

ProcessMaker/Models/ProcessRequestToken.php

@@ -136,7 +136,6 @@ class ProcessRequestToken extends ProcessMakerModel implements TokenInterface
      */
     protected $appends = [
         'advanceStatus',
-        'elementDestination'
     ];
 
     /**
@@ -1196,13 +1195,14 @@ public function reassign($toUserId, User $requestingUser)
      * @param elementDestinationType Used to determine the type of destination for an element.
      * @param elementDestinationProp Used to determine the properties of the destination for an element.
      *
-     * @return string|null Returns the destination URL.
+     * @return array|null Returns the destination URL.
      */
-    private function getElementDestination($elementDestinationType, $elementDestinationProp): ?string
+    private function getElementDestination($elementDestinationType, $elementDestinationProp): ?array
     {
         $elementDestination = null;
 
         switch ($elementDestinationType) {
+            case 'anotherProcess':
             case 'customDashboard':
             case 'externalURL':
                 if (array_key_exists('value', $elementDestinationProp)) {
@@ -1227,7 +1227,7 @@ private function getElementDestination($elementDestinationType, $elementDestinat
             case 'processLaunchpad':
                 $elementDestination = route('process.browser.index', [
                     'process' => $this->process_id,
-                    'categorySelected' => -1
+                    'categorySelected' => -1,
                 ]);
                 break;
             case 'taskSource':
@@ -1236,18 +1236,20 @@ private function getElementDestination($elementDestinationType, $elementDestinat
             default:
                 $elementDestination = null;
                 break;
-
         }
 
-        return $elementDestination;
+        return [
+            'type' => $elementDestinationType,
+            'value' => $elementDestination,
+        ];
     }
 
     /**
      * Determines the destination URL based on the element destination type specified in the definition.
      *
-     * @return string|null
+     * @return array|null
      */
-    public function getElementDestinationAttribute(): ?string
+    public function getElementDestinationAttribute(): ?array
     {
         $definition = $this->getDefinition();
         $elementDestinationProp = $definition['elementDestination'] ?? null;

ProcessMaker/Traits/TaskResourceIncludes.php

@@ -6,6 +6,7 @@
 use ProcessMaker\Http\Resources\ScreenVersion as ScreenVersionResource;
 use ProcessMaker\Http\Resources\Users;
 use ProcessMaker\Managers\DataManager;
+use ProcessMaker\Models\ProcessRequestToken;
 use ProcessMaker\Models\TaskDraft;
 use ProcessMaker\ProcessTranslations\ProcessTranslation;
 use StdClass;
@@ -137,4 +138,16 @@ private function includeUserRequestPermission()
 
         return ['user_request_permission' => $userRequestPermission];
     }
+
+    /**
+     * Include the element destination in the resource response.
+     *
+     * @return array
+     */
+    private function includeElementDestination()
+    {
+        $elementDestination = $this->resource->getElementDestinationAttribute();
+
+        return ['elementDestination' => $elementDestination];
+    }
 }