Обработчик события вызывается на сервере при получении стандартной формы клиентского приложения. Если требуется переопределить выбор открываемой формы, необходимо установить в параметре <ВыбраннаяФорма> другое имя формы или объект метаданных формы, которую требуется открыть, и в параметре <СтандартнаяОбработка> установить значение Ложь.
Синтаксис
ОбработкаПолученияФормы(<ВидФормы>, <Параметры>, <ВыбраннаяФорма>, <ДополнительнаяИнформация>, <СтандартнаяОбработка>)Полное описание, параметры и ограничения
РегистрРасчетаМенеджер.<Имя регистра расчета>.ОбработкаПолученияФормы (CalculationRegisterManager.<Calculation register name>.FormGetProcessing)
РегистрРасчетаМенеджер.<Имя регистра расчета> (CalculationRegisterManager.<Calculation register name>)
ОбработкаПолученияФормы (FormGetProcessing)
Доступен, начиная с версии 8.2.
Синтаксис:
ОбработкаПолученияФормы(<ВидФормы>, <Параметры>, <ВыбраннаяФорма>, <ДополнительнаяИнформация>, <СтандартнаяОбработка>)
Параметры:
<ВидФормы>
Тип: Строка.
Имя стандартной формы.
<Параметры>
Тип: Структура.
Параметры формы.
<ВыбраннаяФорма>
Тип: Строка, ОбъектМетаданных: Форма.
Содержит имя открываемой формы или объект метаданных Форма.
Если значение параметра изменено, то будет осуществлен поиск формы в пределах объекта, для которого открывается форма.
<ДополнительнаяИнформация>
Тип: Структура.
Дополнительная информация открытия формы.
Структура, содержащая поле ПовторноеИспользование (Reuse) типа Булево, которое указывает, кешируется ли форма на стороне клиента.
<СтандартнаяОбработка>
Тип: Булево.
В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет (выбираются установленные разработчиком форма и параметры).
Значение по умолчанию: Истина.
Описание:
Обработчик события вызывается на сервере при получении стандартной формы клиентского приложения.
Если требуется переопределить выбор открываемой формы, необходимо установить в параметре <ВыбраннаяФорма> другое имя формы или объект метаданных формы, которую требуется открыть, и в параметре <СтандартнаяОбработка> установить значение Ложь.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Замечание:
Безопасный режим на время исполнения данного обработчика будет отключен. Данное замечание не относится к обработчикам событий, расположенным в расширении конфигурации.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Выбрать альтернативную форму УчебныеНачисленияНастроек
Платформа запрашивает стандартную форму собственного объекта, а менеджер выбирает реально созданную альтернативу. Запросы других видов форм остаются стандартными.
Где и как запускать
Модуль менеджера собственного объекта: серверный платформенный обработчик без директив. Дополнительный блок — клиентская команда другой учебной формы.
Подготовка
Работайте только в собственной пустой учебной конфигурации. В Конфигураторе создайте ПланВидовРасчета УчебныеВидыРасчета; не добавляйте эти учебные объекты в рабочую базу.
Код — строковый длиной 10, наименование длиной 100. Для справочника, плана обмена и плана видов характеристик включите автонумерацию. Для счетов и видов расчёта код назначается явно в примере.
Для плана видов расчёта не включайте зависимость от базового периода и действие по периоду. Регистры расчёта в этом уроке не нужны.
Добавьте реквизиты Комментарий (Строка 100), Лимит (Число 15.2 с разрешённым отрицательным знаком), ЗапретУдаления (Булево). Не делайте их автоматически обязательными: дополнительные правила описаны отдельными обработчиками.
Для этой диагностики дополнительно создайте документ УчебныйРасчетНастроек с разрешённым проведением. Создайте регистр расчёта УчебныеНачисленияНастроек, периодичность Месяц, план видов расчёта УчебныеВидыРасчета, регистратор УчебныйРасчетНастроек, ресурс Результат типа Число 12.2.
Остальные механизмы расчёта оставьте выключенными. Обновите учебную конфигурацию; документы и начисления не создавайте. Читается только Периодичность регистра, начисление зарплаты не выполняется.
У РегистрРасчета УчебныеНачисленияНастроек создайте две управляемые формы одного подходящего вида: ОсновнаяУчебная и УчебнаяАльтернатива. Для ФормаСписка назначьте основной только ОсновнаяУчебная; УчебнаяАльтернатива не должна быть основной.
Для списочных объектов используйте мастер формы списка с его обычным основным реквизитом. Для перечисления создайте формы выбора, для обработки / отчёта — соответствующие основные формы. У альтернативы задайте заголовок Альтернативная учебная форма и добавьте такую же текстовую декорацию.
В модуле менеджера УчебныеНачисленияНастроек разместите основной обработчик целиком. Не вызывайте в нём ОткрытьФорму и не размещайте его в модуле самой формы.
Обновите учебную базу. В своей внешней обработке с управляемой формой создайте команду ОткрытьУчебнуюФорму; её клиентский обработчик возьмите из дополнительного блока. Списки могут быть пустыми: этот урок ничего не создаёт и не записывает.
Процедура ОбработкаПолученияФормы(ВидФормы, Параметры, ВыбраннаяФорма, ДополнительнаяИнформация, СтандартнаяОбработка)
Если ВидФормы = "ФормаСписка" Тогда
ВыбраннаяФорма = "УчебнаяАльтернатива";
СтандартнаяОбработка = Ложь;
ДополнительнаяИнформация.Вставить("ПовторноеИспользование", Ложь);
КонецЕсли;
КонецПроцедурыВнешняя учебная обработка: клиентский запрос стандартной формы
&НаКлиенте
Процедура ОткрытьУчебнуюФорму(Команда)
ОткрытьФорму("РегистрРасчета.УчебныеНачисленияНастроек.ФормаСписка");
Сообщить("Запрошена стандартная форма; её имя выбирает модуль менеджера");
КонецПроцедурыРазбор по шагам
Клиент запрашивает ФормаСписка через ОткрытьФорму; обработчик вызывается платформой на сервере.
Только для указанного вида назначается имя УчебнаяАльтернатива в пределах данного объекта метаданных.
СтандартнаяОбработка = Ложь применяет собственный выбор. ПовторноеИспользование = Ложь отключает повторное использование формы для этого запроса, а не кэш всей платформы.
Как проверить результат
Открылась форма с заголовком Альтернативная учебная форма, хотя клиент запросил стандартное имя.
Запрос другого стандартного вида не переопределяется. При прямом открытии именованной формы этот обработчик стандартного выбора не следует использовать как универсальный перехват.
Ожидаемый результат
Событие менеджера выбирает конкретную существующую форму своего объекта.
На что обратить внимание
Имя альтернативы локально для объекта метаданных; нельзя указать в ВыбраннаяФорма полный путь формы другого объекта.
Не вызывайте повторное получение стандартной формы внутри обработчика: это может повторно вызвать тот же выбор.
Открытие списка не создаёт записей и не является проверкой выполнения бухгалтерского или расчётного кода.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.