Merge pull request #135 from itk-dev/feature/DW-568-inherit-session

DW-568: Added support for inheriting values without creating a submission

Author: rimi-itk

os2forms_forloeb.module

@@ -13,8 +13,10 @@ use Drupal\Core\Form\FormStateInterface;
 use Drupal\Core\Render\BubbleableMetadata;
 use Drupal\Core\Url;
 use Drupal\maestro\Engine\MaestroEngine;
+use Drupal\os2forms_forloeb\Plugin\EngineTasks\MaestroWebformInheritTask;
 use Drupal\webform\Entity\WebformSubmission;
 use Drupal\user\Entity\User;
+use Drupal\webform\WebformSubmissionInterface;
 
 /**
  * Implements hook_maestro_interactive_handlers().
@@ -343,3 +345,10 @@ function os2forms_forloeb_maestro_post_fetch_assigned_queue_tasks($userID, &$que
     $queueIDs = array_unique($queueIDs);
   }
 }
+
+/**
+ * Implements hook_ENTITY_TYPE_prepare_form().
+ */
+function os2forms_forloeb_webform_submission_prepare_form(WebformSubmissionInterface $webform_submission, string $operation, FormStateInterface $form_state) {
+  MaestroWebformInheritTask::webformSubmissionPrepareForm($webform_submission, $operation, $form_state);
+}

src/Plugin/EngineTasks/MaestroWebformInheritTask.php

@@ -9,6 +9,7 @@
 use Drupal\maestro\Form\MaestroExecuteInteractive;
 use Drupal\maestro\Engine\MaestroEngine;
 use Drupal\Core\Form\FormStateInterface;
