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