Перейти к основному содержимому
Версия: 7.0

Открытие формы

Оператор открытия формы создает действие, которое открывает заданную форму.

Выбор формы​

Кроме явного указания формы, которую необходимо открыть, в платформе также существует возможность открыть форму выбора / редактирования объектов пользовательского класса — в этом случае класс заменяет форму.

Выбор представления​

При открытии формы необходимо определить, какой именно из видов представления будет использован для отображения формы:

Передача объектов​

При открытии формы для любого ее объекта можно передать значение из контекста вызова, которое в зависимости от представления будет использовано следующим образом:

  • В интерактивном представлении - переданное значение установлено в качестве текущего объекта.
  • В статичном представлении - будет установлен дополнительный фильтр: объект должен быть равен переданному значению.

По умолчанию все передаваемые значения объектов должны быть определены (не NULL), в противном случае действие не выполнится и просто передаст управление следующему за ним действию. Впрочем, в интерактивном представлении разработчик может разрешить NULL для отдельного объекта. В этом случае (как и в случае когда объект вообще не передается) в качестве текущего объекта будет выбран объект по умолчанию; он не берётся из контекста вызова, а выбирается из собственных данных формы и из объектов, с которыми пользователь работал раньше. Переданный NULL не становится текущим значением объекта — он равносилен отсутствию значения; без текущего значения объект остаётся лишь при типе объектов по умолчанию не определено или когда подходящих объектов нет, с соответствующими последствиями для показа его свойств на форме.

к сведению

Стоит отметить, что передача объектов в интерактивном представлении по сути эквивалентна выполнению операции поиска объектов сразу после открытия формы. При этом переданные объекты являются объектами поиска, а направление поиска берётся из типа объекта по умолчанию каждой группы — с одним исключением, специфичным для открытия формы: тип предыдущий трактуется как первый.

Дополнительные фильтры​

Помимо передачи значений объектов, к действию открытия формы можно прикрепить список дополнительных фильтров — свойств, которые дополнительно ограничивают, какие наборы объектов попадут на форму. Эти фильтры добавляются поверх фильтров, заданных на самой форме, и действуют во всех представлениях, в которых форма отображается (интерактивном, печатном, структурированном экспорте; не при импорте формы).