Собрать файл по спецификации

Как собрать .epf или .erf по спецификации — что Studio делает по шагам, где искать сгенерированный код и что может остановить сборку.

Кнопка «Собрать .epf» («Собрать .erf» для отчёта) на этапе Spec1C применяет спецификацию, генерирует по ней запрос в модуль формы и упаковывает файл. Общие сведения о сборке — Собрать файл .epf или .erf; здесь — то, что относится именно к спецификации.

Когда это нужно#

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

Перед началом#

• Открыт файл обработки или отчёта; пробный период или тариф активен — иначе кнопка неактивна.
• В тексте нет ошибок разбора. Проще всего проверить заранее: «Ещё» → «Применить без сборки» — Применить спецификацию без сборки.
• В модели нет команд balance и turnovers: в облачной среде с ними сборка останавливается.

Шаги#

1. На этапе Spec1C нажмите «Собрать .epf» (или «Собрать .erf»). Та же кнопка есть на этапе Artifact.
2. Если Studio покажет окно подтверждения о генерации кода в модуль формы, нажмите «OK». «Отмена» прекращает сборку с уведомлением «Сборка отменена — модель неполная».
3. Дождитесь завершения — обычно десятки секунд.
4. Проверьте журнал: «✓ Spec1C → … выполнены в Smart1Spec Cloud» и «✓ Собрано: <имя>.epf — нажмите «Скачать»». Откроется этап Artifact.
5. Нажмите «Скачать .epf» — Скачать собранный файл.

Что Studio делает при сборке#

1. Применяет текст, если в редакторе есть неприменённые правки. При ошибке разбора сборка не начинается.
2. Сохраняет Intent и Spec1C в проекте.
3. Проверяет команды остатков и оборотов, если они есть в модели. Без конфигурации проверка не проходит, и сборка останавливается.
4. Генерирует запрос по источникам модели в зону модуля формы «Форма» — между строками // >>> SPEC1C_EMIT_BLANK_BEGIN и // <<< SPEC1C_EMIT_BLANK_END. Вид кода определяет target — Соответствие конструкций и BSL.
5. Упаковывает исходники в файл .epf / .erf.

Если в модели нет источников данных, шаги 3–4 пропускаются, и собираются исходники как есть.

Результат#

• Файл собран; в шапке — «Собрано», в строке состояния — «Сборка актуальна».
• Сгенерированный код есть только в собранном файле. Исходники проекта на этапе Source не меняются: зона генерации там остаётся шаблонной. Чтобы увидеть код, скачайте файл и откройте модуль формы в Конфигураторе. Подробнее о зоне генерации — Генерация BSL и зоны генерации.
• Генерация выполняется заново при каждой сборке по текущей модели. Не правьте на этапе Source код между маркерами: при сборке с источниками данных зона перезаписывается. Код вне зоны сохраняется.
• В сгенерированном коде есть служебные комментарии со старым названием продукта — на работу кода они не влияют.
• Успешная сборка не означает, что модуль скомпилируется и запрос выполнится в 1С. Проверьте файл по Проверить результат в 1С.

Если не получилось#

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