This repository has been archived on 2026-07-19. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
espocrm-base/application/Espo/Modules/Crm/Tools/Activities/Service.php
T
Yuri Kuznetsov befdff8085 ref
2022-10-16 14:25:52 +03:00

1458 lines
43 KiB
PHP

<?php
/************************************************************************
* This file is part of EspoCRM.
*
* EspoCRM - Open Source CRM application.
* Copyright (C) 2014-2022 Yurii Kuznietsov, Taras Machyshyn, Oleksii Avramenko
* Website: https://www.espocrm.com
*
* EspoCRM is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* EspoCRM is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with EspoCRM. If not, see http://www.gnu.org/licenses/.
*
* 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 General Public License version 3.
*
* In accordance with Section 7(b) of the GNU General Public License version 3,
* these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
************************************************************************/
namespace Espo\Modules\Crm\Tools\Activities;
use Espo\Core\Acl;
use Espo\Core\Exceptions\Error;
use Espo\Core\Exceptions\NotFound;
use Espo\Core\Exceptions\Forbidden;
use Espo\Core\ServiceFactory;
use Espo\Core\Utils\Config;
use Espo\Core\Utils\DateTime as DateTimeUtil;
use Espo\Core\Utils\Metadata;
use Espo\Entities\Email;
use Espo\Entities\Preferences;
use Espo\Entities\User;
use Espo\Modules\Crm\Entities\Account;
use Espo\Modules\Crm\Entities\Call;
use Espo\Modules\Crm\Entities\Contact;
use Espo\Modules\Crm\Entities\Lead;
use Espo\Modules\Crm\Entities\Meeting;
use Espo\Modules\Crm\Entities\Reminder;
use Espo\Modules\Crm\Entities\Task;
use Espo\ORM\EntityManager;
use Espo\ORM\Query\UnionBuilder;
use Espo\ORM\Query\SelectBuilder;
use Espo\ORM\Entity;
use Espo\ORM\Query\Select;
use Espo\ORM\Query\Part\Order;
use Espo\Core\Acl\Table;
use Espo\Core\Record\Collection as RecordCollection;
use Espo\Core\Select\SearchParams;
use Espo\Core\Select\Where\Item as WhereItem;
use Espo\Core\Select\Where\ConverterFactory as WhereConverterFactory;
use Espo\Core\Select\SelectBuilderFactory;
use Espo\Core\FieldProcessing\ListLoadProcessor;
use Espo\Core\FieldProcessing\Loader\Params as FieldLoaderParams;
use Espo\Core\Record\ServiceContainer as RecordServiceContainer;
use PDO;
use DateTime;
use stdClass;
class Service
{
private const UPCOMING_ACTIVITIES_FUTURE_DAYS = 1;
private const UPCOMING_ACTIVITIES_TASK_FUTURE_DAYS = 7;
private WhereConverterFactory $whereConverterFactory;
private ListLoadProcessor $listLoadProcessor;
private RecordServiceContainer $recordServiceContainer;
private SelectBuilderFactory $selectBuilderFactory;
private Config $config;
private Metadata $metadata;
private Acl $acl;
private ServiceFactory $serviceFactory;
private EntityManager $entityManager;
private User $user;
public function __construct(
WhereConverterFactory $whereConverterFactory,
ListLoadProcessor $listLoadProcessor,
RecordServiceContainer $recordServiceContainer,
SelectBuilderFactory $selectBuilderFactory,
Config $config,
Metadata $metadata,
Acl $acl,
ServiceFactory $serviceFactory,
EntityManager $entityManager,
User $user
) {
$this->whereConverterFactory = $whereConverterFactory;
$this->listLoadProcessor = $listLoadProcessor;
$this->recordServiceContainer = $recordServiceContainer;
$this->selectBuilderFactory = $selectBuilderFactory;
$this->config = $config;
$this->metadata = $metadata;
$this->acl = $acl;
$this->serviceFactory = $serviceFactory;
$this->entityManager = $entityManager;
$this->user = $user;
}
protected function isPerson(string $scope): bool
{
return
in_array(
$scope,
[Contact::ENTITY_TYPE, Lead::ENTITY_TYPE, User::ENTITY_TYPE]
) ||
$this->metadata->get(['scopes', $scope, 'type']) === 'Person';
}
protected function isCompany(string $scope): bool
{
return
in_array($scope, [Account::ENTITY_TYPE]) ||
$this->metadata->get(['scopes', $scope, 'type']) === 'Company';
}
/**
* @param string[] $statusList
*/
protected function getActivitiesUserMeetingQuery(User $entity, array $statusList = []): Select
{
$builder = $this->selectBuilderFactory
->create()
->from(Meeting::ENTITY_TYPE)
->withStrictAccessControl()
->buildQueryBuilder()
->select([
'id',
'name',
['dateStart', 'dateStart'],
['dateEnd', 'dateEnd'],
['dateStartDate', 'dateStartDate'],
['dateEndDate', 'dateEndDate'],
['"Meeting"', '_scope'],
'assignedUserId',
'assignedUserName',
'parentType',
'parentId',
'status',
'createdAt',
['""', 'hasAttachment'],
])
->leftJoin(
'MeetingUser',
'usersLeftMiddle',
[
'usersLeftMiddle.meetingId:' => 'meeting.id',
]
);
$where = [
'usersLeftMiddle.userId' => $entity->getId(),
];
if ($entity->isPortal() && $entity->get('contactId')) {
$where['contactsLeftMiddle.contactId'] = $entity->get('contactId');
$builder
->leftJoin('contacts', 'contactsLeft')
->distinct()
->where([
'OR' => $where,
]);
}
else {
$builder->where($where);
}
if (!empty($statusList)) {
$builder->where([
'status' => $statusList,
]);
}
return $builder->build();
}
/**
* @param string[] $statusList
*/
protected function getActivitiesUserCallQuery(User $entity, array $statusList = []): Select
{
$seed = $this->entityManager->getNewEntity(Call::ENTITY_TYPE);
$builder = $this->selectBuilderFactory
->create()
->from(Call::ENTITY_TYPE)
->withStrictAccessControl()
->buildQueryBuilder()
->select([
'id',
'name',
['dateStart', 'dateStart'],
['dateEnd', 'dateEnd'],
(
$seed->hasAttribute('dateStartDate') ?
['dateStartDate', 'dateStartDate'] : ['""', 'dateStartDate']
),
(
$seed->hasAttribute('dateEndDate') ?
['dateEndDate', 'dateEndDate'] : ['""', 'dateEndDate']
),
['"Call"', '_scope'],
'assignedUserId',
'assignedUserName',
'parentType',
'parentId',
'status',
'createdAt',
['""', 'hasAttachment'],
])
->leftJoin(
'CallUser',
'usersLeftMiddle',
[
'usersLeftMiddle.callId:' => 'call.id',
]
);
$where = [
'usersLeftMiddle.userId' => $entity->getId(),
];
if ($entity->isPortal() && $entity->get('contactId')) {
$where['contactsLeftMiddle.contactId'] = $entity->get('contactId');
$builder
->leftJoin('contacts', 'contactsLeft')
->distinct()
->where([
'OR' => $where,
]);
}
else {
$builder->where($where);
}
if (!empty($statusList)) {
$builder->where([
'status' => $statusList,
]);
}
return $builder->build();
}
/**
* @param string[] $statusList
* @return Select|Select[]
*/
protected function getActivitiesUserEmailQuery(User $entity, array $statusList = [])
{
if ($entity->isPortal() && $entity->get('contactId')) {
$contact = $this->entityManager->getEntity(Contact::ENTITY_TYPE, $entity->get('contactId'));
if ($contact) {
return $this->getActivitiesEmailQuery($contact, $statusList);
}
}
$builder = $this->selectBuilderFactory
->create()
->from(Email::ENTITY_TYPE)
->withStrictAccessControl()
->buildQueryBuilder()
->select([
'id',
'name',
['dateSent', 'dateStart'],
['""', 'dateEnd'],
['""', 'dateStartDate'],
['""', 'dateEndDate'],
['"Email"', '_scope'],
'assignedUserId',
'assignedUserName',
'parentType',
'parentId',
'status',
'createdAt',
'hasAttachment',
])
->leftJoin(
'EmailUser',
'usersLeftMiddle',
[
'usersLeftMiddle.emailId:' => 'email.id',
]
)
->where([
'usersLeftMiddle.userId' => $entity->getId(),
]);
if (!empty($statusList)) {
$builder->where([
'status' => $statusList,
]);
}
return $builder->build();
}
/**
* @param string[] $statusList
* @return Select|Select[]
*/
protected function getActivitiesMeetingOrCallQuery(
Entity $entity,
array $statusList,
string $targetEntityType
) {
$entityType = $entity->getEntityType();
$id = $entity->getId();
$methodName = 'getActivities' . $entityType . $targetEntityType . 'Query';
if (method_exists($this, $methodName)) {
return $this->$methodName($entity, $statusList);
}
$seed = $this->entityManager->getNewEntity($targetEntityType);
$baseBuilder = $this->selectBuilderFactory
->create()
->from($targetEntityType)
->withStrictAccessControl()
->buildQueryBuilder()
->select([
'id',
'name',
['dateStart', 'dateStart'],
['dateEnd', 'dateEnd'],
(
$seed->hasAttribute('dateStartDate') ?
['dateStartDate', 'dateStartDate'] : ['""', 'dateStartDate']
),
(
$seed->hasAttribute('dateEndDate') ?
['dateEndDate', 'dateEndDate'] : ['""', 'dateEndDate']
),
['"' . $targetEntityType . '"', '_scope'],
'assignedUserId',
'assignedUserName',
'parentType',
'parentId',
'status',
'createdAt',
['""', 'hasAttachment'],
]);
if (!empty($statusList)) {
$baseBuilder->where([
'status' => $statusList,
]);
}
$builder = clone $baseBuilder;
if ($entityType === Account::ENTITY_TYPE) {
$builder->where([
'OR' => [
[
'parentId' => $id,
'parentType' => Account::ENTITY_TYPE,
],
[
'accountId' => $id,
],
],
]);
}
else if ($entityType === Lead::ENTITY_TYPE && $entity->get('createdAccountId')) {
$builder->where([
'OR' => [
[
'parentId' => $id,
'parentType' => Lead::ENTITY_TYPE,
],
[
'accountId' => $entity->get('createdAccountId'),
],
],
]);
}
else {
$builder->where([
'parentId' => $id,
'parentType' => $entityType,
]);
}
if (!$this->isPerson($entityType)) {
return $builder->build();
}
$queryList = [$builder->build()];
$link = null;
switch ($entityType) {
case Contact::ENTITY_TYPE:
$link = 'contacts';
break;
case Lead::ENTITY_TYPE:
$link = 'leads';
break;
case User::ENTITY_TYPE:
$link = 'users';
break;
}
if (!$link) {
return $queryList;
}
$personBuilder = clone $baseBuilder;
$personBuilder
->join($link)
->where([
$link . '.id' => $id,
'OR' => [
'parentType!=' => $entityType,
'parentId!=' => $id,
'parentType' => null,
'parentId' => null,
],
]);
$queryList[] = $personBuilder->build();
return $queryList;
}
/**
* @param string[] $statusList
* @return Select|Select[]
*/
protected function getActivitiesMeetingQuery(Entity $entity, array $statusList = [])
{
return $this->getActivitiesMeetingOrCallQuery($entity, $statusList, Meeting::ENTITY_TYPE);
}
/**
* @param string[] $statusList
* @return Select|Select[]
*/
protected function getActivitiesCallQuery(Entity $entity, array $statusList = [])
{
return $this->getActivitiesMeetingOrCallQuery($entity, $statusList, Call::ENTITY_TYPE);
}
/**
* @param string[] $statusList
* @return Select|Select[]
*/
protected function getActivitiesEmailQuery(Entity $entity, array $statusList = [])
{
$entityType = $entity->getEntityType();
$id = $entity->getId();
$methodName = 'getActivities' . $entityType . 'EmailQuery';
if (method_exists($this, $methodName)) {
return $this->$methodName($entity, $statusList);
}
$baseBuilder = $this->selectBuilderFactory
->create()
->from('Email')
->withStrictAccessControl()
->buildQueryBuilder()
->select([
'id',
'name',
['dateSent', 'dateStart'],
['""', 'dateEnd'],
['""', 'dateStartDate'],
['""', 'dateEndDate'],
['"Email"', '_scope'],
'assignedUserId',
'assignedUserName',
'parentType',
'parentId',
'status',
'createdAt',
'hasAttachment',
]);
if (!empty($statusList)) {
$baseBuilder->where([
'status' => $statusList,
]);
}
$builder = clone $baseBuilder;
if ($entityType === Account::ENTITY_TYPE) {
$builder->where([
'OR' => [
[
'parentId' => $id,
'parentType' => Account::ENTITY_TYPE,
],
[
'accountId' => $id,
],
],
]);
}
else if ($entityType == 'Lead' && $entity->get('createdAccountId')) {
$builder->where([
'OR' => [
[
'parentId' => $id,
'parentType' => Lead::ENTITY_TYPE,
],
[
'accountId' => $entity->get('createdAccountId'),
],
],
]);
}
else {
$builder->where([
'parentId' => $id,
'parentType' => $entityType,
]);
}
if (!$this->isPerson($entityType) && !$this->isCompany($entityType)) {
return $builder->build();
}
$queryList = [$builder->build()];
$personBuilder = clone $baseBuilder;
$personBuilder
->leftJoin(
'EntityEmailAddress',
'eea',
[
'eea.emailAddressId:' => 'fromEmailAddressId',
'eea.entityType' => $entityType,
'eea.deleted' => false,
]
)
->where([
'OR' => [
'parentType!=' => $entityType,
'parentId!=' => $id,
'parentType' => null,
'parentId' => null,
],
'eea.entityId' => $id,
]);
$queryList[] = $personBuilder->build();
$addressBuilder = clone $baseBuilder;
$addressBuilder
->leftJoin(
'EmailEmailAddress',
'em',
[
'em.emailId:' => 'id',
'em.deleted' => false,
]
)
->leftJoin(
'EntityEmailAddress',
'eea',
[
'eea.emailAddressId:' => 'em.emailAddressId',
'eea.entityType' => $entityType,
'eea.deleted' => 0,
]
)
->where([
'OR' => [
'parentType!=' => $entityType,
'parentId!=' => $id,
'parentType' => null,
'parentId' => null,
],
'eea.entityId' => $id,
]);
$queryList[] = $addressBuilder->build();
return $queryList;
}
/**
* @param array<string,Select|array<string,mixed>> $parts
* @param array{
* scope?: ?string,
* offset?: ?int,
* maxSize?: ?int,
* } $params
* @return array{
* list: array<string,mixed>[],
* total: int,
* }
*/
protected function getResultFromQueryParts(array $parts, string $scope, array $params): array
{
if (empty($parts)) {
return [
'list' => [],
'total' => 0,
];
}
$onlyScope = false;
if (!empty($params['scope'])) {
$onlyScope = $params['scope'];
}
$maxSize = $params['maxSize'] ?? null;
$queryList = [];
if (!$onlyScope) {
foreach ($parts as $part) {
if (is_array($part)) {
$queryList = array_merge($queryList, $part);
} else {
$queryList[] = $part;
}
}
} else {
$part = $parts[$onlyScope];
if (is_array($part)) {
$queryList = array_merge($queryList, $part);
} else {
$queryList[] = $part;
}
}
$maxSizeQ = $maxSize;
$offset = $params['offset'] ?? 0;
if (!$onlyScope && $scope === User::ENTITY_TYPE) {
// optimizing sub-queries
$newQueryList = [];
foreach ($queryList as $query) {
$subBuilder = $this->entityManager
->getQueryBuilder()
->select()
->clone($query);
if ($maxSize) {
$subBuilder->limit(0, $offset + $maxSize + 1);
}
// Order by `dateStart`.
$subBuilder->order(
Order
::create(
$query->getSelect()[2]->getExpression()
)
->withDesc()
);
$newQueryList[] = $subBuilder->build();
}
$queryList = $newQueryList;
}
$builder = $this->entityManager->getQueryBuilder()
->union();
foreach ($queryList as $query) {
$builder->query($query);
}
$totalCount = -2;
if ($scope !== User::ENTITY_TYPE) {
$countQuery = $this->entityManager->getQueryBuilder()
->select()
->fromQuery($builder->build(), 'c')
->select('COUNT:(c.id)', 'count')
->build();
$sth = $this->entityManager->getQueryExecutor()->execute($countQuery);
$row = $sth->fetch(PDO::FETCH_ASSOC);
$totalCount = $row['count'];
}
$builder->order('dateStart', 'DESC');
if ($scope === User::ENTITY_TYPE) {
$maxSizeQ++;
} else {
$builder->order('createdAt', 'DESC');
}
if ($maxSize) {
$builder->limit($offset, $maxSizeQ);
}
$unionQuery = $builder->build();
$sth = $this->entityManager->getQueryExecutor()->execute($unionQuery);
$rowList = $sth->fetchAll(PDO::FETCH_ASSOC) ?: [];
$boolAttributeList = ['hasAttachment'];
$list = [];
foreach ($rowList as $row) {
foreach ($boolAttributeList as $attribute) {
if (!array_key_exists($attribute, $row)) {
continue;
}
$row[$attribute] = $row[$attribute] == '1' ? true : false;
}
$list[] = $row;
}
if ($scope === User::ENTITY_TYPE) {
if ($maxSize && count($list) > $maxSize) {
$totalCount = -1;
unset($list[count($list) - 1]);
}
}
return [
'list' => $list,
'total' => $totalCount,
];
}
/**
* @throws Forbidden
*/
protected function accessCheck(Entity $entity): void
{
if ($entity instanceof User) {
if (!$this->acl->checkUserPermission($entity, 'user')) {
throw new Forbidden();
}
return;
}
if (!$this->acl->check($entity, Table::ACTION_READ)) {
throw new Forbidden();
}
}
/**
* @return RecordCollection<Entity>
* @throws Forbidden
* @throws NotFound
* @throws Error
*/
public function findActivitiesEntityType(
string $scope,
string $id,
string $entityType,
bool $isHistory,
SearchParams $searchParams
): RecordCollection {
if (!$this->acl->checkScope($entityType)) {
throw new Forbidden();
}
$entity = $this->entityManager->getEntity($scope, $id);
if (!$entity) {
throw new NotFound();
}
$this->accessCheck($entity);
if (!$this->metadata->get(['scopes', $entityType, 'activity'])) {
throw new Error("Entity '{$entityType}' is not an activity.");
}
if (!$isHistory) {
$statusList = $this->metadata->get(['scopes', $entityType, 'activityStatusList']) ??
[Meeting::STATUS_PLANNED];
}
else {
$statusList = $this->metadata->get(['scopes', $entityType, 'historyStatusList']) ??
[Meeting::STATUS_HELD, Meeting::STATUS_NOT_HELD];
}
if ($entityType === Email::ENTITY_TYPE && $searchParams->getOrderBy() === 'dateStart') {
$searchParams = $searchParams->withOrderBy('dateSent');
}
$service = $this->recordServiceContainer->get($entityType);
$preparedSearchParams = $service->prepareSearchParams($searchParams);
$offset = $searchParams->getOffset();
$limit = $searchParams->getMaxSize();
$baseQueryList = $this->getActivitiesQuery($entity, $entityType, $statusList);
if (!is_array($baseQueryList)) {
$baseQueryList = [$baseQueryList];
}
$queryList = [];
$order = null;
foreach ($baseQueryList as $i => $itemQuery) {
$itemBuilder = $this->selectBuilderFactory
->create()
->clone($itemQuery)
->withSearchParams($preparedSearchParams)
->withComplexExpressionsForbidden()
->withWherePermissionCheck()
->buildQueryBuilder();
if ($i === 0) {
$order = $itemBuilder->build()->getOrder();
}
$itemBuilder
->limit(null, null)
->order([]);
$queryList[] = $itemBuilder->build();
}
$query = $queryList[0];
if (count($queryList) > 1) {
$unionBuilder = $this->entityManager
->getQueryBuilder()
->union();
foreach ($queryList as $subQuery) {
$unionBuilder->query($subQuery);
}
if ($order !== null && count($order)) {
$unionBuilder->order(
$order[0]->getExpression()->getValue(),
$order[0]->getDirection()
);
}
$query = $unionBuilder->build();
}
/** @var UnionBuilder|SelectBuilder $builder */
$builder = $this->entityManager
->getQueryBuilder()
->clone($query);
if ($order && count($queryList) === 1) {
$builder->order($order);
}
$builder->limit($offset, $limit);
$sql = $this->entityManager->getQueryComposer()->compose($builder->build());
$collection = $this->entityManager
->getCollectionFactory()
->createFromSthCollection(
$this->entityManager
->getRDBRepository($entityType)
->findBySql($sql)
);
$loadProcessorParams = FieldLoaderParams
::create()
->withSelect($searchParams->getSelect());
foreach ($collection as $e) {
$this->listLoadProcessor->process($e, $loadProcessorParams);
$service->prepareEntityForOutput($e);
}
$countQuery = $this->entityManager->getQueryBuilder()
->select()
->fromQuery($query, 'c')
->select('COUNT:(c.id)', 'count')
->build();
$sth = $this->entityManager->getQueryExecutor()->execute($countQuery);
$row = $sth->fetch(PDO::FETCH_ASSOC);
$total = $row['count'];
return new RecordCollection($collection, $total);
}
/**
* @param array{
* scope?: ?string,
* offset?: ?int,
* maxSize?: ?int,
* } $params
* @return array{
* list: array<string,mixed>[],
* total: int,
* }
* @throws NotFound
* @throws Error
* @throws Forbidden
*/
public function getActivities(string $scope, string $id, array $params = []): array
{
$entity = $this->entityManager->getEntity($scope, $id);
if (!$entity) {
throw new NotFound();
}
$this->accessCheck($entity);
$targetScope = $params['scope'] ?? null;
$fetchAll = empty($targetScope);
if ($targetScope) {
if (!$this->metadata->get(['scopes', $targetScope, 'activity'])) {
throw new Error('Entity \'' . $targetScope . '\' is not an activity');
}
}
$parts = [];
/** @var string[] $entityTypeList */
$entityTypeList = $this->config->get('activitiesEntityList') ??
[Meeting::ENTITY_TYPE, Call::ENTITY_TYPE];
foreach ($entityTypeList as $entityType) {
if (!$fetchAll && $targetScope !== $entityType) {
continue;
}
if (!$this->acl->checkScope($entityType)) {
continue;
}
if (!$this->metadata->get('scopes.' . $entityType . '.activity')) {
continue;
}
$statusList = $this->metadata->get(['scopes', $entityType, 'activityStatusList']) ??
[Meeting::STATUS_PLANNED];
$parts[$entityType] = $this->getActivitiesQuery($entity, $entityType, $statusList);
}
return $this->getResultFromQueryParts($parts, $scope, $params);
}
/**
* @param array{
* scope?: ?string,
* offset?: ?int,
* maxSize?: ?int,
* } $params
* @return array{
* list: array<string,mixed>[],
* total: int,
* }
* @throws NotFound
* @throws Error
* @throws Forbidden
*/
public function getHistory(string $scope, string $id, array $params = []): array
{
$entity = $this->entityManager->getEntity($scope, $id);
if (!$entity) {
throw new NotFound();
}
$this->accessCheck($entity);
$targetScope = $params['scope'] ?? null;
$fetchAll = empty($targetScope);
if ($targetScope) {
if (!$this->metadata->get(['scopes', $targetScope, 'activity'])) {
throw new Error('Entity \'' . $targetScope . '\' is not an activity');
}
}
$parts = [];
/** @var string[] $entityTypeList */
$entityTypeList = $this->config->get('historyEntityList') ??
[
Meeting::ENTITY_TYPE,
Call::ENTITY_TYPE,
Email::ENTITY_TYPE
];
foreach ($entityTypeList as $entityType) {
if (!$fetchAll && $targetScope !== $entityType) {
continue;
}
if (!$this->acl->checkScope($entityType)) {
continue;
}
if (!$this->metadata->get('scopes.' . $entityType . '.activity')) {
continue;
}
$statusList = $this->metadata->get(['scopes', $entityType, 'historyStatusList']) ??
[Meeting::STATUS_HELD, Meeting::STATUS_NOT_HELD];
$parts[$entityType] = $this->getActivitiesQuery($entity, $entityType, $statusList);
}
$result = $this->getResultFromQueryParts($parts, $scope, $params);
foreach ($result['list'] as &$item) {
if ($item['_scope'] === Email::ENTITY_TYPE) {
$item['dateSent'] = $item['dateStart'];
}
}
return $result;
}
/**
* @param string[] $statusList
* @return Select|Select[]
*/
protected function getActivitiesQuery(Entity $entity, string $scope, array $statusList = [])
{
$serviceName = 'Activities' . $entity->getEntityType();
if ($this->serviceFactory->checkExists($serviceName)) {
$service = $this->serviceFactory->create($serviceName);
$methodName = 'getActivities' . $scope . 'Query';
if (method_exists($service, $methodName)) {
return $service->$methodName($entity, $statusList);
}
}
$methodName = 'getActivities' . $scope . 'Query';
if (method_exists($this, $methodName)) {
return $this->$methodName($entity, $statusList);
}
return $this->getActivitiesBaseQuery($entity, $scope, $statusList);
}
/**
* @param string[] $statusList
*/
protected function getActivitiesBaseQuery(Entity $entity, string $scope, array $statusList = []): Select
{
$seed = $this->entityManager->getNewEntity($scope);
$builder = $this->selectBuilderFactory
->create()
->from($scope)
->withStrictAccessControl()
->buildQueryBuilder()
->select([
'id',
'name',
($seed->hasAttribute('dateStart') ? ['dateStart', 'dateStart'] : ['""', 'dateStart']),
($seed->hasAttribute('dateEnd') ? ['dateEnd', 'dateEnd'] : ['""', 'dateEnd']),
($seed->hasAttribute('dateStartDate') ?
['dateStartDate', 'dateStartDate'] : ['""', 'dateStartDate']),
($seed->hasAttribute('dateEndDate') ?
['dateEndDate', 'dateEndDate'] : ['""', 'dateEndDate']),
['"' . $scope . '"', '_scope'],
($seed->hasAttribute('assignedUserId') ?
['assignedUserId', 'assignedUserId'] : ['""', 'assignedUserId']),
($seed->hasAttribute('assignedUserName') ? ['assignedUserName', 'assignedUserName'] :
['""', 'assignedUserName']),
($seed->hasAttribute('parentType') ? ['parentType', 'parentType'] : ['""', 'parentType']),
($seed->hasAttribute('parentId') ? ['parentId', 'parentId'] : ['""', 'parentId']),
'status',
'createdAt',
['""', 'hasAttachment'],
]);
if ($entity->getEntityType() === User::ENTITY_TYPE) {
$builder->where([
'assignedUserId' => $entity->getId(),
]);
}
else {
$builder->where([
'parentId' => $entity->getId(),
'parentType' => $entity->getEntityType(),
]);
}
$builder->where([
'status' => $statusList,
]);
return $builder->build();
}
public function removeReminder(string $id): void
{
$builder = $this->entityManager
->getQueryBuilder()
->delete()
->from(Reminder::ENTITY_TYPE)
->where([
'id' => $id,
]);
if (!$this->user->isAdmin()) {
$builder->where([
'userId' => $this->user->getId(),
]);
}
$deleteQuery = $builder->build();
$this->entityManager->getQueryExecutor()->execute($deleteQuery);
}
/**
* @param array{
* offset?: ?int,
* maxSize?: ?int,
* } $params
* @param ?string[] $entityTypeList
* @return array{
* total: int,
* list: stdClass[],
* }
* @throws Forbidden
* @throws NotFound
*/
public function getUpcomingActivities(
string $userId,
array $params = [],
?array $entityTypeList = null,
?int $futureDays = null
): array {
$user = $this->entityManager->getEntityById(User::ENTITY_TYPE, $userId);
if (!$user) {
throw new NotFound();
}
$this->accessCheck($user);
if (!$entityTypeList) {
$entityTypeList = $this->config->get('activitiesEntityList', []);
}
if (is_null($futureDays)) {
$futureDays = $this->config->get(
'activitiesUpcomingFutureDays',
self::UPCOMING_ACTIVITIES_FUTURE_DAYS
);
}
$queryList = [];
foreach ($entityTypeList as $entityType) {
if (
!$this->metadata->get(['scopes', $entityType, 'activity']) &&
$entityType !== Task::ENTITY_TYPE
) {
continue;
}
if (!$this->acl->checkScope($entityType, 'read')) {
continue;
}
if (!$this->metadata->get(['entityDefs', $entityType, 'fields', 'dateStart'])) {
continue;
}
if (!$this->metadata->get(['entityDefs', $entityType, 'fields', 'dateEnd'])) {
continue;
}
$queryList[] = $this->getUpcomingActivitiesEntityTypeQuery($entityType, $params, $user, $futureDays);
}
if (empty($queryList)) {
return [
'total' => 0,
'list' => [],
];
}
$builder = $this->entityManager
->getQueryBuilder()
->union();
foreach ($queryList as $query) {
$builder->query($query);
}
$unionCountQuery = $builder->build();
$countQuery = $this->entityManager->getQueryBuilder()
->select()
->fromQuery($unionCountQuery, 'c')
->select('COUNT:(c.id)', 'count')
->build();
$countSth = $this->entityManager->getQueryExecutor()->execute($countQuery);
$row = $countSth->fetch(PDO::FETCH_ASSOC);
$totalCount = $row['count'];
$offset = intval($params['offset'] ?? 0);
$maxSize = intval($params['maxSize'] ?? 0);
$unionQuery = $builder
->order('dateStart')
->order('dateEnd')
->order('name')
->limit($offset, $maxSize)
->build();
$sth = $this->entityManager->getQueryExecutor()->execute($unionQuery);
$rows = $sth->fetchAll(PDO::FETCH_ASSOC) ?: [];
$entityDataList = [];
foreach ($rows as $row) {
$entity = $this->entityManager->getEntity($row['entityType'], $row['id']);
if (!$entity) {
$entity = $this->entityManager->getNewEntity($row['entityType']);
$entity->set('id', $row['id']);
}
$entityData = $entity->getValueMap();
$entityData->_scope = $entity->getEntityType();
$entityDataList[] = $entityData;
}
return [
'total' => $totalCount,
'list' => $entityDataList,
];
}
/**
* @param array<string,mixed> $params
*/
protected function getUpcomingActivitiesEntityTypeQuery(
string $entityType,
array $params,
User $user,
int $futureDays
): Select {
$beforeString = (new DateTime())
->modify('+' . $futureDays . ' days')
->format(DateTimeUtil::SYSTEM_DATE_TIME_FORMAT);
$builder = $this->selectBuilderFactory
->create()
->from($entityType)
->forUser($user)
->withBoolFilter('onlyMy')
->withStrictAccessControl();
$primaryFilter = 'planned';
if ($entityType === Task::ENTITY_TYPE) {
$primaryFilter = 'actual';
}
$builder->withPrimaryFilter($primaryFilter);
if (!empty($params['textFilter'])) {
$builder->withTextFilter($params['textFilter']);
}
$queryBuilder = $builder->buildQueryBuilder();
$converter = $this->whereConverterFactory->create($entityType, $user);
$timeZone = $this->getUserTimeZone($user);
if ($entityType === Task::ENTITY_TYPE) {
$upcomingTaskFutureDays = $this->config->get(
'activitiesUpcomingTaskFutureDays',
self::UPCOMING_ACTIVITIES_TASK_FUTURE_DAYS
);
$taskBeforeString = (new DateTime())
->modify('+' . $upcomingTaskFutureDays . ' days')
->format(DateTimeUtil::SYSTEM_DATE_TIME_FORMAT);
$queryBuilder->where([
'OR' => [
[
'dateStart' => null,
'OR' => [
'dateEnd' => null,
$converter->convert(
$queryBuilder,
WhereItem::fromRaw([
'type' => 'before',
'attribute' => 'dateEnd',
'value' => $taskBeforeString,
'timeZone' => $timeZone,
])
)->getRaw()
]
],
[
'dateStart!=' => null,
'OR' => [
$converter->convert(
$queryBuilder,
WhereItem::fromRaw([
'type' => 'past',
'attribute' => 'dateStart',
'timeZone' => $timeZone,
])
)->getRaw(),
$converter->convert(
$queryBuilder,
WhereItem::fromRaw([
'type' => 'today',
'attribute' => 'dateStart',
'timeZone' => $timeZone,
])
)->getRaw(),
$converter->convert(
$queryBuilder,
WhereItem::fromRaw([
'type' => 'before',
'attribute' => 'dateStart',
'value' => $beforeString,
'timeZone' => $timeZone,
])
)->getRaw(),
]
],
],
]);
}
else {
$queryBuilder->where([
'OR' => [
$converter->convert(
$queryBuilder,
WhereItem::fromRaw([
'type' => 'today',
'attribute' => 'dateStart',
'timeZone' => $timeZone,
])
)->getRaw(),
[
$converter->convert(
$queryBuilder,
WhereItem::fromRaw([
'type' => 'future',
'attribute' => 'dateEnd',
'timeZone' => $timeZone,
])
)->getRaw(),
$converter->convert(
$queryBuilder,
WhereItem::fromRaw([
'type' => 'before',
'attribute' => 'dateStart',
'value' => $beforeString,
'timeZone' => $timeZone,
])
)->getRaw(),
],
],
]);
}
$queryBuilder->select([
'id',
'name',
'dateStart',
'dateEnd',
['"' . $entityType . '"', 'entityType'],
]);
return $queryBuilder->build();
}
protected function getUserTimeZone(User $user): string
{
$preferences = $this->entityManager->getEntityById(Preferences::ENTITY_TYPE, $user->getId());
if ($preferences) {
$timeZone = $preferences->get('timeZone');
if ($timeZone) {
return $timeZone;
}
}
return $this->config->get('timeZone') ?? 'UTC';
}
}