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

OnBeforeGroupUpdate

bool
EventHandler(
 int ID,
 array &arFields
);

Событие вызывается в методе CGroup::Update до изменения полей группы, и может быть использовано для отмены изменения или переопределения некоторых полей.

Параметры метода

Параметр Описание
IDИдентификатор изменяемой группы пользователей.
arFields Список полей (класс CGroup) изменяемой группы пользователей.

Параметр arFields данного обработчика является ссылкой на исходные переменные. Поэтому если изменить значение параметра внутри обработчика, это приведет к смене значения исходной переменной, поступившей на вход функции-обработчика.

Возвращаемое значение

Для отмены изменения и прекращении выполнения метода CGroup::Update необходимо в функции-обработчике создать исключение методом $APPLICATION->ThrowException() и вернуть false.

См. также

Примеры использования

<?
AddEventHandler("main", "OnBeforeGroupUpdate", "MyOnBeforeGroupUpdate");
function MyOnBeforeGroupUpdate($ID, &$arFields)
{
if($ID == 1)
$arFields["DESCRIPTION"] = "Главная группа админов.";
}
?>


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

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

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

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

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