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

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

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

Где находится конструктор движения регистров

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

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

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

Пошаговый порядок открытия конструктора

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

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

Открытие из модуля объекта

Если окно редактирования объекта уже закрыто, а модуль документа открыт, конструктор вызывается быстрее: меню «Текст» → «Конструкторы» → «Конструктор движений» или через контекстное меню. Курсор должен стоять в теле процедуры ОбработкаПроведения, иначе пункт меню будет недоступен.

Настройка правила движения в окне конструктора

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

Соответствие полей конструктор заполняет автоматически по совпадению имён и типов, но автоподбор всегда нужно проверять. Частая ситуация: реквизит документа называется «Товар», а измерение регистра — «Номенклатура»; автоматического сопоставления не произойдёт, и поле придётся указать вручную через выбор из списка реквизитов.

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

Что конструктор пишет в модуль документа

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

// регистр ОстаткиТоваров Приход
Движения.ОстаткиТоваров.Записывать = Истина;
Для Каждого ТекСтрокаТовары Из Товары Цикл
	Движение = Движения.ОстаткиТоваров.Добавить();
	Движение.ВидДвижения = ВидДвиженияНакопления.Приход;
	Движение.Период = Дата;
	Движение.Номенклатура = ТекСтрокаТовары.Номенклатура;
	Движение.Склад = Склад;
	Движение.Количество = ТекСтрокаТовары.Количество;
КонецЦикла;

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

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

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

Большинство проблем возникает не в момент открытия конструктора, а на этапе настройки правил и последующего проведения документа. Знание типовых сценариев экономит время отладки.

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

Проверка результата после генерации кода

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

Затем откройте движения документа: в форме документа — «Ещё» → «Движения документа» либо через соответствующий регистр. Сверьте, что записи созданы по всем ожидаемым регистрам, измерения заполнены, а вид движения и количество соответствуют данным документа.

Когда конструктор не подходит и что использовать вместо него

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

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

Частые вопросы