Выбрать: Spec1C или правка BSL

Как решить, описывать изменение на Spec1C или править код BSL напрямую, — для нового файла, для загруженной обработки и для логики вне языка.

В Studio изменение можно описать двумя способами: спецификацией Spec1C, по которой при сборке генерируется запрос, или прямой правкой кода BSL на этапе Source. Они не взаимозаменяемы. Эта страница помогает выбрать способ под задачу; общие различия языков — Естественный язык, Spec1C и BSL.

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

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

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

Вспомните, что умеет Spec1C в облачной сборке:

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

Чего Spec1C не делает: не описывает бизнес-логику, обработчики событий, проведение, формы и их элементы; не восстанавливается из кода загруженного файла. Неподдерживаемые конструкции — Неподдерживаемые конструкции.

Шаги#

1. Определите, с каким файлом вы работаете: новый, созданный в Studio кнопкой «Создать с нуля», или существующий, загруженный кнопкой «Открыть файл».
2. Определите, что меняете: запрос к данным или логику и интерфейс.
3. Найдите свою ситуацию в таблице ниже и выберите способ.
4. Если выбрали правку BSL — откройте модуль на этапе Source, измените и сохраните его кнопкой «Сохранить BSL» (Сохранить изменения BSL), затем соберите файл.
5. Если выбрали Spec1C — опишите данные (Создать спецификацию с нуля), соберите файл (Собрать файл по спецификации) и доработайте сгенерированный запрос в Конфигураторе.

Результат#

Вы выбрали способ, который даёт предсказуемый результат для вашего файла.

Что происходит при генерации в существующий файл#

Если в загруженной обработке описать в спецификации блок data и собрать файл, Studio:

• покажет окно подтверждения: модель неполная относительно загруженного файла, будет сгенерирован код в модуль формы;
• допишет в собранный файл зону сгенерированного кода в модуль формы с именем «Форма»; если маркеров зоны в модуле нет, зона добавляется в конец модуля;
• не свяжет сгенерированную процедуру Сформировать с кнопками вашей формы — вызывать её нужно самостоятельно;
• не изменит исходники на этапе Source — зона появится только в собранном файле (Генерация BSL и зоны генерации).

Отсюда риски: если в модуле формы уже есть процедура Сформировать, в 1С ожидаема ошибка компиляции из-за повторного имени; если формы с именем «Форма» в файле нет, сборка с источниками данных может не выполниться. Поэтому для существующих файлов надёжнее правка BSL.

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

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