From In-Portal Developers Guide

This article is not finished yet! You see this message because current Article is finished yet or contains unverified information. How to write an Article.

События общего применения
Статьи в этой категории
OnItemBuild OnListBuild OnAfterConfigRead OnExport OnExportBegin OnBeforeExportBegin OnExportCancel OnDeleteExportPreset OnBeforeCSVLineImport

При создании объекта класса kDBItem требуется производить сопутствующие действия - такие как подготовка SQL-запроса для загрузки данных, проверка прав доступа к данным, загрузка данных в объект при необходимости, создание и инициализация переменных окружения, инициализация свойств объекта. Для логического выделения этих операций в общем потоке предназначено особое событие - OnItemBuild.

Это событие задаётся в Unit Configs, под ключом 'build_event' для 'ItemClass'.

'ItemClass' => Array ('class' => 'kDBItem', 'file' => '', 'build_event' => 'OnItemBuild'),

Это событие вызывается в классе kFactory, после того как создан новый экземпляр объекта. Если в создании нового экземпляра нет необходимости, то методы kFactory возвращают ссылку на ранее созданный экземпляр, и событие OnItemBuild не происходит.

Вызывается из шаблона

Не вызывается из шаблонов.

Вызывается из событий

Не вызывается из событий.

Входные параметры

Вызывает события

Не вызывает событий

Потенциальное применение

Для того, чтобы объект типа kDBItem мог инициализироваться на пользовательской части сайта без ошибки отсутствия прав, наиболее простым решением является прописывание события OnItemBuild в методе mapPermissions соответствующего обработчика событий.

function mapPermissions()
{
	parent::mapPermissions();
	$permissions = Array(
		'OnItemBuild'	=>	Array('self' => true, 'subitem' => true),
	);
	$this->permMapping = array_merge($this->permMapping, $permissions);
}

Потенциально, событие OnItemBuild возможно переписать в случае каких-то объектов, требующих нестандартной настройки, например, вследствие необычных взаимосвязей с другими объектами.

Ограничения

Особых ограничений нет.

Использует вспомогательные методы класса

dbBuild, ItemPrepareQuery, CheckPermission, LoadItem, checkItemStatus