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

Другое · 6 мин

Программирование в 1С: как выглядит код и где его писать

Программирование в 1С ведётся во встроенном языке в конфигураторе: модули, формы, запросы, отладка. Разберём вид кода и безопасные изменения.

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

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

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

Где пишутся программы в 1С

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

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

Сценарий: модуль объекта

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

Сценарий: модуль формы

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

Как выглядит код на встроенном языке

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

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

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

Типичные ошибки
01
Правка кода напрямую в рабочей базе без копии может привести к потере данных или остановке учёта.
02
Изменение модуля без учёта клиентского или серверного контекста вызывает ошибки при выполнении на других рабочих местах.

Модули объектов, форм, сервера и клиента

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

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

От обычных форм к управляемым приложениям

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

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

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

Проверка и отладка

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

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

Безопасные изменения и обновления

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

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

Итог

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

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

Нужен ли отдельный текстовый редактор для программирования в 1С?

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

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

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

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

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

Что делать, если после обновления конфигурации перестал работать свой код?

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