Документация для разработчиков
Темная тема

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).

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

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

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');


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2020, «1С-Битрикс», 2020
Наверх