Первая обработка: от пустого файла до .epf

Создать пустую внешнюю обработку, дописать процедуру в модуль объекта, сохранить, собрать и скачать файл .epf, открыть его в 1С.

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

Что получится#

• Файл УчебнаяОбработка.epf в папке загрузок браузера.
• В модуле объекта этого файла — ваша процедура ПоказатьПриветствие с вызовом Сообщить.
• Понимание цикла: правка → «Сохранить BSL» → «Собрать .epf» → «Скачать .epf» → проверка в 1С.

Что понадобится#

• Аккаунт и проект — урок Регистрация и первый вход. В проекте не должно быть открытого файла: в навигаторе видны кнопки «Открыть файл», «Исходники», «Создать с нуля».
• Активный пробный период или тариф: без него создание файла и сборка недоступны (Продолжить работу после окончания пробного периода).
• 1С с тестовой базой, в которой можно открыть внешнюю обработку, — для последнего шага.
• Около пятнадцати минут.

Шаги#

Создайте обработку#

1. В навигаторе слева нажмите «Создать с нуля». Откроется окно «НОВЫЙ ВНЕШНИЙ ФАЙЛ».
2. В поле «Тип» оставьте «Обработка .epf».
3. В поле «Имя» замените «НоваяОбработка» на УчебнаяОбработка. Пишите имя без пробелов — так же, как имена объектов в 1С. Поля «Форма» и «Тип формы» менять нельзя: новый файл всегда создаётся с одной обычной формой.

   

4. Нажмите «Создать и открыть Spec1C». В строке состояния появится «Файл загружен», затем — «Исходники сохранены». Подготовка занимает около двадцати секунд. После этого под шапкой появится баннер «Загружена внешняя обработка УчебнаяОбработка.epf», а в навигаторе — дерево обработки.

Studio откроет этап Spec1C. В этом уроке спецификация не нужна: для нового файла генерация по Spec1C даёт только черновик запроса, а нам нужен предсказуемый код.

Измените модуль объекта#

5. В навигаторе в дереве «УчебнаяОбработка» нажмите «Модуль объекта». Откроется этап Source, вкладка «Модули», в редакторе — модуль объекта. В новом файле в нём только строки комментариев.
6. Щёлкните в конце текста модуля, нажмите Enter и введите процедуру:
   BSLКопировать

   Процедура ПоказатьПриветствие() Экспорт
       Сообщить("Привет из Smart1Spec Studio");
   КонецПроцедуры

   Над редактором появится кнопка «Сохранить BSL», а в строке состояния — «Есть несохранённые изменения».

7. Нажмите «Сохранить BSL». Кнопка сменится на неактивную «Сохранено», в строке состояния появится «Исходники сохранены», справа — «Требуется сборка», и появится уведомление «Изменения сохранены в проекте Smart1Spec. Чтобы получить обновлённый файл .epf/.erf, выполните сборку и скачайте результат.»

   

Соберите и скачайте файл#

8. На панели этапов нажмите «Artifact». Откроется карточка «ARTIFACT · .EPF».
9. Нажмите «Собрать .epf». В строке состояния появится «Разбираем файл в Cloud…», через несколько десятков секунд — «Сборка актуальна». В журнале под кнопками появится «✓ Собрано: УчебнаяОбработка.epf — нажмите «Скачать»», а в карточке — «Статус: ✓ Собрано — можно скачать».

   

10. Нажмите «Скачать .epf». Браузер сохранит файл УчебнаяОбработка.epf в папку загрузок.

Проверьте файл в 1С#

11. Откройте 1С в режиме Конфигуратора с вашей тестовой базой и выберите Файл → Открыть. Укажите скачанный файл УчебнаяОбработка.epf.
12. Откройте модуль объекта обработки и убедитесь, что в нём есть процедура ПоказатьПриветствие. Выполните проверку модуля средствами Конфигуратора.
13. Чтобы проверить файл в работе, откройте его в режиме 1С:Предприятие через Файл → Открыть и убедитесь, что 1С открывает обработку без сообщений об ошибках.

Процедура ПоказатьПриветствие экспортная, но в пустой обработке её никто не вызывает: она нужна как пример правки модуля. Вызвать её можно, например, из модуля формы в Конфигураторе или в Studio.

Если что-то пошло не так#

Что дальше#

• Изменение существующей обработки — тот же цикл для готовой обработки, загруженной с компьютера.
• Первая точечная правка с Помощником — замените фразу в этой процедуре с помощью Помощника.
• Проверить результат в 1С — подробнее о проверке результата в 1С.
• Artifact и облачная сборка — как устроена облачная сборка.
• Быстрый старт — первая спецификация на языке Spec1C.

Сверено с продуктом: 27.10.2026