+use Drupal\webform\WebformSubmissionInterface;
 use Symfony\Component\HttpFoundation\RedirectResponse;
 
 /**
@@ -74,6 +75,12 @@ public function getTaskEditForm(array $task, $templateMachineName) {
       '#default_value' => $task['data']['inherit_webform_unique_id'] ?? '',
       '#required' => TRUE,
     ];
+    $form['inherit_webform_create_submission'] = [
+      '#type' => 'checkbox',
+      '#title' => $this->t('Create submission'),
+      '#description' => $this->t('Create submission'),
+      '#default_value' => $task['data']['inherit_webform_create_submission'] ?? FALSE,
+    ];
     return $form;
   }
 
@@ -86,6 +93,7 @@ public function prepareTaskForSave(array &$form, FormStateInterface $form_state,
     parent::prepareTaskForSave($form, $form_state, $task);
     // Add custom field(s) to the inherited prepareTaskForSave method.
     $task['data']['inherit_webform_unique_id'] = $form_state->getValue('inherit_webform_unique_id');
+    $task['data']['inherit_webform_create_submission'] = $form_state->getValue('inherit_webform_create_submission');
   }
 
   /**
@@ -120,48 +128,121 @@ public function getExecutableForm($modal, MaestroExecuteInteractive $parent) {
     }
     // Now create webform submission, submit and attach to current process.
     $templateTask = MaestroEngine::getTemplateTaskByQueueID($this->queueID);
-    $taskUniqueSubmissionId = $templateTask['data']['unique_id'];
     $webformMachineName = $templateTask['data']['webform_machine_name'];
 
     $values = [];
     $values['webform_id'] = $webformMachineName;
     $values['data'] = $field_values;
 
-    // Create submission.
-    $new_submission = WebformSubmission::create($values);
+    $createSubmission = (bool) ($task['data']['inherit_webform_create_submission'] ?? FALSE);
+    if ($createSubmission) {
+      // Create submission.
+      $new_submission = WebformSubmission::create($values);
+
+      // Submit the webform submission.
+      $submission = WebformSubmissionForm::submitWebformSubmission($new_submission);
+
+      // WebformSubmissionForm::submitWebformSubmission returns an array
+      // if the submission is not valid.
+      if (is_array($submission)) {
+        \Drupal::logger('os2forms_forloeb')->error(
+          "Can't create new submission: " . json_encode($submission)
+        );
+        \Drupal::messenger()->addError('Webform data is invalid and could not be submitted.');
+        return FALSE;
+      }
 
-    // Submit the webform submission.
-    $submission = WebformSubmissionForm::submitWebformSubmission($new_submission);
+      $taskUniqueSubmissionId = $templateTask['data']['unique_id'];
 
-    // WebformSubmissionForm::submitWebformSubmission returns an array
-    // if the submission is not valid.
-    if (is_array($submission)) {
-      \Drupal::logger('os2forms_forloeb')->error(
-        "Can't create new submission: " . json_encode($submission)
+      // Attach it to the Maestro process.
+      $sid = $new_submission->id();
+      MaestroEngine::createEntityIdentifier(
+        $this->processID, $new_submission->getEntityTypeId(),
+        $new_submission->bundle(), $taskUniqueSubmissionId, $sid
       );
-      \Drupal::messenger()->addError('Webform data is invalid and could not be submitted.');
-      return FALSE;
-    }
 
-    // Attach it to the Maestro process.
-    $sid = $new_submission->id();
-    MaestroEngine::createEntityIdentifier(
-      $this->processID, $new_submission->getEntityTypeId(),
-      $new_submission->bundle(), $taskUniqueSubmissionId, $sid
-    );
-
-    $form = parent::getExecutableForm($modal, $parent);
-    // Catch os2forms-forloeb access token and pass it further.
-    if ($form instanceof RedirectResponse && $token = \Drupal::request()->query->get('os2forms-forloeb-ws-token')) {
-      // Check token to previous submission and update it to new one.
-      if ($token === $webform_submission->getToken()) {
-        $token = $new_submission->getToken();
-        $url = Url::fromUserInput($form->getTargetUrl(), ['query' => ['os2forms-forloeb-ws-token' => $token]]);
-        $form = new RedirectResponse($url->toString());
+      // Important: Apparently the form must be generated after calling
+      // MaestroEngine::createEntityIdentifier for this to work.
+      $form = parent::getExecutableForm($modal, $parent);
+      // Catch os2forms-forloeb access token and pass it further.
+      if ($form instanceof RedirectResponse && $token = \Drupal::request()->query->get('os2forms-forloeb-ws-token')) {
+        // Check token to previous submission and update it to new one.
+        if ($token === $webform_submission->getToken()) {
+          $token = $new_submission->getToken();
+          $url = Url::fromUserInput($form->getTargetUrl(), ['query' => ['os2forms-forloeb-ws-token' => $token]]);
+          $form = new RedirectResponse($url->toString());
+        }
       }
     }
+    else {
+      // Store values in session.
+      $values['processID'] = $this->processID;
+      $values['queueID'] = $this->queueID;
+      $values['webformInheritID'] = $webformInheritID;
+
+      self::setTaskValues($this->queueID, $values);
+
+      $form = parent::getExecutableForm($modal, $parent);
+    }
 
     return $form;
   }
 
+  /**
+   * Implements hook_ENTITY_TYPE_prepare_form().
+   */
+  public static function webformSubmissionPrepareForm(WebformSubmissionInterface $webformSubmission, string $operation, FormStateInterface $formState): void {
+    $request = \Drupal::request();
+    $isMaestro = (bool) $request->query->get('maestro', 0);
+    $queueID = (int) $request->query->get('queueid', 0);
+    if ($isMaestro && $queueID > 0) {
+      $values = self::getTaskValues($queueID);
+      if (isset($values['data'])) {
+        foreach ($values['data'] as $name => $value) {
+          $webformSubmission->setElementData($name, $value);
+        }
+      }
+    }
+  }
+
+  /**
+   * Get task values from session.
+   *
+   * @param int $queueID
+   *   The queue ID.
+   *
+   * @return array
+   *   The task values if any.
+   */
+  private static function getTaskValues($queueID) {
+    $sessionKey = self::formatTaskValuesSessionKey($queueID);
+    return \Drupal::request()->getSession()->get($sessionKey);
+  }
+
+  /**
+   * Set task values in session.
+   *
+   * @param int $queueID
+   *   The queue ID.
+   * @param array $values
+   *   The values.
+   */
+  private static function setTaskValues($queueID, array $values) {
+    $sessionKey = self::formatTaskValuesSessionKey($queueID);
+    \Drupal::request()->getSession()->set($sessionKey, $values);
+  }
+
+  /**
+   * Format task values session key.
+   *
+   * @param int $queueID
+   *   The queue ID.
+   *
+   * @return string
+   *   The formatted session key.
+   */
+  private static function formatTaskValuesSessionKey($queueID) {
+    return sprintf('os2forms_forloeb_inherited_values_%s', $queueID);
+  }
+
 }