Как создать внешнюю форму в 1С: пошаговое руководство

Внешняя форма в 1С — это форма, которая не хранится внутри конфигурации, а подключается из отдельного файла. Чаще всего она создаётся как часть внешней обработки или внешнего отчёта (файл с расширением .epf или .erf), но может выступать и как самостоятельный объект. Такой подход позволяет доработать типовую конфигурацию без её изменения, что критично для баз, находящихся на полной поддержке поставщика.

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

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

Что такое внешняя форма и когда она нужна

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

Типовые задачи, для которых применяют внешние формы:

• нестандартные печатные формы документов без изменения конфигурации;
• обработки для массовых операций: загрузка данных из Excel, групповое изменение реквизитов, заполнение табличных частей;
• диалоги с пользователем: выбор параметров перед выполнением операции;
• тестовые и сервисные инструменты разработчика, которые не должны попадать в конфигурацию.

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

Подготовка: что проверить перед началом работы

Перед созданием внешней формы убедитесь, что у вас есть необходимый доступ и инструменты:

• установленная платформа 1С:Предприятие той же версии (или совместимой), что и у рабочей базы;
• право запуска конфигуратора и право открытия внешних обработок в пользовательском режиме;
• понимание режима работы: файловая база или клиент-серверная — от этого зависят нюансы тестирования;
• режим совместимости конфигурации — он определяет, какие возможности платформы доступны в коде.

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

Создание внешней обработки в конфигураторе

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

Порядок создания файла:

1. В главном меню выберите «Файл → Новый» (или Ctrl+N).
2. В списке типов документов выберите «Внешняя обработка» и нажмите «ОК».
3. Откроется окно редактирования объекта: задайте имя обработки (например, ЗагрузкаЦенИзExcel) и синоним — понятное название для пользователя.
4. Сохраните файл: «Файл → Сохранить как», укажите папку и имя файла. Получится файл с расширением .epf.

1. 1
   Откройте конфигуратор и выберите «Файл → Новый»
2. 2
   Выберите тип «Внешняя обработка» и подтвердите
3. 3
   Задайте имя и синоним обработки
4. 4
   Сохраните файл .epf в рабочую папку
5. 5
   Добавьте форму (см. следующий раздел)

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

Добавление и настройка формы обработки

Форма добавляется в дереве объекта обработки. В окне редактирования внешней обработки перейдите на вкладку «Формы» (или найдите ветку «Формы» в дереве объекта) и нажмите кнопку добавления (значок «+» или пункт «Добавить» контекстного меню).

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

Элементы, реквизиты и команды формы

Логика управляемой формы строится на трёх составляющих:

• Реквизиты формы — данные, которые форма хранит и отображает (строки, даты, ссылки на справочники, таблицы значений);
• Элементы формы — визуальные компоненты: поля ввода, кнопки, таблицы, надписи, связанные с реквизитами;
• Команды формы — действия, привязанные к кнопкам, с обработчиками в модуле формы.

Типовая последовательность: сначала создайте реквизит (например, ПутьКФайлу типа «Строка»), затем перетащите его из панели реквизитов в дерево элементов — платформа автоматически создаст поле ввода. Для кнопки создайте команду (например, Загрузить), перетащите её в командную панель формы и напишите обработчик.

&НаКлиенте
Процедура Загрузить(Команда)
	Если ПустаяСтрока(ПутьКФайлу) Тогда
		Сообщить("Укажите путь к файлу");
		Возврат;
	КонецЕсли;
	ЗагрузитьНаСервере();
КонецПроцедуры

&НаСервере
Процедура ЗагрузитьНаСервере()
	// Серверная логика обработки данных
КонецПроцедуры

Обратите внимание на директивы компиляции &НаКлиенте и &НаСервере. В управляемой форме код делится между клиентом и сервером: работа с файловой системой пользователя — на клиенте, запросы к данным базы — на сервере. Прямой вызов серверных объектов из клиентского контекста вызовет ошибку.

Назначение основной формы обработки

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

Открытие и проверка в режиме 1С:Предприятие

Самый быстрый способ проверить форму — запустить целевую базу в режиме 1С:Предприятие и открыть файл через меню «Файл → Открыть» (Ctrl+O), указав сохранённый .epf. Если форма назначена основной, она откроется сразу.

Если при открытии появляется сообщение о нарушении прав доступа — у текущего пользователя нет права «Интерактивное открытие внешних обработок». Это типично для рядовых пользователей в настроенных конфигурациях; выдайте право в настройках ролей или подключите обработку штатным механизмом (см. следующий раздел).

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

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

Порядок подключения:

1. Откройте раздел «Администрирование → Печатные формы, отчеты и обработки» и включите флажок «Дополнительные отчеты и обработки».
2. Перейдите по ссылке «Дополнительные отчеты и обработки» и нажмите «Создать».
3. Укажите файл обработки. Если обработка содержит модуль регистрации (функция СведенияОВнешнейОбработке()), параметры заполнятся автоматически.
4. Настройте размещение (в каких разделах показывать команду) и права доступа, запишите элемент.

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

Типичные ошибки и их решение

Отдельно стоит упомянуть проблему совместимости версий платформы. Обработка, сохранённая в более новой версии платформы, может не открыться в старой. Старайтесь разрабатывать в версии платформы, не новее той, что используется на рабочих базах.

Альтернативы внешней обработке

Внешняя обработка — не единственный способ добавить интерфейс без изменения конфигурации. В зависимости от задачи рассмотрите варианты:

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

Часто задаваемые вопросы