Создать спецификацию с нуля

Чек-лист создания спецификации с нуля — от проекта и пустого файла до сборки и проверки в 1С, с условиями для каждой цели.

Эта страница — чек-лист для самостоятельной работы: от пустого проекта до собранного файла, сгенерированного по вашей спецификации. Если вы делаете это впервые, сначала пройдите Быстрый старт — там те же шаги с пояснениями.

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

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

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

Что понадобится, зависит от цели:

Шаги#

1. Проект. Создайте или откройте проект — Создать проект, Найти и открыть проект.
2. Файл. В навигаторе нажмите «Создать с нуля», выберите «Обработка .epf» или «Отчёт .erf», введите имя и нажмите «Создать и открыть Spec1C» — Создать новую обработку или отчёт. Через некоторое время появится «Исходники сохранены» и откроется этап Spec1C. Флажок «Начать с примера Spec1C» в облачной среде неактивен — текст пишется вручную.
3. Минимальная спецификация. Замените текст в редакторе минимальной спецификацией (пример ниже). Подставьте свой объект и поля так, как они называются в вашей конфигурации.
4. Конструкции. Добавляйте по одной и применяйте после каждой: соединение и период — Добавить соединение и отбор по периоду, поля и заголовок — Изменить заголовок, параметры и поля. Остатки и обороты регистров в облачной среде не собираются.
5. Применение. Нажмите «Ещё» → «Применить без сборки». Должно появиться «Spec1C → модель · источников N» — Применить спецификацию без сборки.
6. Проверка модели. Нажмите «Ещё» → «Проверить модель Spec1C». Замечание «Конфигурация не загружена…» в облачной среде появляется всегда и сборке не мешает — Проверить модель.
7. Сборка. Нажмите «Собрать .epf» (для отчёта «Собрать .erf»), подтвердите генерацию кода, если Studio спросит, и дождитесь «✓ Собрано: <имя>.epf — нажмите «Скачать»» — Собрать файл по спецификации.
8. Скачивание. Нажмите «Скачать .epf» — файл сохранится в папку загрузок браузера — Скачать собранный файл.
9. Проверка в 1С. Откройте файл в Конфигураторе, посмотрите модуль формы и выполните обработку — Проверить результат в 1С.

Минимальная спецификация:

spec1c {
  report blank
    title:  "МояОбработка"
    target: ordinary

  data {
    main = Справочник.Номенклатура
      fields: Ссылка, Код
  }
}

Больше готовых примеров — Библиотека примеров.

Результат#

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

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

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