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

Другое · 6 мин

Как писать на 1С: основы разработки в конфигураторе

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

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

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

Типичные ошибки
01
Правка типовой конфигурации без расширения усложняет обновления
02
Отсутствие резервной копии перед структурными изменениями
03
Проверка кода только в рабочей базе без копии

Откуда начинается работа с конфигурацией

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

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

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

Модуль объекта

Подходит для логики записи и проведения, ограничен контекстом объекта

Общий модуль

Удобен для повторно используемого кода, требует явного вызова из других модулей

Модуль формы

Решает задачи интерфейса, не подходит для серверной обработки данных без вызова серверных процедур

Основные объекты и модули для кода

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

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

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

Как писать процедуру и функцию

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

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

Работа с данными и запросами

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

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

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

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

Компиляция конфигурации
Норма

Ошибок синтаксиса нет

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

Есть неисправленные ошибки компиляции

Работа на копии базы
Норма

Действия завершаются корректно

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

Данные искажены или процесс завершается с ошибкой

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

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

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

Ограничения и безопасная работа

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

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

Сравнение подходов к размещению кода

Итог

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

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

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

Нужно ли знать SQL для работы с запросами в 1С?

Знание стандартного SQL не требуется, так как используется язык запросов платформы 1С. Полезно понимать принципы соединения таблиц, фильтрации и группировки данных.

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

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

Где лучше писать общую логику для нескольких документов?

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

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

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

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

Да, особенно при изменении проведения, регистров и прав доступа. Тестирование на копии снижает риск повреждения рабочих данных и отчётности.