Описание
- не требует получения объекта;
- содержит только раздел процедур и функций;
- исключить из клиентского контекста код модуля, заключив его в инструкцию препроцессора - https://its.1c.ru/db/v8std/content/680/hdoc;
Предопределенные обработчики событий
- ОбработкаПолученияДанныхВыбора(ДанныеВыбора, Параметры, СтандартнаяОбработка)
Вызывается
- при автоподборе, то есть когда возникает пауза при наборе текста в поле ввода.
- при вводе по строке, то есть когда в поле ввода уже введена какая-то строка и фокус ввода переходит на другой элемент формы.
- при быстром выборе, когда для выбора объекта используется не его основная форма выбора, а небольшой список, формируемый системой.
- при выполнении метода ПолучитьДанныеВыбора.
Параметры
ДанныеВыбора - сюда можно поместить список значений, который вернется для выбора пользователю (СтандартнаяОбработка установить в ложь).
Параметры - структура содержит обязательные ключи, можно добавить свои ключи. Значения параметров могут быть изменены в этом обработчике, либо в обработчиках элемента формы «АвтоПодбор» и «ОкончаниеВводаТекста». Будут учитываться свойства Параметры выбора и Связи параметров выбора. Поэтому в параметрах могут содержаться какие-то отборы.
СтандартнаяОбработка - если равна Истина, то платформа самостоятельно сформирует список выбора исходя из того, что указано в Параметрах, если равна Ложь, платформа не будет формировать список выбора самостоятельно, а покажет то, что находится в параметре ДанныеВыбора.
Варианты использования
- изменить Параметры и сказать платформе, чтобы она сформировала список выбора;
- отказаться от стандартной обработки и самостоятельно сформировать список выбора.
Ссылки
- "Разработка интерфейса прикладных решений на платформе";
- Как получить доступ к списку выбора в этом обработчике, который сформирует платформа;
- ОбработкаПолученияПолейПредставления(Поля, СтандартнаяОбработка)
Вызывается
- при получении состава полей, из которых формируется представление объекта или ссылки. Обработчик нужен для формирования списка полей, значения которых будут использоваться в обработчике ОбработкаПолученияПредставления()
Параметры
Поля – массив, содержащий имена полей, используемых для формирования представления.
СтандартнаяОбрабока – флаг применения стандартного алгоритма. Для изменения алгоритма нужно его снять (установить в значение ложь) и заполнить массив полей именами используемых реквизитов.
Ссылки
- "Система стандартов и методик разработки конфигураций";
- ОбработкаПолученияПредставления(Данные, Представление, СтандартнаяОбработка)
Вызывается
- при получении представления объекта или ссылки. Формирует представление объекта (ссылки).
Параметры
Данные – Содержит значения полей, из которых формируется представление.
Представление – Строка, в которую нужно поместить новое представление объекта (ссылки). При вызове обработчика в параметре пусто.
СтандартнаяОбрабока – флаг применения стандартного алгоритма. Для изменения алгоритма нужно его снять (установить в значение ложь) и заполнить новое представление в предыдущий параметр.
Ссылки
- "Система стандартов и методик разработки конфигураций";
Напоминалка к обработчикам "ОбработкаПолученияПолейПредставления" и "ОбработкаПолученияПредставления".
- обработчики вызываются при любой необходимости получения представления объекта;
- не следует выполнять в этих обработчиках запросы или получение объектов информационной базы;
- не рекомендуется использовать поля неограниченной длины. Это может привести к проблемам получения представления для полей составного типа.
- ОбработкаПолученияФормы(ВидФормы, Параметры, ВыбраннаяФорма, ДополнительнаяИнформация, СтандартнаяОбработка)
Вызывается
- при получении стандартной формы клиентского приложения.
Параметры
ВидФормы – имя стандартной формы:
Параметры - параметры формы. Значения параметров могут быть изменены в этом обработчике, либо в обработчиках элемента формы «АвтоПодбор» и «ОкончаниеВводаТекста» для формы выбора.
ВыбраннаяФорма – содержит имя открываемой формы или объект метаданных Форма, через который передается выбранная форма, если параметр <СтандартнаяОбработка> установлен в ложь. При вызове обработчика значение «Неопределено».
ДополнительнаяИнформация – дополнительная информация открытия формы. Структура, содержащая поле «ПовторноеИспользование» булева типа, которое указывает, кэшируется ли форма на стороне клиента.
СтандартнаяОбрабока – флаг применения стандартного алгоритма. Для изменения алгоритма нужно установить в значение ложь и заполнить параметр «ВыбраннаяФорма».
Варианты использования
- задать в параметрах отбор, чтобы отфильтровать список выбора (Параметры.Отбор.Вставить("Ссылка", Список));
- в зависимости от значений реквизитов объекта, открывать разные формы;
Напоминалка
- По имени формы можно определить, является ли она формой объекта или списка (выбора) (ВидФормы = "ФормаОбъекта");
- Для формы объекта по ключу в параметрах «Ключ» можно понять открывается ли форма существующего объекта или нового элемента (Параметры.Свойство("Ключ") И ЗначениеЗаполнено(Параметры.Ключ));
Ссылки
- работа с неактуальными (недействительными) объектами;
- ОбработкаПослеЗаписиВерсийИсторииДанных(ИнформацияОЗаписиВерсий)
Вызывается
- после создания версий, отдельным вызовом метода ВыполнитьОбработкуПослеЗаписиВерсий либо в рамках вызова ОбновитьИсторию при указании необходимости выполнения обработки.
Параметры
ИнформацияОЗаписиВерсий - содержит информацию о записи версий истории данных
Варианты использования
- Цитата из руководства разработчика "Платформа предоставляет возможность выполнять действия, которые должны происходить только после того, как объект зафиксирован в истории данных. В качестве примера можно рассмотреть ситуацию, когда следует изменить отпускную цену на товар в том случае, если изменилась закупочная цена."
Ссылки
Сводная по модулям менеджера
