Обработчики событий объектов (Система стандартов) Процедуры-обработчики событий (Методические рекомендации) Последовательности событий при проведении документа 1С. Шпаргалка
ОбработкаПроверкиЗаполнения
- выполняется вне транзакции;
- в данном обработчике выполняются действия, связанные с проверкой правильности заполнения значений реквизитов. Следует пользоваться когда для проверки значений реквизитов обычной проверки на заполненность недостаточно или проверка заполнения зависит от какого-либо условия.
- если проверка условная, следует предусмотреть код, который удаляет имя такого реквизита из массива ПроверяемыеРеквизиты;
- для реквизитов, некорректные значения которых могут привести к рассогласованности данных в информационной базе, проверку корректности следует выполнять в обработчиках событий, возникающих в транзакции записи - ПередЗаписью, ПриЗаписи, ОбработкаПроведения (проверка состояния движений, проверка состояния других объектов информационной базы, ссылки на которых содержатся в текущем объекте);
- НЕ ВЫЗЫВАЕТСЯ если запись были инициирована программно;
- ВЫЗЫВАЕТСЯ
- расширением формы при необходимости проверки заполнения реквизитов (флаг ПроверятьЗаполнениеАвтоматически установлен):
-- при записи;
-- для формы документов для проводимых документов только при проведении документа, для не проводимых при записи;
-- для формы бизнес-процесса при старте бизнес-процесса;
- при выполнении метода ПроверитьЗаполнение.
ПередЗаписью
- неявная транзакция записи открывается перед данным обработчиком;
- в начале метода проверка на ОбменДанными.Загрузка;
- заполнение служебных значений реквизитов объекта (пользовательские данные объекта желательно заполнить пользователем при интерактивной работе, или в обработке заполнения при программном заполнении.);
- считывание "старых" значений реквизитов объекта, сохраненных в базе данных;
ПриЗаписи
- в начале метода проверка на ОбменДанными.Загрузка;
- действия по записи связанной с объектом данных в других объектах;
- объект уже записан в БД, запрещается изменять сам объект;
ОбработкаПроведения
- возникает при проведении документа;
- основное назначение - генерация движений по документу;
- выполняется в транзакции записи;
ПередУдалением
- возникает в транзакции удаления;
- в начале метода проверка на ОбменДанными.Загрузка;
- действия перед удалением объекта, например очистить ссылки на этот объект;
ПриКопировании
- возникает при копировании объекта;
- очистить содержимого реквизитов объекта, когда значения этих реквизитов не должны копироваться;
ОбработкаЗаполнения
- возникает при вводе документа на основании;
- возникает при выполнении метода Заполнить;
- возникает при интерактивном вводе нового;
- не вызывается при копировании;
- выполнение специального заполнения в зависимости от типа параметра ДанныеЗаполнения;
- выполнения общего заполнения, с целью заполнить значениями по умолчанию реквизиты, которые не были заполнены. Также для этой цели можно использовать свойство метаданных "Значение заполнения", которое присвоится реквизиту при выходе из обработчика, в случае если СтандартнаяОбработка = Истина и реквизит не был заполнен;
- если необходимо ограничить ввод на основании по команде "Создать на основании" (например, запретить ввод на основании групп, на основании непроведенных документов). Для оповещения о причинах отказа использовать исключения.
ОбработкаУдаленияПроведения
- выполняется в транзакции записи;
- возникает при отмене проведения документа;
ПриУстановкеНовогоНомера
- возникает в момент, когда выполняется установка нового номера;
- можно установить префикс автонумерации;
ПриУстановкеНовогоКода
- возникает в момент, когда выполняется установка нового кода;
- можно установить префикс автонумерации;
ОбработкаФормированияПоВерсииИсторииДанных
- возникает при формировании объекта по версии истории данных.
Сводная обработчиков событий
Ссылки
Обработчики событий объектов (Система стандартов)
Процедуры-обработчики событий (Методические рекомендации)
Последовательности событий при проведении документа 1С. Шпаргалка