. * * 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\Modules\Crm\Controllers; use Espo\Core\Api\Response; use Espo\Core\Controllers\Record; use Espo\Core\Exceptions\Error; use Espo\Core\Exceptions\Forbidden; use Espo\Core\Exceptions\BadRequest; use Espo\Core\Exceptions\NotFound; use Espo\Core\Api\Request; use Espo\Core\Mail\Exceptions\SendingError; use Espo\Core\Utils\Json; use Espo\Modules\Crm\Entities\Meeting as MeetingEntity; use Espo\Modules\Crm\Tools\Meeting\InvitationService; use Espo\Modules\Crm\Tools\Meeting\Invitation\Invitee; use Espo\Modules\Crm\Tools\Meeting\Service; use stdClass; class Meeting extends Record { /** * @throws BadRequest * @throws Forbidden * @throws Error * @throws SendingError * @throws NotFound */ public function postActionSendInvitations(Request $request): bool { $id = $request->getParsedBody()->id ?? null; if (!$id) { throw new BadRequest("No id."); } $invitees = $this->fetchInvitees($request); $resultList = $this->injectableFactory ->create(InvitationService::class) ->send(MeetingEntity::ENTITY_TYPE, $id, $invitees); return $resultList !== 0; } /** * @throws BadRequest * @throws Forbidden * @throws Error * @throws SendingError * @throws NotFound */ public function postActionSendCancellation(Request $request): bool { $id = $request->getParsedBody()->id ?? null; if (!$id) { throw new BadRequest("No id."); } $invitees = $this->fetchInvitees($request); $resultList = $this->injectableFactory ->create(InvitationService::class) ->sendCancellation(MeetingEntity::ENTITY_TYPE, $id, $invitees); return $resultList !== 0; } /** * @param Request $request * @return ?Invitee[] * @throws BadRequest */ private function fetchInvitees(Request $request): ?array { $targets = $request->getParsedBody()->targets ?? null; if ($targets === null) { return null; } if (!is_array($targets)) { throw new BadRequest("No targets."); } $invitees = []; foreach ($targets as $target) { if (!$target instanceof stdClass) { throw new BadRequest("Bad target."); } $targetEntityType = $target->entityType ?? null; $targetId = $target->id ?? null; if (!is_string($targetEntityType) || !is_string($targetId)) { throw new BadRequest("No entityType or id."); } $invitees[] = new Invitee($targetEntityType, $targetId); } return $invitees; } /** * @throws BadRequest * @throws Forbidden */ public function postActionMassSetHeld(Request $request): bool { $ids = $request->getParsedBody()->ids ?? null; if (!is_array($ids)) { throw new BadRequest("No `ids`."); } $this->injectableFactory ->create(Service::class) ->massSetHeld(MeetingEntity::ENTITY_TYPE, $ids); return true; } /** * @throws BadRequest * @throws Forbidden */ public function postActionMassSetNotHeld(Request $request): bool { $ids = $request->getParsedBody()->ids ?? null; if (!is_array($ids)) { throw new BadRequest("No `ids`."); } $this->injectableFactory ->create(Service::class) ->massSetNotHeld(MeetingEntity::ENTITY_TYPE, $ids); return true; } /** * @throws BadRequest * @throws NotFound * @throws Forbidden */ public function postActionSetAcceptanceStatus(Request $request): bool { $data = $request->getParsedBody(); if (empty($data->id) || empty($data->status)) { throw new BadRequest("No id or status."); } $this->injectableFactory ->create(Service::class) ->setAcceptance(MeetingEntity::ENTITY_TYPE, $data->id, $data->status); return true; } /** * @throws BadRequest * @throws Forbidden * @throws NotFound */ public function getActionAttendees(Request $request, Response $response): void { $id = $request->getRouteParam('id'); if (!$id) { throw new BadRequest("No id."); } $collection = $this->injectableFactory ->create(Service::class) ->getAttendees(MeetingEntity::ENTITY_TYPE, $id); $response->writeBody( Json::encode(['list' => $collection->getValueMapList()]) ); } }