Обработчик события вызывается на сервере при получении стандартной формы клиентского приложения. Если требуется переопределить выбор открываемой формы, необходимо установить в параметре <ВыбраннаяФорма> другое имя формы или объект метаданных формы, которую требуется открыть, и в параметре <СтандартнаяОбработка> установить значение Ложь.
Синтаксис
ОбработкаПолученияФормы(<ВидФормы>, <Параметры>, <ВыбраннаяФорма>, <ДополнительнаяИнформация>, <СтандартнаяОбработка>)Полное описание, параметры и ограничения
ЖурналДокументовМенеджер.<Имя журнала документов>.ОбработкаПолученияФормы (DocumentJournalManager.<Document journal name>.FormGetProcessing)
ЖурналДокументовМенеджер.<Имя журнала документов> (DocumentJournalManager.<Document journal name>)
ОбработкаПолученияФормы (FormGetProcessing)
Доступен, начиная с версии 8.2.
Синтаксис:
ОбработкаПолученияФормы(<ВидФормы>, <Параметры>, <ВыбраннаяФорма>, <ДополнительнаяИнформация>, <СтандартнаяОбработка>)
Параметры:
<ВидФормы>
Тип: Строка.
Имя стандартной формы.
<Параметры>
Тип: Структура.
Параметры формы.
<ВыбраннаяФорма>
Тип: Строка, ОбъектМетаданных: Форма.
Содержит имя открываемой формы или объект метаданных Форма.
Если значение параметра изменено, то будет осуществлен поиск формы в пределах объекта, для которого открывается форма.
<ДополнительнаяИнформация>
Тип: Структура.
Дополнительная информация открытия формы.
Структура, содержащая поле ПовторноеИспользование (Reuse) типа Булево, которое указывает, кешируется ли форма на стороне клиента.
<СтандартнаяОбработка>
Тип: Булево.
В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет (выбираются установленные разработчиком форма и параметры).
Значение по умолчанию: Истина.
Описание:
Обработчик события вызывается на сервере при получении стандартной формы клиентского приложения.
Если требуется переопределить выбор открываемой формы, необходимо установить в параметре <ВыбраннаяФорма> другое имя формы или объект метаданных формы, которую требуется открыть, и в параметре <СтандартнаяОбработка> установить значение Ложь.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Замечание:
Безопасный режим на время исполнения данного обработчика будет отключен. Данное замечание не относится к обработчикам событий, расположенным в расширении конфигурации.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Получение своей формы журнала УчебныеПокупкиКниг без повторного использования
Обработчик сохраняет стандартный выбор формы, меняет только документированное поле политики кеширования своего менеджера.
Где и как запускать
Модуль менеджера собственного журнала УчебныеПокупкиКниг, серверное событие получения формы.
Подготовка
В собственной учебной конфигурации создайте справочник УчебныеКарточкиКниг: код Строка 10, наименование 100, реквизит Артикул Строка 40. Вручную подготовьте BOOK-001 / Книга / BOOK-A и BOOK-002 / Тетрадь / NOTE-A.
Создайте собственный непроводимый документ УчебнаяПокупкаКниг: Книга типа СправочникСсылка.УчебныеКарточкиКниг, СуммаУчебная Число 12.2. Вручную запишите в текущем месяце два своих документа: Книга / 750 и Тетрадь / 200.
Создайте журнал документов УчебныеПокупкиКниг, включите только свой УчебнаяПокупкаКниг. Графа СуммаКниг Число 12.2 должна быть связана с реквизитом СуммаУчебная собственного документа. Имя графы журнала и имя реквизита документа различаются намеренно.
Для урока критерия создайте УчебныеДокументыПоКниге. Тип — СправочникСсылка.УчебныеКарточкиКниг, состав — Документ.УчебнаяПокупкаКниг.Книга. Это именно описание критерия в конфигурации, не произвольная строка или структура отбора.
BSL, создание и запись учебных данных при сборке HTML не выполнялись. Чтение ограничено только собственными объектами этого урока.
Для урока константы создайте собственную УчебнаяПамяткаКниг типа Строка 100 и её стандартную управляемую форму. Для журнала / критерия используйте подготовленные собственные метаданные и стандартную форму, созданную мастером.
Основной код — модуль менеджера журнала УчебныеПокупкиКниг, не модуль формы. Откройте свою стандартную форму штатной командой соответствующего объекта; событие получения стандартной формы вызывает платформа на сервере.
Установленная справка указывает ПовторноеИспользование в ДополнительнаяИнформация. Не присваивайте Ложь параметру СтандартнаяОбработка: здесь не назначается другая выбранная форма.
Процедура ОбработкаПолученияФормы(ВидФормы, Параметры, ВыбраннаяФорма, ДополнительнаяИнформация, СтандартнаяОбработка)
ДополнительнаяИнформация.ПовторноеИспользование = Ложь;
Сообщить("Получение собственной стандартной формы: " + ВидФормы);
Сообщить("Выбор формы платформой сохранён; повторное использование отключено");
КонецПроцедурыРазбор по шагам
Создайте свой объект и стандартную форму.
Назначьте точный обработчик в модуле менеджера.
Запросите стандартную форму штатно и наблюдайте вызов; не вызывайте процедуру вручную вместо платформы.
Как проверить результат
Не изменены ВидФормы, ВыбраннаяФорма и стандартная обработка.
Отключение повторного использования не очищает данные, не отменяет права и не доказывается только одинаковым внешним видом двух открытий.
Ожидаемый результат
Показана реальная настройка получения формы в правильном менеджере.
На что обратить внимание
Изучайте урок на своём объекте: политика кеширования влияет на повторные открытия, а не на сохранение записи.
BSL, открытие формы и запрос менеджера при сборке HTML не выполнялись.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.