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
addFromConnector()Добавляет из коннектора.addIfNotExist()Добавить, если не существует.checkConnectors()Проверяет коннекторы.checkEmail()Проверяет email.deleteList()getConflictFields()Получает поля индекса уникального ключаupdateConsentStatus()upload()Загружает контакты.validateEmail()Возвращает валидаторы для поля EMAIL_FROM.
onBeforeAdd() есть и у других классов модуля «Email-маркетинг»: TemplateTable.
Исходный файл: source/sender/lib/contact.php:197

