ПланВидовХарактеристикМенеджер.<Имя плана видов характеристик>.ОбработкаПолученияФормы

События · FormGetProcessing

Обработчик события вызывается на сервере при получении стандартной формы клиентского приложения. Если требуется переопределить выбор открываемой формы, необходимо установить в параметре <ВыбраннаяФорма> другое имя формы или объект метаданных формы, которую требуется открыть, и в параметре <СтандартнаяОбработка> установить значение Ложь.

Синтаксис

ОбработкаПолученияФормы(<ВидФормы>, <Параметры>, <ВыбраннаяФорма>, <ДополнительнаяИнформация>, <СтандартнаяОбработка>)
Полное описание, параметры и ограничения

ПланВидовХарактеристикМенеджер.<Имя плана видов характеристик>.ОбработкаПолученияФормы (ChartOfCharacteristicTypesManager.<Chart of characteristic types name>.FormGetProcessing)

ПланВидовХарактеристикМенеджер.<Имя плана видов характеристик> (ChartOfCharacteristicTypesManager.<Chart of characteristic types name>)

ОбработкаПолученияФормы (FormGetProcessing)

Доступен, начиная с версии 8.2.

Синтаксис:
ОбработкаПолученияФормы(<ВидФормы>, <Параметры>, <ВыбраннаяФорма>, <ДополнительнаяИнформация>, <СтандартнаяОбработка>)
Параметры:

<ВидФормы>
Тип: Строка.
Имя стандартной формы.

<Параметры>
Тип: Структура.
Параметры формы.

<ВыбраннаяФорма>
Тип: Строка, ОбъектМетаданных: Форма.
Содержит имя открываемой формы или объект метаданных Форма.
Если значение параметра изменено, то будет осуществлен поиск формы в пределах объекта, для которого открывается форма.

<ДополнительнаяИнформация>
Тип: Структура.
Дополнительная информация открытия формы.
Структура, содержащая поле ПовторноеИспользование (Reuse) типа Булево, которое указывает, кешируется ли форма на стороне клиента.

<СтандартнаяОбработка>
Тип: Булево.
В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет (выбираются установленные разработчиком форма и параметры).
Значение по умолчанию: Истина.
Описание:

Обработчик события вызывается на сервере при получении стандартной формы клиентского приложения.
Если требуется переопределить выбор открываемой формы, необходимо установить в параметре <ВыбраннаяФорма> другое имя формы или объект метаданных формы, которую требуется открыть, и в параметре <СтандартнаяОбработка> установить значение Ложь.

Доступность:

Сервер, толстый клиент, внешнее соединение.

Замечание:

Безопасный режим на время исполнения данного обработчика будет отключен. Данное замечание не относится к обработчикам событий, расположенным в расширении конфигурации.
Использование в версии:

Доступен, начиная с версии 8.2.

Методическая информация

Практические примеры

Выбрать альтернативную форму УчебныеХарактеристики

Платформа запрашивает стандартную форму собственного объекта, а менеджер выбирает реально созданную альтернативу. Запросы других видов форм остаются стандартными.

Где и как запускать

Модуль менеджера собственного объекта: серверный платформенный обработчик без директив. Дополнительный блок — клиентская команда другой учебной формы.

Подготовка

  1. Работайте только в собственной пустой учебной конфигурации. В Конфигураторе создайте ПланВидовХарактеристик УчебныеХарактеристики; не добавляйте эти учебные объекты в рабочую базу.

  2. Код — строковый длиной 10, наименование длиной 100. Для справочника, плана обмена и плана видов характеристик включите автонумерацию. Для счетов и видов расчёта код назначается явно в примере.

  3. У плана видов характеристик разрешите тип значения Число. Новый элемент получает ТипЗначения = Новый ОписаниеТипов("Число").

  4. Добавьте реквизиты Комментарий (Строка 100), Лимит (Число 15.2 с разрешённым отрицательным знаком), ЗапретУдаления (Булево). Не делайте их автоматически обязательными: дополнительные правила описаны отдельными обработчиками.

  5. У ПланВидовХарактеристик УчебныеХарактеристики создайте две управляемые формы одного подходящего вида: ОсновнаяУчебная и УчебнаяАльтернатива. Для ФормаСписка назначьте основной только ОсновнаяУчебная; УчебнаяАльтернатива не должна быть основной.

  6. Для списочных объектов используйте мастер формы списка с его обычным основным реквизитом. Для перечисления создайте формы выбора, для обработки / отчёта — соответствующие основные формы. У альтернативы задайте заголовок Альтернативная учебная форма и добавьте такую же текстовую декорацию.

  7. В модуле менеджера УчебныеХарактеристики разместите основной обработчик целиком. Не вызывайте в нём ОткрытьФорму и не размещайте его в модуле самой формы.

  8. Обновите учебную базу. В своей внешней обработке с управляемой формой создайте команду ОткрытьУчебнуюФорму; её клиентский обработчик возьмите из дополнительного блока. Списки могут быть пустыми: этот урок ничего не создаёт и не записывает.

Процедура ОбработкаПолученияФормы(ВидФормы, Параметры, ВыбраннаяФорма, ДополнительнаяИнформация, СтандартнаяОбработка)
    Если ВидФормы = "ФормаСписка" Тогда
        ВыбраннаяФорма = "УчебнаяАльтернатива";
        СтандартнаяОбработка = Ложь;
        ДополнительнаяИнформация.Вставить("ПовторноеИспользование", Ложь);
    КонецЕсли;
КонецПроцедуры
Внешняя учебная обработка: клиентский запрос стандартной формы
&НаКлиенте
Процедура ОткрытьУчебнуюФорму(Команда)
    ОткрытьФорму("ПланВидовХарактеристик.УчебныеХарактеристики.ФормаСписка");
    Сообщить("Запрошена стандартная форма; её имя выбирает модуль менеджера");
КонецПроцедуры

Разбор по шагам

  1. Клиент запрашивает ФормаСписка через ОткрытьФорму; обработчик вызывается платформой на сервере.

  2. Только для указанного вида назначается имя УчебнаяАльтернатива в пределах данного объекта метаданных.

  3. СтандартнаяОбработка = Ложь применяет собственный выбор. ПовторноеИспользование = Ложь отключает повторное использование формы для этого запроса, а не кэш всей платформы.

Как проверить результат

  1. Открылась форма с заголовком Альтернативная учебная форма, хотя клиент запросил стандартное имя.

  2. Запрос другого стандартного вида не переопределяется. При прямом открытии именованной формы этот обработчик стандартного выбора не следует использовать как универсальный перехват.

Ожидаемый результат

Событие менеджера выбирает конкретную существующую форму своего объекта.

На что обратить внимание

  1. Имя альтернативы локально для объекта метаданных; нельзя указать в ВыбраннаяФорма полный путь формы другого объекта.

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

  3. Открытие списка не создаёт записей и не является проверкой выполнения бухгалтерского или расчётного кода.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.