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

OnBeforeGroupDelete

bool
функция-обработчик(
 int group_id
);
Событие "OnBeforeGroupDelete" вызывается перед удалением группы пользователей. Как правило задачи обработчика данного события - разрешить или запретить удаление группы пользователей.

Параметры

ПараметрОписание
group_id ID удаляемой группы пользователей.

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

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

См. также

Пример:

<?
// файл /bitrix/php_interface/init.php
// регистрируем обработчик
AddEventHandler("main", "OnBeforeGroupDelete", Array("MyClass", "OnBeforeGroupDeleteHandler"));
class MyClass { // создаем обработчик события "OnBeforeGroupDelete" function OnBeforeGroupDeleteHandler($group_id) { // проверим есть ли связанные с удаляемой группой пользователей записи $strSql = "SELECT * FROM my_table WHERE GROUP_ID=".intval($group_id); $rs = $DB->Query($strSql, false, "FILE: ".__FILE__."<br>LINE: ".__LINE__); // если связанные записи есть то if ($ar = $rs->Fetch()) { // запретим удаление группы пользователей global $APPLICATION; $APPLICATION->throwException("В моей таблице есть связанные записи."); return false; } } } ?>

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

<?
// регистрируем обработчик события "OnBeforeGroupDelete" для модуля my_module_id
RegisterModuleDependences("main", "OnBeforeGroupDelete", 
     "my_module_id", "MyClass", "OnBeforeGroupDeleteHandler");
?>


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

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

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

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

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