Возникает при вводе документа на основании, а также при выполнении метода Заполнить, при вводе на основании, а также при интерактивном вводе нового. В процедуре-обработчике этого события должен быть описан сам алгоритм заполнения реквизитов документа на основании переданного значения.
Синтаксис
ОбработкаЗаполнения(<ДанныеЗаполнения>, <ТекстЗаполнения>, <СтандартнаяОбработка>)Полное описание, параметры и ограничения
ДокументОбъект.<Имя документа>.ОбработкаЗаполнения (DocumentObject.<Document name>.Filling)
ДокументОбъект.<Имя документа> (DocumentObject.<Document name>)
ОбработкаЗаполнения (Filling)
Доступен, начиная с версии 8.0.
Синтаксис:
ОбработкаЗаполнения(<ДанныеЗаполнения>, <ТекстЗаполнения>, <СтандартнаяОбработка>)
Параметры:
<ДанныеЗаполнения>
Тип: Произвольный.
Значение, которое используется как основание для заполнения.
Если обработчик вызван при выполнении метода Заполнить, параметр равен параметру <ДанныеЗаполнения> метода Заполнить.
При обработке заполнения во время ввода на основании параметр имеет значение основания.
При интерактивном вводе нового из формы списка параметр является структурой, элементы которой соответствуют тем параметрам отбора формы списка, у которых способ сравнения Равно или ВСписке с единственным элементом списка. Если таких элементов отбор списка не содержит, данный параметр равен Неопределено. Если параметр <СтандартнаяОбработка> по окончании работы обработчика равен Истина (установлен по умолчанию), система автоматически произведет заполнение одноименными элементами структуры.
<ТекстЗаполнения>
Тип: Строка, Неопределено.
Текст, используемый для заполнения документа.
Если у объекта реквизит Номер находится в списке "Ввод по строке" и не установлен признак Автонумерация, то значение присваивается реквизиту Номер.
В противном случае присвоение не выполняется.
Неопределено - для мобильной платформы.
<СтандартнаяОбработка>
Тип: Булево.
В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет. Отказ от стандартной обработки не отменяет действие.
Значение по умолчанию: Истина.
Описание:
Возникает при вводе документа на основании, а также при выполнении метода Заполнить, при вводе на основании, а также при интерактивном вводе нового. В процедуре-обработчике этого события должен быть описан сам алгоритм заполнения реквизитов документа на основании переданного значения.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
При копировании (как интерактивном, так и средствами встроенного языка), данный обработчик не вызывается.
Замечание:
Безопасный режим на время исполнения данного обработчика будет отключен. Данное замечание не относится к обработчикам событий, расположенным в расширении конфигурации.
См. также:
ДокументОбъект.<Имя документа>, метод Заполнить
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Заполнить учебную заявку из структуры заказа
Заполнение переносит сведения в новый документ без проведения и записи.
Где и как запускать
Модуль объекта или набора записей, указанный в подготовке. Обработчик вызывается платформой; не вызывайте его как обычную команду формы.
Подготовка
В отдельной учебной конфигурации создайте документ УчебнаяЗаявка: строковый номер длиной 12 с автонумерацией и разрешённым проведением.
Добавьте реквизиты Комментарий (Строка 100), Сумма (Число 15.2), Утвержден (Булево), ЗакрытПериод (Булево). Регистры и движения для этого урока не нужны.
Откройте Документы → УчебнаяЗаявка → Модуль объекта, вставьте обработчик и обновите только учебную базу. Это пример жизненного цикла, а не готовый бухгалтерский документ.
Создайте новый документ в серверной команде и вызовите Заполнить(Новый Структура("Комментарий,Сумма", "Учебный заказ", 600)).
Процедура ОбработкаЗаполнения(ДанныеЗаполнения, ТекстЗаполнения, СтандартнаяОбработка)
Если ДанныеЗаполнения = Неопределено Тогда
Возврат;
КонецЕсли;
Комментарий = ДанныеЗаполнения.Комментарий;
Сумма = ДанныеЗаполнения.Сумма;
Утвержден = Ложь;
СтандартнаяОбработка = Ложь;
Сообщить("Заполнена заявка: " + Комментарий);
КонецПроцедурыРазбор по шагам
Источник в этом примере — собственная структура с двумя известными полями.
Поля переносятся в документ, утверждение сбрасывается.
Для принятого источника стандартное заполнение выключается.
Как проверить результат
Комментарий Учебный заказ, сумма 600, Утвержден = Ложь.
Без исходных данных процедура не обращается к отсутствующим полям.
Ожидаемый результат
Заявка заполнена в памяти и ещё не проведена.
На что обратить внимание
Не передавайте произвольный ответ внешнего API без разбора его контракта.
Заполнить не заменяет Записать.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.