entities equip the RuleMatcher on the events they are aware of

Operations will receive the matcher instance

Signed-off-by: Arthur Schiwon <blizzz@arthur-schiwon.de>

2 files changed, 11 insertions, 3 deletions

diff --git a/lib/public/WorkflowEngine/IEntity.php b/lib/public/WorkflowEngine/IEntity.php
index 5ac1082a5a3..c08e9072a38 100644
--- a/lib/public/WorkflowEngine/IEntity.php
+++ b/lib/public/WorkflowEngine/IEntity.php
@@ -24,6 +24,8 @@ declare(strict_types=1);
 
 namespace OCP\WorkflowEngine;
 
+use Symfony\Component\EventDispatcher\GenericEvent;
+
 /**
  * Interface IEntity
  *
@@ -67,4 +69,9 @@ interface IEntity {
 	 */
 	public function getEvents(): array;
 
+	/**
+	 * @since 18.0.0
+	 */
+	public function prepareRuleMatcher(IRuleMatcher $ruleMatcher, string $eventName, GenericEvent $event): void;
+
 }
diff --git a/lib/public/WorkflowEngine/IOperation.php b/lib/public/WorkflowEngine/IOperation.php
index 8bba92351a2..d16fd618a84 100644
--- a/lib/public/WorkflowEngine/IOperation.php
+++ b/lib/public/WorkflowEngine/IOperation.php
@@ -91,12 +91,13 @@ interface IOperation {
 	 * Is being called by the workflow engine when an event was triggered that
 	 * is configured for this operation. An evaluation whether the event
 	 * qualifies for this operation to run has still to be done by the
-	 * implementor.
+	 * implementor by calling the RuleMatchers getMatchingOperations method
+	 * and evaluating the results.
 	 *
-	 * If the implementor is an IComplexOpe	ration, this method will not be
+	 * If the implementor is an IComplexOperation, this method will not be
 	 * called automatically. It can be used or left as no-op by the implementor.
 	 *
 	 * @since 18.0.0
 	 */
-	public function onEvent(string $eventName, GenericEvent $event): void;
+	public function onEvent(string $eventName, GenericEvent $event, IRuleMatcher $ruleMatcher): void;
 }