method public static

ContactTable::onBeforeAdd()

Класс: \Bitrix\Sender\ContactTable

Сигнатура

public static onBeforeAdd(Event $event) : EventResult

Описание

Обработчик события перед добавлением.

Параметры

$event Event
Объект события.

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

EventResult

Как применяется в ContactTable

ContactTable::onBeforeAdd() — метод класса \Bitrix\Sender\ContactTable модуля «Email-маркетинг». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_Contact, наборы — как EO_Contact_Collection. Метод достаётся ContactTable от DataManager::onBeforeAdd: поведение общее для всех сущностей, а данные, поля и классы — свои.

Событие OnBeforeAdd сущности ContactTable. Статический метод в классе — обработчик по умолчанию; чтобы вмешаться в запись из своего кода, подпишитесь на событие через ORM-менеджер событий \Bitrix\Main\ORM\EventManager: он принимает класс сущности и код события из константы.

use Bitrix\Main\Loader;
use Bitrix\Main\ORM\EventManager;
use Bitrix\Main\ORM\Event;
use Bitrix\Main\ORM\EventResult;
use Bitrix\Main\ORM\EntityError;
use Bitrix\Sender\ContactTable;

Loader::includeModule('sender');

EventManager::getInstance()->addEventHandler(
    ContactTable::class,
    ContactTable::EVENT_ON_BEFORE_ADD,
    function (Event $event) {
        $fields = $event->getParameter('fields');
        $result = new EventResult();
        // $result->addError(new EntityError('Причина отказа'));
        return $result;
    }
);

Собственные методы ContactTable

onBeforeAdd() есть и у других классов модуля «Email-маркетинг»: TemplateTable.

Исходный файл: source/sender/lib/contact.php:197

Что будем искать? Например,Продвижение