OnBeforeSessionTransfer

Описание и параметры

В событие приходит объект \Bitrix\Main\Event.

Входящие параметры можно получить через $eventParams = $event->getParameters();

Параметры

Проверка на корректность

Внимательно проверяется корректность данных, которые возвращает обработчик. Если что-то не пройдет проверку, то отработает штатный алгоритм, как будто бы обработчика и нет.

Было создано дополнительное событие OnErrorEventBeforeSessionTransfer.

На него можно подписать на время отладки. В параметрах передается массив ошибок и объект, который вернул обработчик события.

Пример результата

array (
	'errors' => 
	array (
		0 => 'The result of the processing of the event returned with an error',
	),
	'eventResult' => 
	Bitrix\Main\EventResult::__set_state(array(
		'moduleId' => NULL,
		'handler' => NULL,
		'type' => 0,
		'parameters' => 
		array (
			'RESULT' => 5,
		),
	)),
)

Данное решение должно существенно облегчить дебаг.

Пример кода

"Болванка" событий

$eventManager = \Bitrix\Main\EventManager::getInstance();

$eventManager->addEventHandler('imopenlines', 'OnBeforeSessionTransfer', 'onBeforeSessionTransfer');
$eventManager->addEventHandler('imopenlines', 'OnErrorEventBeforeSessionTransfer', 'onErrorEventBeforeSessionTransfer');

public static function onBeforeSessionTransfer(\Bitrix\Main\Event $event)
{
	$eventParams = $event->getParameters();
	//test
	define("LOG_FILENAME", $_SERVER["DOCUMENT_ROOT"]."/log.txt");
	AddMessage2Log(var_export($eventParams,1), 'onBeforeSessionTransfer');
	//END test
	$eventParams['newOperatorQueue'] = [
		'RESULT' => true,
		'OPERATOR_ID' => 1,
		'OPERATOR_LIST' =>
			[],
		'DATE_QUEUE' => false,
		'QUEUE_HISTORY' =>
			[
				1 => true,
			],
	];

	return new \Bitrix\Main\EventResult(
		\Bitrix\Main\EventResult::SUCCESS,
		$eventParams
	);
}

public static function onErrorEventBeforeSessionTransfer(\Bitrix\Main\Event $event)
{
	$eventParams = $event->getParameters();
	//test
	define("LOG_FILENAME", $_SERVER["DOCUMENT_ROOT"]."/log.txt");
	AddMessage2Log(var_export($eventParams,1), 'OnErrorEventBeforeSessionTransfer');
	//END test
}