Разработка и Конфигурация · 9 мин
Как загрузить форму в 1С: практическое руководство
Разбираем, как загрузить форму в 1С: открытие внешних обработок и отчётов, загрузка формы из файла и макета, типичные ошибки и способы их устранения.
Фраза «загрузить форму в 1С» на практике означает несколько разных задач: открыть внешнюю обработку или отчёт из файла, подключить внешнюю печатную форму к документу, загрузить форму из макета при разработке или восстановить форму после ошибки «Ошибка загрузки формы». Порядок действий зависит от того, кто вы — пользователь, которому нужно запустить файл .epf или .erf, или разработчик, работающий в конфигураторе.
Ниже разобраны все основные сценарии: от простого открытия файла через меню до программной загрузки формы и устранения типичных сбоев. Инструкции справедливы для платформы 1С:Предприятие 8.3 и типовых конфигураций на управляемых формах.
Перед любыми действиями с файлами из внешних источников убедитесь, что они получены из надёжного места: внешние обработки выполняются с правами текущего пользователя и могут изменять данные информационной базы.
Определите, какой именно сценарий вам нужен
Термин «форма» в 1С охватывает несколько объектов, и от типа задачи зависит инструмент. Внешняя обработка (файл .epf) и внешний отчёт (файл .erf) открываются напрямую из файла. Печатная форма для документа подключается через механизм дополнительных отчётов и обработок. Форма объекта конфигурации загружается в конфигураторе или вызывается программно из встроенного языка.
Отдельный случай — ошибка при открытии формы, когда платформа сообщает о невозможности загрузки. Это уже не загрузка, а диагностика: причины обычно связаны с повреждением кэша, несовместимостью версий или правами доступа.
Как выбрать действие
Открываем внешнюю обработку или отчёт из файла
Самый частый сценарий — запуск внешней обработки. В режиме 1С:Предприятие откройте главное меню (кнопка с оранжевым значком в левом верхнем углу), выберите «Файл → Открыть» и укажите путь к файлу с расширением .epf (обработка) или .erf (отчёт). После подтверждения форма обработки появится на экране.
Платформа может показать предупреждение о безопасности при открытии файлов из недоверенных источников. Если файл получен от поставщика или скачан из сети, открывайте его только после проверки — обработка выполняется с вашими правами и теоретически может изменить или удалить данные.
Если после открытия форма не появилась, проверьте, не заблокировано ли окно модальным диалогом, и посмотрите панель открытых окон. Некоторые обработки написаны под обычные формы и в управляемом интерфейсе не запустятся — об этом скажет сообщение об ошибке вида «Обычные формы не поддерживаются».
- 1Сохраните файл .epf или .erf в доступную папку, например «Документы»
- 2В 1С:Предприятии откройте главное меню → «Файл» → «Открыть»
- 3Укажите файл и подтвердите открытие
- 4При предупреждении безопасности оцените источник файла и подтвердите запуск
- 5Проверьте, что форма обработки открылась и реагирует на действия
Подключаем форму через «Дополнительные отчеты и обработки»
Если обработкой или внешней печатной формой пользуются постоянно, открытие через «Файл → Открыть» неудобно. В типовых конфигурациях (Бухгалтерия предприятия, Управление торговлей, Зарплата и управление персоналом) есть подсистема «Дополнительные отчеты и обработки», которая регистрирует файл в базе и выводит команду его запуска в интерфейс.
Путь к настройке: «Администрирование → Печатные формы, отчеты и обработки». Включите флажок «Дополнительные отчеты и обработки», затем перейдите по одноимённой ссылке. Нажмите «Добавить из файла», выберите файл обработки — конфигурация прочитает сведения из него и предложит варианты размещения: в каких разделах показывать команду и для каких документов доступна печатная форма.
После записи обработка хранится внутри информационной базы, исходный файл больше не нужен. Команда запуска появится в разделе, который вы указали при размещении, а печатная форма — в меню «Печать» соответствующего документа.
Загружаем форму в конфигураторе и программно
Разработчику форма объекта доступна в конфигураторе: в дереве конфигурации откройте нужный объект (справочник, документ, обработка), перейдите на вкладку «Формы» и добавьте новую или откройте существующую. Конструктор форм позволяет создать форму по шаблону, после чего её можно доработать визуально и в модуле.
Программная загрузка формы выполняется методом глобального контекста ПолучитьФорму(). Для внешних обработок предварительно подключают файл через ВнешниеОбработки.Создать() с указанием пути, после чего вызывают форму созданного объекта. Ниже приведён типовой фрагмент кода.
// Подключение внешней обработки и открытие её формы
Обработка = ВнешниеОбработки.Создать("C:\Обработки\МояОбработка.epf", Ложь);
Форма = Обработка.ПолучитьФорму("Форма");
Форма.Открыть();
// Открытие формы объекта конфигурации
ОткрытьФорму("Справочник.Номенклатура.ФормаОбъекта");
Метод ПолучитьФорму() без параметров возвращает основную форму объекта, с именем — конкретную форму. Для управляемых форм альтернативой служит ОткрытьФорму() с полным именем формы и структурой параметров, что предпочтительнее в клиент-серверном коде.
Решаем ошибку «Ошибка загрузки формы»
Если при открытии объекта платформа сообщает об ошибке загрузки формы, начинайте с простых причин. Наиболее частая — повреждённый кэш метаданных на клиенте: форма хранится в кэше, и при рассинхронизации версий возникает сбой. Очистите кэш, удалив базу из списка и добавив её заново, либо очистив папки кэша в каталоге пользователя.
Вторая причина — несовместимость версий: форма сохранена в более новой версии платформы или конфигурации, чем установлена у вас. Проверьте версию платформы (меню «Сервис → О программе») и сопоставьте с требованиями файла или обновления конфигурации.
Третья группа причин — права и лицензии. Если у пользователя нет прав на объект, форма не откроется; сообщение обычно прямо указывает на нарушение прав. Для внешних обработок дополнительно проверьте, не запрещено ли их выполнение настройками безопасности кластера или профилем безопасности.
Проверяем результат и ограничения
Признак успешной загрузки — форма открылась, отображает элементы управления и реагирует на действия без сообщений об ошибках. Для подключённых дополнительных обработок проверьте, что команда появилась в указанном разделе и у пользователя с типовыми правами она доступна.
Учитывайте ограничения сценариев. В файловом варианте базы внешние обработки работают иначе, чем в клиент-серверном: путь к файлу должен быть доступен с компьютера, где выполняется код. В веб-клиенте часть возможностей (работа с локальными файлами без расширения, некоторые COM-объекты) недоступна, и обработка может открыться, но не выполнить свои функции.
Как проверить результат
Форма обработки отображается и работает
Сообщение об ошибке формата или пустое окно
Команда появилась в разделе, печатная форма — в меню «Печать»
Файл отклонён при добавлении или команда не видна пользователям
Форма открывается без исключений, параметры передаются
Исключение «Форма не найдена» или ошибка прав доступа
Частые вопросы о загрузке форм в 1С
Чем отличаются файлы .epf и .erf?
Файл .epf — это внешняя обработка, .erf — внешний отчёт. Обработки выполняют произвольные действия с данными, отчёты ориентированы на формирование результата через систему компоновки данных. Открываются оба типа одинаково — через «Файл → Открыть» или подключение в дополнительных отчётах и обработках.
Почему обработка открывается у администратора, но не у пользователя?
Чаще всего дело в правах: у пользователя нет роли, разрешающей выполнение дополнительных отчётов и обработок, либо при подключении обработки не настроен список пользователей или разделов. Проверьте права в настройках обработки и профиль группы доступа пользователя.
Можно ли загрузить форму в 1С через веб-браузер?
Да, если база опубликована на веб-сервере и вы работаете в веб-клиенте. Открытие внешних файлов потребует установки расширения для работы с файлами в браузере. Часть функциональности обработок, завязанная на локальный компьютер, в веб-клиенте может быть недоступна.
Что делать, если файл обработки «не виден» в диалоге открытия?
Проверьте фильтр типа файлов в диалоге — по умолчанию могут отображаться только .epf, а у вас файл .erf, или наоборот. Переключите фильтр на «Все файлы». Также убедитесь, что файл не находится в ZIP-архиве: сначала распакуйте его.
Безопасно ли открывать обработки, полученные по почте?
Только если вы доверяете отправителю и ожидали этот файл. Внешняя обработка исполняет встроенный код 1С с вашими правами и может изменять или удалять данные базы. При сомнениях попросите разработчика просмотреть модуль объекта в конфигураторе до первого запуска на рабочей базе.
Как обновить уже подключённую дополнительную обработку?
Откройте справочник «Дополнительные отчеты и обработки», найдите нужный элемент и используйте команду загрузки новой версии из файла. Старая версия заменится новой, настройки размещения и прав, как правило, сохраняются.
Что важно запомнить
Разовый запуск формы — через «Файл → Открыть», постоянное использование — через «Дополнительные отчеты и обработки», разработка — в конфигураторе или методами ПолучитьФорму() и ОткрытьФорму(). При ошибке загрузки сначала очищайте кэш и проверяйте права, а внешние файлы запускайте только из доверенных источников.