maestro-3.0.1-rc2/src/Plugin/RulesAction/MaestroRulesActionSpawnWorkflow.php

<?php

namespace Drupal\maestro\Plugin\RulesAction;

use Drupal\Core\Entity\EntityInterface;
use Drupal\rules\Core\RulesActionBase;
use Drupal\maestro\Engine\MaestroEngine;

/**
 * Provides a 'Spawn Maestro Workflow' action.
 *
 * @RulesAction(
 *   id = "maestro_rules_spawn_workflow",
 *   label = @Translation("Spawn Maestro Workflow"),
 *   category = @Translation("Maestro"),
 *   context_definitions = {
 *     "template" = @ContextDefinition("string",
 *       label = @Translation("Maestro Template Machine Name"),
 *       description = @Translation("Specifies the Maestro Template's machine name you wish to spawn. You can find the machine name on the template listing. This is just a string value."),
 *       default_value = NULL,
 *       required = true
 *     ),
 *     "entity" = @ContextDefinition("entity",
 *       label = @Translation("Entity"),
 *       description = @Translation("Specifies the entity which should be attached to the workflow. Please use the data selector and choose the entity.  If this is a node, choose the 'node' data selector.")
 *     ),
 *   }
 * )
 */
class MaestroRulesActionSpawnWorkflow extends RulesActionBase {

  /**
   * Spawns a workflow.
   *
   * @param string $template
   *   The workflow template machine name you wish to spawn.
   * @param \Drupal\Core\Entity\EntityInterface $entity
   *   The entity that is being saved.
   */
  protected function doExecute($template = NULL, EntityInterface $entity = NULL) {
    if ($template !== NULL) {
      $engine = new MaestroEngine();
      $process_id = $engine->newProcess($template);
      if ($process_id) {
        $entity_id = current($entity->nid->getValue())['value'];
        $entity_bundle = current($entity->type->getValue())['target_id'];
        MaestroEngine::createEntityIdentifier($process_id, 'node', $entity_bundle, 'rules_added_entity', $entity_id);
      }
      else {
        // Error condition.  The process was unable to be kicked off.
        \Drupal::messenger()->addStatus(t('Unable to begin workflow.  Please check with administrator for more information.'));
      }

    }
  }

}