← Все интеграции Битрикс24 CRM

Свободная касса - сводка данных из различных источников по компании

Встраивание кастомного таба в детальную карточку компании CRM.

Добавление собственных табов в детальную карточку компании: связанные данные из внешних систем, история интеграций, кастомные формы и отчёты прямо в интерфейсе CRM.

lazyload,ajax.php - поднимает компонент, по сути является отдельной точкой входа без шапки портала. Проверяет сессию, авторизацию, модули - забирает параметры из запроса и вызывает компонент.
Цепочка параметров: componentData.params в обработчике → $_REQUEST['PARAMS']['params'] → $arParams компонента. В executeComponent() компания берётся как $this->arParams['ENTITY_ID']. Шаблон .default рисует блок сводки; ShowAjaxHead() перед подключением компонента нужен чтобы в ответ попали CSS и JS, которые шаблон регистрирует через addExternalCss / addExternalJs.

Расчёт сводки тяжёлый: договоры, сделки, коммерческие предложения, звонки за два месяца. Обработчик события выполняется при каждом открытии карточки и может вернуть только массив вкладок. Если вызвать компонент прямо в нём, расчёт пойдёт даже тогда, когда вкладку не открывают, и удлинит открытие карточки.

lazyload.ajax.php откладывает этот расчёт до клика и делает запрос лёгким:


lazyload.ajax

define('NO_KEEP_STATISTIC', 'Y');
define('NO_AGENT_STATISTIC','Y');
define('NO_AGENT_CHECK', true);
define('PUBLIC_AJAX_MODE', true);
define('DisableEventsCheck', true);
Эти константы отключают статистику хита, агентов и события страницы: в ответ уходит только HTML вкладки. bitrix_sessid_get() в адресе и check_bitrix_sessid() в ajax-файле закрывают точку входа от вызова без сессии портала.

Пример кода

Реализация

PHP
            $tabs[] = [
                    'id' => 'my_aggregated_client_data',
                    'name' => 'Сводка',
                    'loader' => [
                            'serviceUrl' => '/local/components/{убралнавсякийслучай}/company.freecassaflag/lazyload.ajax.php?&site=' . SITE_ID . '&' . bitrix_sessid_get(),
                            'componentData' => [
                                    'template' => '',
                                    'params' => [
                                            'ENTITY_ID' => $entityID,
                                            'ENTITY_TYPE_ID' => $entityTypeID,
                                            'IS_FRAME' => 'Y',
                                    ],
                            ],
                    ],
            ];

$event->setParameter('tabs', $tabs);
return new EventResult(EventResult::SUCCESS, ['tabs' => $tabs];

// lazyload.ajax

$componentData = isset($_REQUEST['PARAMS']) && is_array($_REQUEST['PARAMS']) ? $_REQUEST['PARAMS'] : array();
$componentParams = isset($componentData['params']) && is_array($componentData['params']) ? $componentData['params'] : array();
// ...
$APPLICATION->IncludeComponent(
    'убралнавсякийслучай:company.freecassaflag',
    '.default',
    $componentParams,
    false,
    ['HIDE_ICONS' => 'Y', 'ACTIVE_COMPONENT' => 'Y']
);