Как отредактировать модуль в 1С

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

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

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

Какие бывают модули и где их искать

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

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

Отличить модули по месту в дереве конфигурации просто: у документа «РеализацияТоваровУслуг» будут отдельно «Модуль объекта», «Модуль менеджера» и модули его форм. Общие модули находятся в ветке «Общие → Общие модули».

Подготовка: копия базы и права доступа

Первый обязательный шаг — сделать резервную копию. Для файловой базы достаточно скопировать каталог базы или выгрузить её через конфигуратор: «Администрирование → Выгрузить информационную базу». Для клиент-серверной базы выгрузку также делают через конфигуратор, но надёжнее дополнительно использовать штатные средства СУБД.

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

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

Открытие конфигуратора и поиск нужного модуля

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

Есть три рабочих способа найти нужный модуль:

1. По дереву конфигурации. Найдите объект (например, «Документы → РеализацияТоваровУслуг»), нажмите правой кнопкой мыши и выберите «Открыть модуль объекта» или откройте форму и перейдите на закладку «Модуль».
2. Полнотекстовый поиск по коду. Меню «Правка → Глобальная замена» или поиск по всем текстам (Ctrl+Shift+F): введите фрагмент сообщения об ошибке или название процедуры. Так находят, в каком общем модуле живёт нужная логика.
3. Через отладчик. Поставьте точку останова на предполагаемом месте или включите «Остановка по ошибке» — отладчик сам покажет модуль, где возникает проблема.

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

1. 1
   Сделайте резервную копию базы (выгрузка .dt или копия каталога)
2. 2
   Запустите базу в режиме конфигуратора и откройте конфигурацию
3. 3
   Найдите нужный объект и откройте его модуль через контекстное меню
4. 4
   Внесите изменения в код и проверьте синтаксис клавишей Ctrl+F7
5. 5
   Сохраните конфигурацию и обновите конфигурацию базы данных клавишей F7
6. 6
   Проверьте результат в режиме «Предприятие» на тестовом примере

Редактирование кода в модуле

Редактор модулей в 1С поддерживает подсветку синтаксиса, автоподстановку (Ctrl+Пробел), переход к определению процедуры (F12) и контекстную подсказку по встроенному языку. Код пишется на встроенном языке 1С, ключевые слова допустимы на русском и английском.

Типичная правка выглядит так: вы находите процедуру, добавляете условие или меняете расчёт. Например, в модуле объекта документа добавить проверку перед проведением:

Процедура ОбработкаПроведения(Отказ, РежимПроведения)

Если СуммаДокумента = 0 Тогда
Сообщить("Не заполнена сумма документа");
Отказ = Истина;
Возврат;
КонецЕсли;

// далее типовой код проведения

КонецПроцедуры

После правки нажмите Ctrl+F7 — конфигуратор выполнит синтаксический контроль модуля и укажет строку с ошибкой, если она есть. Проверка не гарантирует правильность логики, но отловит незакрытые «КонецЕсли», опечатки в именах и несоответствие параметров.

Полезные приёмы при редактировании: закомментируйте старый код вместо удаления (Ctrl+/), чтобы при откате видеть, что было; добавляйте короткие комментарии с причиной изменения; не переименовывайте типовые процедуры — добавляйте свои рядом.

// Проверка синтаксиса модуля: Ctrl+F7
// Обновление конфигурации базы данных: F7
// Пример обращения к общему модулю из модуля объекта:
ОбщегоНазначения.СообщитьПользователю("Проверка не пройдена", , , , Отказ);

Если конфигурация на поддержке: расширение или изменение

Типовые конфигурации (Бухгалтерия, Управление торговлей, ЗУП) поставляются на поддержке. Прямая правка их модулей требует включения возможности изменений: «Конфигурация → Поддержка → Настройка поддержки → Включить возможность изменения». Это усложнит будущие обновления: при каждом обновлении ваши правки придётся сопоставлять с изменениями поставщика вручную.

Современная альтернатива — расширение конфигурации. Расширение создаётся через «Конфигурация → Расширения конфигурации → Создать», позволяет заимствовать формы и процедуры и переопределять их с помощью аннотаций &ИзменениеИКонтроль, &Вместо, &Перед, &После. Основная конфигурация при этом не трогается и обновляется штатно.

Сохранение и обновление конфигурации базы данных

Изменения в конфигураторе сначала сохраняются только в конфигурацию разработки. Чтобы они заработали в режиме «Предприятие», нужно обновить конфигурацию базы данных: клавиша F7 или «Конфигурация → Обновить конфигурацию базы данных». Если менялась структура данных (добавлен реквизит), конфигуратор покажет окно реструктуризации — подтвердите список изменений.

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

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

Отладка изменений

Если после правки поведение не такое, как ожидалось, используйте отладчик. Включите его в конфигураторе: «Отладка → Подключение» и запустите отладку (F5) — откроется режим «Предприятие» под отладкой. Поставьте точку останова (F9) на строке в модуле и выполните действие в программе — выполнение остановится на вашей строке.

Дальше смотрите значения переменных через «Вычислить выражение» (Shift+F9) или табло, проходите код по шагам (F10 — через, F11 — внутрь процедуры). Это самый быстрый способ понять, почему условие не срабатывает или откуда берётся неожиданное значение.

Полезный приём для тонких мест — временно выводить значения через Сообщить() или в журнал регистрации через ЗаписьЖурналаРегистрации(). После диагностики отладочные сообщения удаляют, чтобы не засорять работу пользователей.

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