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

OnBeforeGroupAdd

bool
EventHandler(
 array &arFields
);

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

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

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

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

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

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

См. также

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

<?
AddEventHandler("main", "OnBeforeGroupAdd", "MyOnBeforeGroupAdd");
function MyOnBeforeGroupAdd(&$arFields)
{
if($arFields["DESCRIPTION"] == '')
$arFields["DESCRIPTION"] = "Описание группы";
}
?>


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

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

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

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

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