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

Другое · 7 мин

Как упорядочить код в 1С: структура модулей и именование

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

Упорядоченный код в 1С:Предприятии облегчает поддержку, снижает количество ошибок при доработках и ускоряет ввод новых сотрудников в проект. Беспорядок в модулях обычно проявляется в длинных процедурах, дублировании логики и смешении клиентского и серверного кода.

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

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

Определите границы модулей и подсистем

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

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

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

Согласуйте имена и порядок объявлений

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

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

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

Разделяйте клиентский и серверный код

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

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

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

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

Выносите общую логику в общие модули

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

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

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

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

Документируйте изменения и настройте регламент проверки

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

Сравнение вариантов

Ручной обзор кода

Подходит для небольших команд и редких изменений, требует времени и внимания автора.

Автоматизированная проверка синтаксиса и компиляция

Позволяет быстро выявить ошибки, но не заменяет оценку логики и архитектуры.

Перед вводом в эксплуатацию проверяйте код в изолированной базе или копии информационной базы. Запустите типичные сценарии: создание документа, проведение, закрытие месяца, работу с отчётами. Если после правки появляются предупреждения компиляции или некорректные расчёты, верните предыдущую версию и проанализируйте причину.

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

Итог

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

Упорядоченный код в 1С строится на чётких границах модулей, едином именовании, разделении клиентского и серверного кода, выносе общей логики и регулярной проверке изменений.

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

Нужно ли выносить весь повторяющийся код в общие модули?

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

Как понять, что модуль стал слишком большим?

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

Можно ли смешивать клиентский и серверный код в одной процедуре?

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

Как проверить, что переименование общего модуля не сломало конфигурацию?

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

Кто должен отвечать за порядок кода в команде?

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