. * * The interactive user interfaces in modified source and object code versions * of this program must display Appropriate Legal Notices, as required under * Section 5 of the GNU Affero General Public License version 3. * * In accordance with Section 7(b) of the GNU Affero General Public License version 3, * these Appropriate Legal Notices must retain the display of the "EspoCRM" word. ************************************************************************/ namespace Espo\Core\MassAction\Jobs; use Espo\Core\Job\Job; use Espo\Core\Job\Job\Data as JobData; use Espo\Core\MassAction\MassActionFactory; use Espo\Core\MassAction\Result; use Espo\Core\Utils\Language; use Espo\ORM\EntityManager; use Espo\Entities\MassAction as MassActionEntity; use Espo\Entities\Notification; use Espo\Entities\User; use RuntimeException; use Throwable; class Process implements Job { public const string PARAM_USER_SCOPES = 'userScopes'; public function __construct( private EntityManager $entityManager, private MassActionFactory $factory, private Language $language ) {} public function run(JobData $data): void { $id = $data->getTargetId(); if ($id === null) { throw new RuntimeException("ID not passed to the mass action job."); } $entity = $this->entityManager->getRDBRepositoryByClass(MassActionEntity::class)->getById($id); if (!$entity) { throw new RuntimeException("MassAction '$id' not found."); } $user = $this->getUser($entity, $data); $params = $entity->getParams(); try { $massAction = $this->factory->createForUser($entity->getAction(), $params->getEntityType(), $user); $this->setRunning($entity); $result = $massAction->process( $params, $entity->getData() ); } catch (Throwable $e) { $this->setFailed($entity); throw new RuntimeException("Mass action job error: " . $e->getMessage()); } $this->setSuccess($entity, $result); $this->entityManager->refreshEntity($entity); if ($entity->notifyOnFinish()) { $this->notifyFinish($entity); } } private function notifyFinish(MassActionEntity $entity): void { $notification = $this->entityManager->getRDBRepositoryByClass(Notification::class)->getNew(); $message = $this->language->translateLabel('massActionProcessed', 'messages'); $notification ->setType(Notification::TYPE_MESSAGE) ->setMessage($message) ->setUserId($entity->getCreatedBy()->getId()); $this->entityManager->saveEntity($notification); } private function setFailed(MassActionEntity $entity): void { $entity->setStatus(MassActionEntity::STATUS_FAILED); $this->entityManager->saveEntity($entity); } private function setRunning(MassActionEntity $entity): void { $entity->setStatus(MassActionEntity::STATUS_RUNNING); $this->entityManager->saveEntity($entity); } private function setSuccess(MassActionEntity $entity, Result $result): void { $entity ->setStatus(MassActionEntity::STATUS_SUCCESS) ->setProcessedCount($result->getCount()); $this->entityManager->saveEntity($entity); } private function getUser(MassActionEntity $entity, JobData $data): User { $user = $this->entityManager->getRDBRepositoryByClass(User::class)->getById($entity->getCreatedBy()->getId()); if (!$user) { throw new RuntimeException("MassAction '{$entity->getId()}', user not found."); } $userScopes = $data->get(self::PARAM_USER_SCOPES); if (is_array($userScopes)) { $user->setScopes($userScopes); } return $user; } }