FOUR-26192 Add job validation and new scheduling method scheduleDateJob

ProcessMaker/Managers/TaskSchedulerManager.php

@@ -12,6 +12,7 @@
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Log;
 use Illuminate\Support\Facades\Schema;
+use InvalidArgumentException;
 use PDOException;
 use ProcessMaker\Facades\WorkflowManager;
 use ProcessMaker\Jobs\StartEventConditional;
@@ -574,6 +575,9 @@ public function scheduleCycle(
      */
     public function scheduleCycleJob($interval, array $config): ScheduledTask
     {
+        if (!isset($config['job'])) {
+            throw new InvalidArgumentException('$config["job"] is required');
+        }
         $configuration = [
             'type' => 'TimeCycle',
             'interval' => $interval,
@@ -590,6 +594,33 @@ public function scheduleCycleJob($interval, array $config): ScheduledTask
         return $scheduledTask;
     }
 
+    /**
+     * Schedule a job for a specific datetime
+     *
+     * @param string $datetime in ISO-8601 format
+     * @param array $config configuration
+     *
+     * @return ScheduledTask
+     */
+    public function scheduleDateJob($datetime, array $config): ScheduledTask
+    {
+        if (!isset($config['job'])) {
+            throw new InvalidArgumentException('$config["job"] is required');
+        }
+        $configuration = [
+            'type' => 'TimeDate',
+            'date' => $datetime,
+            ...$config,
+        ];
+        $scheduledTask = new ScheduledTask();
+        $scheduledTask->configuration = json_encode($configuration);
+        $scheduledTask->type = 'SCHEDULED_JOB';
+        $scheduledTask->last_execution = null;
+        $scheduledTask->save();
+
+        return $scheduledTask;
+    }
+
     /**
      * Schedule a job execution after a time duration for the given BPMN element,
      * event definition and an optional Token object