Модуль объекта в 1С 8.3

Модуль объекта

Модуль объекта есть почти у всех основных прикладных объектов конфигурации в 1С.

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

Чтобы открыть модуль объекта нужно в окне свойств объекта на закладке «Прочее» нажать кнопку «Модуль объекта»

Также модуль объекта можно открыть из контекстного меню объекта:

Или из меню Действия:

Модуль объекта выполняется при создании объекта. В нем можно объявлять переменные модуля. Экспортные процедуры и функции можно вызывать у созданных программных объектов. К экспортным переменным можно обращаться как к свойствам программных объектов. В модуле есть прямой доступ к реквизитам и табличным частям объекта.

Вызов методов модуля объекта

Для примера создадим в конфигурации справочник «Номенклатура» с реквизитом «Артикул» и табличной частью «Остатки». У табличной части будет 2 реквизита: «Склад» и «Остаток»:

В модуле объекта напишем следующий код:

Теперь создадим обработку с одной формой и в модуле обработки в событии ПриСозданииНаСервере напишем следующий код:

Здесь мы сначала создаем новый программный объект справочника Номенклатура вызвав встроенный метод Справочники.Номенклатура.СоздатьЭлемент(). Потом через ссылку на этот объект обращаемся к экспортным переменной и функции объекта.

Сохраним конфигурацию базы данных и откроем нашу обработку в пользовательском режиме. Событие формы ПриСозданииНаСервере выполняется при открытии формы в итоге в сообщениях мы увидим число 300. То есть через ссылку на программный объект мы можем обращаться к экспортным переменным и функция модуля объекта. Но значения переменных не сохраняются в базе данных. Как только объект будет удален из памяти все значения экспортных переменных будут потеряны.

Теперь поменяем код в модуле формы обработки на следующий:

Здесь мы делаем все то же самое, но обращаемся к не экспортным переменной и функции.

При открытии формы возникнет ошибка «Поле объекта не обнаружено ПолноеНаименование»:

Так как переменная ПолноеНаименование не является экспортной, то к ней нет доступа из других модулей.

Теперь попробуем обратиться к не экспортной функции модуля объекта. Вставим в модуль формы следующий код и откроем обработку:

Выйдет ошибка «Метод объекта не обнаружен ПолноеНаименованиеНоменклатуры»:

Теперь вставим в форму обработки такой код и откроем обработку:

Здесь мы вызываем экспорную процедуру модуля объекта, а потом встроенным методом Записать записываем объект в базу данных.

В результате в базе данных будет создан новый элемент, у которого заполнен артикул и добавлены 2 строки в табличную часть:

В методе ЗаполнитьРеквизиты() мы обращались напрямую к реквизитам объекта, после чего записали его методом Записать(). Значения реквизитов сохранились в базе данных.

Обработчики событий

В модуле объекта есть множество различных обработчиков событий, которые вызываются в определенные моменты времени. Чтобы увидеть все события нужно нажать на кнопку «Процедуру и функции» в панели инструментов:

В результате откроется список возможных событий:

Если выделить какое-то событие и нажать кнопку «Перейти» или просто щелкнуть по нему два раза левой кнопкой мыши, то в модуле объекта будет создана процедура для обработки данного события.

Рассмотрим основные события модуля объекта:

• ОбработкаЗаполнения — выполняется при интерактивном создании нового объекта, при вводе на основании, при вызове метода Заполнить().
• ОбработкаПроверкиЗаполнения — выполняется перед записью объекта в базу данных, но до начала транзакции записи. Можно отказаться от записи, установив Отказ = Истина;
• ПередЗаписью — выполняется до записи объекта в базу данных, но после начала транзакции записи. Можно отказаться от записи, установив Отказ = Истина;
• ПриЗаписи — выполняется после записи объекта в базу данных, транзакция записи еще не зафиксирована. Все еще можно отказаться от записи.
• ПередУдалением — выполняется перед непосредственным удалением объекта из базы данных.
• ПриКопировании — выполняется при создании нового объекта копированием.

Для примера создадим в модуле объекта 3 обработчика события и вставим в них следующий код:

Создадим интерактивно новый элемент справочника. Поле артикул уже будет заполнено:

Произвольно заполним наименование и нажмем на кнопку «Записать». В табличной части появятся 2 строки с остатками:

Одна строка была добавлена в событии ПередЗаписью, вторая ПриЗаписи.