Как открыть форму внешней печатной формы в 1С

Внешняя печатная форма в 1С — это файл с расширением .epf, который подключается к конфигурации без изменения её структуры и позволяет печатать документы по собственному макету. Открыть форму такой обработки можно несколькими способами: напрямую через меню «Файл», через стандартный механизм дополнительных отчетов и обработок или программно из встроенного языка.

Выбор способа зависит от задачи. Если нужно просто проверить, как выглядит форма, достаточно открыть EPF-файл как обычную внешнюю обработку. Если форма должна вызываться из документа по кнопке «Печать», её регистрируют в справочнике дополнительных отчетов и обработок. А разработчику при отладке часто требуется программный вызов с передачей параметров.

Ниже разобраны все три сценария с конкретными действиями, условиями, при которых каждый из них работает, и типичными ошибками, из-за которых форма не открывается или открывается пустой.

Что такое внешняя печатная форма и когда у неё есть форма

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

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

Поэтому перед попыткой «открыть форму» полезно выяснить, есть ли она в принципе. Если в дереве обработки в конфигураторе нет ни одной формы, открывать нечего — обработка при запуске сразу выполнит код из модуля и, возможно, завершится без видимого результата.

Открытие EPF-файла напрямую через меню «Файл»

Самый простой способ посмотреть форму внешней печатной обработки — открыть её как файл. В режиме «Предприятие» выберите «Файл → Открыть» (в интерфейсе «Такси» — кнопка меню в левом верхнем углу, затем «Файл → Открыть») и укажите EPF-файл на диске. Платформа загрузит обработку и откроет её основную форму, если она назначена.

Если основная форма не задана, платформа попытается создать форму по умолчанию. У обработки без единой формы в дереве метаданных откроется пустое окно или появится ошибка — это нормальное поведение, а не признак повреждённого файла. Проверить состав обработки можно в конфигураторе: «Файл → Открыть» там тоже работает, и в дереве объекта видно все формы, макеты и модули.

1. 1
   Откройте 1С в режиме «Предприятие» под пользователем с достаточными правами
2. 2
   Выберите «Файл → Открыть» и укажите EPF-файл печатной формы
3. 3
   Подтвердите предупреждение безопасности, если оно появится
4. 4
   Проверьте, открылась ли форма настроек или сразу сформировался табличный документ
5. 5
   Если окно пустое — откройте файл в конфигураторе и убедитесь, что у обработки есть формы

Учтите ограничение прав: интерактивное открытие внешних обработок требует права «Интерактивное открытие внешних обработок». В типовых конфигурациях оно есть у полноправного пользователя, но у рядовых пользователей может быть отключено. В этом случае меню «Открыть» либо недоступно, либо файл не запускается.

Открытие через «Дополнительные отчеты и обработки»

Штатный рабочий сценарий — подключение печатной формы через подсистему «Дополнительные отчеты и обработки» (в типовых конфигурациях путь обычно «Администрирование → Печатные формы, отчеты и обработки»). После регистрации обработка появляется в меню «Печать» нужных документов, а её форма настроек открывается автоматически при выборе команды, если разработчик предусмотрел открытие формы перед формированием.

Чтобы зарегистрировать обработку, включите флаг «Дополнительные отчеты и обработки» в настройках, откройте одноимённый список, создайте новый элемент и загрузите EPF-файл. Конфигурация прочитает сведения из функции СведенияОВнешнейОбработке(): вид (должен быть «ПечатнаяФорма»), назначение (к каким документам привязана) и список команд. После записи элемента команда появится в кнопке «Печать» указанных документов.

Если команда в документе не появилась, проверьте три вещи: совпадает ли назначение обработки с типом документа, опубликована ли обработка (не стоит ли пометка «Отключено» или режим отладки), есть ли у пользователя право на выполнение дополнительных обработок. Также перезапустите сеанс — кэш команд печати иногда обновляется только при повторном входе.

Программное открытие формы из встроенного языка

Разработчику часто нужно открыть форму внешней печатной обработки программно — например, из другой обработки, при тестировании или для передачи параметров. Базовый приём — создать объект обработки и вызвать метод ПолучитьФорму():

Обработка = ВнешниеОбработки.Создать("C:\ПечатныеФормы\СчетНаОплату.epf");
Форма = Обработка.ПолучитьФорму("ФормаНастроек");
Форма.Открыть();

Если имя формы не указано, ПолучитьФорму() без параметра вернёт основную форму обработки. Передать параметры можно двумя способами: через свойства объекта обработки до получения формы (если в модуле объекта есть экспортные переменные или реквизиты) или через параметры формы, если она создана в управляемом режиме с объявленными параметрами.

В управляемом приложении для обработок, зарегистрированных в справочнике дополнительных обработок, удобнее открывать форму по навигационной ссылке или через ОткрытьФорму("ВнешняяОбработка.ИмяОбработки.Форма.ИмяФормы"). Этот вариант работает только для обработок, подключённых к информационной базе, — для файла на диске такая строка вызова недоступна.

Обработка = ВнешниеОбработки.Создать("C:\Forms\PrintForm.epf");
Форма = Обработка.ПолучитьФорму();
Форма.ОткрытьМодально();

Открытие формы в конфигураторе для редактирования

Чтобы изменить форму печатной обработки, откройте EPF-файл в конфигураторе через «Файл → Открыть». В дереве объекта раскройте ветку «Формы», выберите нужную и откройте её двойным щелчком. Для управляемых форм откроется редактор с деревом элементов, реквизитами и модулем формы; для обычных — конструктор формы старого вида.

Обратите внимание на тип формы до начала правок. Если конфигурация, в которой будет работать печатная форма, запускается только в управляемом приложении (большинство современных типовых решений), обычная форма в режиме «Такси» не откроется — её придётся пересоздавать как управляемую. Обратная ситуация встречается реже, но тоже возможна в старых конфигурациях на обычных формах.

После правок сохраните файл и проверьте его в режиме «Предприятие». Если обработка уже зарегистрирована в справочнике дополнительных обработок, не забудьте перезагрузить файл в элемент справочника — конфигурация хранит копию в базе и не отслеживает изменения исходного EPF на диске.

Типичные ошибки при открытии формы

Чаще всего пользователи и разработчики сталкиваются с небольшим набором повторяющихся проблем. Знание их признаков сильно сокращает время диагностики.

Отдельный случай — ошибка «Метод объекта не обнаружен» при вызове ВнешниеОбработки.Создать() на сервере в управляемом приложении. В серверном контексте тонкого и веб-клиента создание внешней обработки из файла требует передачи двоичных данных или использования хранилища, а интерактивное открытие формы возможно только на клиенте. Разделяйте код: файл читается и подключается там, где это разрешено, а форма открывается в клиентском контексте.

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

Как проверить, что всё работает правильно

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

Для программного сценария проверка проще: после вызова ПолучитьФорму() убедитесь, что возвращённое значение не Неопределено, а после Открыть() — что форма реально отображается пользователю. В отладчике конфигуратора поставьте точку останова в обработчике ПриОткрытии() формы — так вы увидите, доходит ли выполнение до формы и с какими параметрами.

Частые вопросы