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