К статье
Практический материал

Другое · 11 мин

Куда писать код в 1С

Разберёмся, где в конфигурации 1С пишут программный код: модули объектов, формы, отчёты, обработки и общие модули, с примерами и проверкой результата.

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

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

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

Модули объектов и общие модули

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

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

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

Модули форм и управляемые формы

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

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

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

Отчёты и обработки

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

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

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

Код относится к данным объектаМодуль объекта

Проверяйте события записи, проведения и заполнения реквизитов

Код нужен только для интерфейсаМодуль формы

Смотрите события элементов и команды формы

Логика повторяется в разных объектахОбщий модуль

Выносите экспортируемые процедуры и вызывайте их по имени

Нужно вывести печатную форму или таблицуМодуль отчёта

Настраивайте наборы данных и компоновщик

Разовая задача без изменения конфигурацииВнешняя обработка или отчёт

Подключайте файл отдельно от основной конфигурации

Выбор места влияет на то, когда и как часто будет выполняться код. Модуль объекта срабатывает при работе с данными независимо от того, открыта ли форма пользователем. Модуль формы работает только при взаимодействии с конкретной формой. Общий модуль не выполняется сам по себе, его нужно вызывать из других модулей.

Внешние отчёты, обработки и дополнения

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

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

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

Порядок действий при добавлении кода

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

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

Порядок действий
  1. 1
    Определите событие и подходящий тип модуля
  2. 2
    Откройте модуль в конфигураторе и напишите код
  3. 3
    Проверьте синтаксис и сохраните изменения
  4. 4
    Обновите конфигурацию базы
  5. 5
    Протестируйте на копии базы с реальными данными

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

Частые ошибки и ограничения

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

Типичные ошибки
01
Бизнес-логика в модуле формы вместо модуля объекта — проверка не сработает при программном проведении
02
Вывод пользовательских сообщений из модуля объекта без контекста интерфейса
03
Дублирование одного и того же кода в модулях многих объектов вместо общего модуля

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

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

Контрольные точки

Как проверить результат

Код срабатывает в нужном событии
Норма

Данные меняются при записи, проведении или открытии формы

Тревожный признак

Изменений нет или код срабатывает в неподходящий момент

Отсутствие ошибок у других пользователей
Норма

Работа в базе продолжается без конфликтов

Тревожный признак

Появляются сообщения о блокировках или несоответствии конфигурации

Обработка некорректных данных
Норма

Пользователь получает понятное сообщение

Тревожный признак

База остаётся в неконсистентном состоянии или возникает необработанное исключение

Как проверить результат

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

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

Итог

Что важно запомнить

Код в 1С размещают в модуле объекта, формы, общем модуле, отчёте или обработке в зависимости от момента срабатывания; изменения тестируют на копии базы, а общую логику выносят в общие модули.

Часто задаваемые вопросы

Можно ли писать код напрямую в типовой конфигурации?

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

В чем разница между модулем объекта и модулем формы?

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

Когда стоит выносить код в общий модуль?

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

Нужно ли тестировать изменения на копии базы?

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

Что делать, если после сохранения модуля код не работает?

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

Может ли внешняя обработка изменить данные без прав пользователя?

Нет. Внешняя обработка работает от имени текущего пользователя и ограничена его правами доступа. Если пользователь не может просматривать или редактировать документ через интерфейс, обработка не сможет обойти эти ограничения только за счёт того, что код написан в модуле обработки.