Получает форму отчета.
Синтаксис
ПолучитьФорму(<Форма>, <Владелец>, <КлючУникальности>)Примеры платформы
Форма = Отчеты.Продажи.ПолучитьФорму();Полное описание, параметры и ограничения
ОтчетМенеджер.<Имя отчета>.ПолучитьФорму (ReportManager.<Report name>.GetForm)
ОтчетМенеджер.<Имя отчета> (ReportManager.<Report name>)
ПолучитьФорму (GetForm)
Доступен, начиная с версии 8.0.
Синтаксис:
ПолучитьФорму(<Форма>, <Владелец>, <КлючУникальности>)
Параметры:
<Форма> (необязательный)
Тип: Строка, ОбъектМетаданных: Форма.
Имя формы, как оно задано в конфигураторе, или объект описания метаданного требуемой формы. Если параметр не указан, то используется основная форма, заданная в конфигураторе.
<Владелец> (необязательный)
Тип: Форма; Элемент управления.
Объект, который будет являться владельцем открываемой формы.
<КлючУникальности> (необязательный)
Тип: Произвольный.
В данном параметре может быть задан некоторый ключ, значение которого будет использоваться для поиска уже открытых форм.
При поиске учитываются значения свойств открытых форм соответствующим значениям параметров метода. Если найдена открытая форма (по совпадению всех параметров), то она будет возвращена вместо новой формы.
Если из некой формы (один и тот же владелец) требуется открывать новые экземпляры другой формы, то при каждом вызове метода значение данного параметра должно быть уникально (в рамках соответствующих значений свойств открытых форм).
Значение параметра присваивается свойству открываемой формы КлючУникальности.
Следует учитывать, что при получении формы из "объекта" система получает форму для конкретного экземпляра объекта с учетом совокупности переданных параметров, в то время как для "ссылки" всегда существует только один объект в базе данных и форма получается одна (для одинаковой совокупности параметров).
Возвращаемое значение:
Тип: Форма, Неопределено.
Неопределено - если в обработчике ПриСозданииНаСервере установлен признак отказа от создания формы.
Описание:
Получает форму отчета.
Доступность:
Толстый клиент.
Пример:
Форма = Отчеты.Продажи.ПолучитьФорму();
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Обычная форма собственного отчёта конфигурации
Реальный менеджер своего отчёта предоставляет подготовленную обычную форму.
Где и как запускать
Толстый клиент своей учебной базы; фрагмент вставляется в обработчик своей команды. Здесь 1С не запускалась.
Подготовка
В своей учебной конфигурации создайте отчёт Продажи и его обычную форму ФормаОтчета.
Выполняйте в толстом клиенте. Имена в коде принадлежат подготовленным вами метаданным, не любому типовому решению.
Форма = Отчеты.Продажи.ПолучитьФорму("ФормаОтчета");
Если Форма <> Неопределено Тогда
Форма.Открыть();
Иначе
Сообщить("Форма отчёта не получена");
КонецЕсли;Разбор по шагам
Обращаемся к действительному менеджеру Отчеты.Продажи.
Получаем свою обычную форму по имени.
Открываем только реально полученную форму.
Как проверить результат
Показана ФормаОтчета своего отчёта Продажи.
При отсутствии результата выполняется сообщение, а не метод Неопределено.
Ожидаемый результат
Контрольный результат описывает будущую ручную проверку в подготовленном учебном окружении. Выполнение в 1С здесь не проверялось.
На что обратить внимание
Эта подпись не является программным открытием управляемой формы тонкого клиента.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.