onBeforeResultStatusChange

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

функция-обработчик(
	int WEB_FORM_ID,
	int RESULT_ID,
	int &NEW_STATUS_ID,
	string(1) CHECK_RIGHTS
);

Обработчики события вызываются перед изменением статуса результата веб-формы. Может быть использовано для каких-либо дополнительных проверок или даже для изменения нового статуса, а также, как замена обработчика статуса веб-формы. Возврат обработчиком каких-либо значений не предполагается. Ошибки можно возвращать посредством $APPLICATION->ThrowException().

Параметры

Параметр	Описание
WEB_FORM_ID	ID веб-формы.
RESULT_ID	ID результата.
NEW_STATUS_ID	ID статуса.
CHECK_RIGHTS	Флаг "Проверять права" (Y|N).

Смотрите также

• Событие "onAfterResultStatusChange"

Пример функции-обработчика

public static function my_onBeforeResultStatusChange($WEB_FORM_ID, $RESULT_ID, $NEW_STATUS_ID, $CHECK_RIGHTS)
{
	global $USER;
  
	// действие обработчика распространяется только на форму с ID=6
	if ($WEB_FORM_ID == 6) 
	{
		// 1 - статус "в проверке" (по умолчанию), 2 - статус "принято"
		// результатам, присланным пользователем с правами администратора 
		// автоматически присвоим статус "принято".
		if ($USER->IsAdmin() && $NEW_STATUS_ID == 1)
			$NEW_STATUS_ID = 2;
	}
}

// зарегистрируем функцию как обработчик события
AddEventHandler('form', 'onBeforeResultStatusChange', 'my_onBeforeResultStatusChange');