triggers = new Collection; $this->actions = new Collection; } /** * This method will make a Processor that will process each transaction journal using the triggers * and actions found in the given Rule. * * @param Rule $rule * * @return Processor */ public static function make(Rule $rule) { Log::debug(sprintf('Making new rule from Rule %d', $rule->id)); $self = new self; $self->rule = $rule; $triggerSet = $rule->ruleTriggers()->orderBy('order', 'ASC')->get(); /** @var RuleTrigger $trigger */ foreach ($triggerSet as $trigger) { $self->triggers->push(TriggerFactory::getTrigger($trigger)); } $self->actions = $rule->ruleActions()->orderBy('order', 'ASC')->get(); return $self; } /** * This method will make a Processor that will process each transaction journal using the given * trigger (singular!). It can only report if the transaction journal was hit by the given trigger * and will not be able to act on it using actions. * * @param string $triggerName * @param string $triggerValue * * @return Processor */ public static function makeFromString(string $triggerName, string $triggerValue) { Log::debug(sprintf('Processor::makeFromString("%s", "%s")', $triggerName, $triggerValue)); $self = new self; $trigger = TriggerFactory::makeTriggerFromStrings($triggerName, $triggerValue, false); $self->triggers->push($trigger); return $self; } /** * This method will make a Processor that will process each transaction journal using the given * triggers. It can only report if the transaction journal was hit by the given triggers * and will not be able to act on it using actions. * * The given triggers must be in the following format: * * [type => xx, value => yy, stopProcessing => bool], [type => xx, value => yy, stopProcessing => bool], * * @param array $triggers * * @return Processor */ public static function makeFromStringArray(array $triggers) { $self = new self; foreach ($triggers as $entry) { $trigger = TriggerFactory::makeTriggerFromStrings($entry['type'], $entry['value'], $entry['stopProcessing']); $self->triggers->push($trigger); } return $self; } /** * @return int */ public function getFoundTriggers(): int { return $this->foundTriggers; } /** * @param int $foundTriggers */ public function setFoundTriggers(int $foundTriggers) { $this->foundTriggers = $foundTriggers; } /** * * @return \FireflyIII\Models\Rule */ public function getRule(): Rule { return $this->rule; } /** * This method will scan the given transaction journal and check if it matches the triggers found in the Processor * If so, it will also attempt to run the given actions on the journal. It returns a bool indicating if the transaction journal * matches all of the triggers (regardless of whether the Processor could act on it). * * @param Transaction $transaction * * @return bool */ public function handleTransaction(Transaction $transaction): bool { Log::debug(sprintf('handleTransactionJournal for journal #%d (transaction #%d)', $transaction->transaction_journal_id, $transaction->id)); // grab the actual journal. $journal = $transaction->transactionJournal()->first(); $this->journal = $journal; // get all triggers: $triggered = $this->triggered(); if ($triggered) { if ($this->actions->count() > 0) { $this->actions(); } return true; } return false; } /** * This method will scan the given transaction journal and check if it matches the triggers found in the Processor * If so, it will also attempt to run the given actions on the journal. It returns a bool indicating if the transaction journal * matches all of the triggers (regardless of whether the Processor could act on it). * * @param TransactionJournal $journal * * @return bool */ public function handleTransactionJournal(TransactionJournal $journal): bool { Log::debug(sprintf('handleTransactionJournal for journal %d', $journal->id)); $this->journal = $journal; // get all triggers: $triggered = $this->triggered(); if ($triggered) { if ($this->actions->count() > 0) { $this->actions(); } return true; } return false; } /** * @return bool */ private function actions() { /** * @var int $index * @var RuleAction $action */ foreach ($this->actions as $action) { /** @var ActionInterface $actionClass */ $actionClass = ActionFactory::getAction($action); Log::debug(sprintf('Fire action %s on journal #%d', get_class($actionClass), $this->journal->id)); $actionClass->act($this->journal); if ($action->stop_processing) { Log::debug('Stop processing now and break.'); break; } } return true; } /** * Method to check whether the current transaction would be triggered * by the given list of triggers * * @return bool */ private function triggered(): bool { Log::debug('start of Processor::triggered()'); $foundTriggers = $this->getFoundTriggers(); $hitTriggers = 0; Log::debug(sprintf('Found triggers starts at %d', $foundTriggers)); /** @var AbstractTrigger $trigger */ foreach ($this->triggers as $trigger) { $foundTriggers++; Log::debug(sprintf('Now checking trigger %s with value %s', get_class($trigger), $trigger->getTriggerValue())); /** @var AbstractTrigger $trigger */ if ($trigger->triggered($this->journal)) { Log::debug('Is a match!'); $hitTriggers++; } if ($trigger->stopProcessing) { Log::debug('Stop processing this trigger and break.'); break; } } $result = ($hitTriggers == $foundTriggers && $foundTriggers > 0); Log::debug('Result of triggered()', ['hitTriggers' => $hitTriggers, 'foundTriggers' => $foundTriggers, 'result' => $result]); return $result; } }