Конструкторы в 1С: что это такое и как с ними работать

Конструкторы в 1С — это встроенные в конфигуратор визуальные помощники, которые генерируют готовый программный код или текст по настройкам, заданным в диалоговых окнах. Вместо того чтобы писать запрос, обработчик проведения или команду вывода печатной формы вручную, разработчик отвечает на вопросы мастера, а платформа формирует синтаксически корректный фрагмент кода. Это ускоряет работу и снижает количество ошибок в типовых операциях.

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

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

Какие конструкторы есть в 1С и для чего каждый нужен

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

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

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

Как открыть конструктор в конфигураторе

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

Некоторые конструкторы вызываются не из меню, а из свойств объекта. Например, конструктор печати запускается из палитры свойств справочника или документа по кнопке у соответствующего свойства, а конструктор движений — из закладки «Движения» в окне редактирования документа. Конструктор запроса также доступен при редактировании свойства «Текст запроса» в схеме компоновки данных.

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

1. 1
   Откройте модуль, куда нужно вставить запрос, и поставьте курсор в нужное место
2. 2
   Нажмите правую кнопку мыши и выберите «Конструкторы» → «Конструктор запроса»
3. 3
   Согласитесь на создание нового запроса, если платформа предложит выбор
4. 4
   Выберите таблицы, перетащите нужные поля, задайте условия и порядок
5. 5
   Нажмите «ОК» — текст запроса появится в модуле

Конструктор запроса: главный рабочий инструмент

Конструктор запроса открывается в виде окна с несколькими закладками. На закладке «Таблицы и поля» слева отображается дерево доступных объектов базы данных: таблицы документов, справочников, регистров, виртуальные таблицы остатков и оборотов. Выбранные таблицы переносятся в среднюю колонку, а из них — нужные поля в правую.

На закладке «Связи» настраиваются соединения таблиц: внутренние, левые, правые и полные. Закладка «Условия» позволяет задать отбор, причём вместо конкретных значений удобно использовать параметры через символ «&» — так запрос станет универсальным. Закладки «Группировка», «Итоги» и «Порядок» отвечают за агрегирование и сортировку результата.

Отдельная полезная возможность — конструктор запроса с обработкой результата. Он вызывается через «Конструкторы» → «Конструктор запроса с обработкой результата» и помимо текста запроса генерирует полный фрагмент кода: создание объекта «Запрос», установку параметров, выполнение и обход выборки в цикле. Для новичков это лучший способ увидеть, как запрос встраивается в программный код.

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Номенклатура.Ссылка ИЗ Справочник.Номенклатура КАК Номенклатура ГДЕ Номенклатура.Родитель = &Родитель";
Запрос.УстановитьПараметр("Родитель", ВыбраннаяГруппа);
Результат = Запрос.Выполнить().Выбрать();
Пока Результат.Следующий() Цикл
	// обработка строки
КонецЦикла;

Конструкторы печати и движений документов

Конструктор печати создаёт сразу два результата: макет табличного документа с областями «Шапка», «Строка» и «Подвал», и процедуру «Печать» в модуле объекта. В диалоге нужно выбрать реквизиты шапки и табличной части, которые попадут в форму. После генерации макет можно доработать визуально — изменить шрифты, ширину колонок, добавить логотип.

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

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

Когда конструктор помогает, а когда лучше писать вручную

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

Ручное написание предпочтительнее для сложных запросов: с пакетом временных таблиц, хитрыми соединениями, объединениями и оптимизацией производительности. Конструктор поддерживает не все возможности языка запросов, а сгенерированный код часто содержит избыточные конструкции, которые опытный разработчик сокращает. Кроме того, отладку сложного запроса удобнее вести в консоли запросов, а не в конструкторе.

Типичные ошибки при работе с конструкторами

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

Также начинающие забывают, что конструктор запроса подставляет имена полей по состоянию метаданных на момент генерации. Если позже реквизит переименуют, запрос перестанет работать, и ошибка проявится только при выполнении. Поэтому после изменения структуры метаданных полезно перепроверить запросы, которые её используют.

Как проверить, что сгенерированный код работает

После генерации запроса проверьте его на реальных данных: запустите процедуру в отладчике или перенесите текст в консоль запросов и выполните с теми же параметрами. Убедитесь, что выборка не пустая, поля заполнены ожидаемыми значениями, а итоги сходятся с данными в стандартных отчётах.

Для печатной формы сформируйте документ, заполненный тестовыми данными, и выведите печать: проверьте, что все реквизиты попали в макет, переносы строк не ломают верстку, а итоговые суммы совпадают с документом. Для движений проведите документ и откройте записи регистров — количество строк, знаки сумм и значения измерений должны соответствовать задуманной логике.

Частые вопросы о конструкторах в 1С