Разработка и Конфигурация · 10 мин
Как подключить внешние формы в 1С: практическое руководство
Как подключить внешние формы 1С: открытие EPF-обработок, регистрация в справочнике дополнительных отчетов, настройка безопасного режима и типичные ошибки.
Внешние формы в 1С — это обработки и отчеты, которые хранятся в отдельных файлах (обычно с расширением .epf для обработок и .erf для отчетов) и подключаются к конфигурации без ее изменения. Такой подход позволяет расширять функциональность типовых решений, не снимая их с поддержки и не рискуя потерять доработки при обновлении.
Существует два принципиально разных способа работы с внешними формами: разовое открытие файла через меню «Файл — Открыть» и постоянная регистрация в справочнике дополнительных отчетов и обработок. Первый подходит для тестирования и разовых операций, второй — для регулярного использования сотрудниками.
Выбор способа зависит от режима работы базы (файловый или клиент-серверный), версии платформы, наличия подсистемы «Дополнительные отчеты и обработки» из Библиотеки стандартных подсистем и требований безопасности. Ниже разобраны оба сценария с проверками результата и типичными ошибками.
Что такое внешние формы и когда они нужны
Внешняя обработка (.epf) — это самостоятельный файл, содержащий форму, программный код и, при необходимости, макеты. Внешний отчет (.erf) устроен аналогично, но ориентирован на формирование печатных форм и аналитических данных. Оба типа файлов запускаются поверх существующей конфигурации и имеют доступ к ее данным в рамках прав текущего пользователя.
Типичные сценарии применения: массовая загрузка данных из Excel, групповое изменение реквизитов, нестандартные печатные формы, свертка базы, перенос данных между конфигурациями, обмен с внешними системами. Многие сервисные обработки распространяются свободно или поставляются франчайзи.
Важно понимать: внешняя форма выполняется с правами запустившего ее пользователя. Если у пользователя нет прав на документы, обработка не сможет их изменить — и это нормальное ограничение, а не ошибка подключения.
Разовое открытие внешней формы через меню «Файл»
Самый быстрый способ проверить обработку — открыть ее напрямую. В тонком клиенте или веб-клиенте выберите в главном меню «Файл — Открыть» (в старых интерфейсах — через кнопку «Все функции» или стандартное меню приложения) и укажите путь к файлу .epf или .erf. Форма откроется в отдельном окне.
Если при открытии появляется предупреждение безопасности «Рекомендуется обратить внимание на источник, из которого был получен данный файл», это стандартная реакция платформы. Подтверждайте открытие только для файлов, происхождение которых вам известно.
- 1Сохраните файл .epf/.erf в доступную папку на компьютере или сетевом диске
- 2Запустите 1С:Предприятие и войдите в нужную базу
- 3Откройте меню «Файл — Открыть» и укажите путь к файлу
- 4Подтвердите открытие при появлении предупреждения безопасности
- 5Проверьте, что форма открылась и корректно отображает данные
Разовое открытие не требует административных прав в конфигурации, но при закрытии сеанса обработка «забывается» — для повторного запуска файл нужно открывать заново. Поэтому для регулярной работы этот способ неудобен.
Постоянное подключение через «Дополнительные отчеты и обработки»
В типовых конфигурациях на базе Библиотеки стандартных подсистем (Управление торговлей, ERP, Бухгалтерия предприятия, ЗУП и другие) есть штатный механизм регистрации внешних форм. Перейдите в раздел «Администрирование — Печатные формы, отчеты и обработки» и включите флажок «Дополнительные отчеты и обработки», если он еще не установлен.
После включения опции перейдите по ссылке «Дополнительные отчеты и обработки», нажмите «Добавить из файла» и выберите ваш .epf или .erf. Система прочитает сведения о внешней форме из ее модуля: наименование, вид, версию, назначение (разделы командного интерфейса, где появится команда запуска).
Если обработка написана по стандарту БСП, регистрация проходит автоматически: команда появится в указанных разделах, а права на запуск настраиваются через кнопку «Быстрый доступ к команде». Если обработка не содержит функции СведенияОВнешнейОбработке, система зарегистрирует ее с ограниченными параметрами, и часть настроек придется указать вручную.
Настройка безопасного режима и профилей безопасности
В файловом режиме внешние обработки выполняются с полными возможностями встроенного языка. В клиент-серверном варианте и особенно в сервисах (облачных базах) действует безопасный режим: обработке запрещены операции с файловой системой сервера, COM-объектами, внешними компонентами и запуском приложений.
Если обработка использует такие возможности, при запуске вы увидите ошибку вида «Операция не разрешена в безопасном режиме». Решение — настройка профилей безопасности в консоли кластера серверов 1С: администратор создает профиль, в котором явно перечислены разрешенные операции, и привязывает его к информационной базе или конкретным внешним модулям.
Признак корректной настройки: обработка запускается у пользователей с целевыми правами, выполняет свои операции и не выдает ошибок безопасности в журнале регистрации.
Подключение внешних печатных форм к документам
Частный и очень распространенный случай — внешняя печатная форма, которая должна появиться в меню «Печать» конкретного документа. Такая обработка регистрируется в том же справочнике дополнительных отчетов и обработок, но ее вид указывается как «Печатная форма», а в табличной части «Принадлежность» перечисляются объекты конфигурации (например, «Документ.РеализацияТоваровУслуг»).
Если печатная форма написана по стандарту БСП, принадлежность заполняется автоматически из сведений обработки. Если нет — добавьте нужные документы вручную в карточке зарегистрированной обработки. После записи новая команда появится в подменю «Печать» выбранных документов.
Как проверить результат
Новая печатная форма видна и формирует документ без ошибок
Команды нет или при формировании возникает ошибка метаданных
Обработка открывается и работает в рамках прав пользователя
Ошибка «Нарушение прав доступа» или пустая команда
Нет ошибок безопасного режима после запуска
Повторяющиеся ошибки «операция не разрешена»
Типичные ошибки и их устранение
Чаще всего подключение не удается из-за несоответствия обработки версии конфигурации: код обращается к переименованным или удаленным объектам метаданных. Ошибка вида «Поле объекта не обнаружено» при запуске означает именно это — нужна актуальная версия обработки под ваш релиз.
Вторая группа проблем — права доступа. Обработка открывается, но не видит данные или не сохраняет изменения. Проверьте права пользователя на соответствующие объекты: внешняя форма не расширяет права, а работает в их рамках.
Альтернативы: расширения конфигурации
Если внешняя форма нужна постоянно и тесно интегрирована с интерфейсом, рассмотрите механизм расширений конфигурации (.cfe). Расширение подключается через «Все функции — Стандартные — Управление расширениями конфигурации», позволяет добавлять собственные формы, роли и подсистемы, при этом конфигурация остается на поддержке.
Сравнение вариантов
Подходит для тестов и разовых операций; не требует прав администратора, но неудобно при регулярном использовании
Штатный способ для типовых конфигураций; файл хранится в базе, настраиваются права и разделы; требует подсистемы БСП
Для глубокой интеграции интерфейса и логики; требует навыков разработки и контроля совместимости при обновлениях
Для нетиповых и старых конфигураций без подсистемы БСП остаются два пути: разовое открытие файлов или добавление обработки в состав конфигурации через конфигуратор (с частичным снятием с поддержки).
Что важно запомнить
Для разовой работы внешнюю форму открывают через «Файл — Открыть», для постоянной — регистрируют в справочнике дополнительных отчетов и обработок. Проверяйте источник файла, соответствие версии конфигурации, права пользователей и поведение в безопасном режиме.
Часто задаваемые вопросы
Почему внешняя обработка не открывается с ошибкой «Файл не обнаружен»?
Проверьте путь к файлу и его доступность: при работе в терминальном или веб-клиенте путь должен быть доступен с того компьютера, где выполняется открытие. Надежнее зарегистрировать обработку в справочнике дополнительных обработок — тогда файл хранится внутри базы и не зависит от локальных папок.
Можно ли подключить внешнюю печатную форму в файловой базе без прав администратора?
Регистрация в справочнике дополнительных отчетов и обработок требует соответствующего права, поэтому без администратора можно только открыть файл разово через «Файл — Открыть». Для постоянного подключения обратитесь к пользователю с административными правами.
Чем отличается файл .epf от .erf?
EPF — внешняя обработка, предназначенная для выполнения действий и интерактивной работы через форму. ERF — внешний отчет, ориентированный на построение отчетов, часто на СКД. Подключаются оба типа одинаково, различие важно при регистрации: вид определяет, в каких разделах появится команда.
Безопасно ли запускать обработки, скачанные из интернета?
Только после проверки. Внешняя обработка — это исполняемый код, который может читать и изменять данные базы. Минимальная мера — запуск на копии базы и просмотр модуля в конфигураторе. Файлы из неизвестных источников, требующие отключения безопасного режима, запускать не следует.
Почему после обновления конфигурации внешняя печатная форма перестала работать?
При обновлении могли измениться имена объектов, реквизитов или модулей, к которым обращается обработка. Откройте текст ошибки, найдите указанный объект и запросите у автора обработки версию, совместимую с новым релизом, либо адаптируйте код самостоятельно при наличии навыков.
Как убрать зарегистрированную внешнюю обработку из базы?
Откройте справочник «Дополнительные отчеты и обработки», найдите нужный элемент и пометьте его на удаление или снимите публикацию через команду «Снять с публикации». Команда запуска исчезнет из интерфейса пользователей, а сам файл перестанет быть доступен.