Другое · 6 мин
Как писать на 1С: основы разработки в конфигураторе
Как писать на 1С: основы языка встроенной версии, модули, запросы, отладка и безопасная работа с конфигурацией для начинающих разработчиков и примеры.
Разработка на платформе 1С:Предприятие ведётся в конфигураторе на встроенном языке. Первым шагом обычно становится создание или открытие информационной базы, переход в режим конфигурирования и изучение дерева объектов. Без понимания структуры конфигурации сложно определить, где именно нужно писать код: в модуле объекта, модуле формы, общем модуле или запросе.
Язык встроенной версии 1С процедурный, с поддержкой функций, процедур, переменных и встроенных типов данных. Синтаксис подсказывается встроенным помощником, а проверка правильности выполняется при компиляции конфигурации. Ошибки на этом этапе проще исправить, чем проблемы, обнаруженные уже в работе с пользователями.
Откуда начинается работа с конфигурацией
Конфигуратор открывается от имени пользователя с соответствующими правами. Перед началом изменений рекомендуется определить, будет ли конфигурация стандартной или уже модифицированной. Прямое редактирование типовой конфигурации может усложнить последующие обновления, поэтому часто целесообразнее использовать расширения или собственную конфигурацию.
В дереве конфигурации находятся справочники, документы, регистры, отчёты, обработки и другие объекты. У каждого объекта есть свои модули: модуль объекта, модуль менеджера, модуль формы и т. д. Выбор модуля зависит от того, какой логике нужно добавить код: работе с данными, отображению формы или серверным вычислениям.
Сравнение вариантов
Подходит для логики записи и проведения, ограничен контекстом объекта
Удобен для повторно используемого кода, требует явного вызова из других модулей
Решает задачи интерфейса, не подходит для серверной обработки данных без вызова серверных процедур
Основные объекты и модули для кода
Справочники и документы часто требуют заполнения реквизитов, проведения движений и контроля заполнения. Код в модуле объекта срабатывает при создании, записи, удалении и проведении. Модуль формы отвечает за поведение интерфейса: открытие формы, нажатие кнопок, изменение полей.
Общие модули подходят для кода, который используется в нескольких местах конфигурации. Процедуры и функции в общих модулях могут быть экспортированными, то есть доступными из других модулей. Это помогает избежать дублирования одной и той же логики в разных объектах.
- 1Определите объект и модуль для размещения логики
- 2Напишите процедуру или функцию с нужными параметрами
- 3Выполните проверку синтаксиса и компиляцию конфигурации
- 4Проверьте результат на копии информационной базы
Как писать процедуру и функцию
Процедура описывается ключевым словом Процедура, функция — Функция. Параметры указываются в скобках, а тип возвращаемого значения для функции указывается после двоеточия. Ключевое слово Экспорт делает процедуру или функцию видимой за пределами модуля.
Пример структуры на встроенном языке: процедура принимает параметр, выполняет проверку условия и выводит сообщение. Функция вычисляет значение и возвращает результат. Комментарии начинаются с двух косых черт и помогают другим разработчикам понять намерения автора.
Работа с данными и запросами
Для выборки данных используется язык запросов 1С. Запрос позволяет получать данные из нескольких таблиц одновременно, применять условия, группировку и сортировку. Результат запроса чаще всего обрабатывается в цикле по выборке или выгружается в таблицу значений.
Регистры накопления и сведений хранят движения и остатки. При записи движений важно учитывать период, организацию, склад и другие измерения, иначе данные могут быть неверными. Перед массовой обработкой данных рекомендуется проверить логику на небольшой выборке.
Как проверить результат
Ошибок синтаксиса нет
Есть неисправленные ошибки компиляции
Действия завершаются корректно
Данные искажены или процесс завершается с ошибкой
Отладка и проверка результата
Конфигуратор предоставляет отладчик с точками останова, просмотром переменных и пошаговым выполнением. Это позволяет найти место, где код работает не так, как ожидалось. Синтаксическая проверка выявляет опечатки и неверные имена объектов до запуска.
После внесения изменений код следует проверить на копии рабочей базы с реальными данными. Если ошибка проявляется только при конкретных действиях пользователя, воспроизвести сценарий поможет журнал регистрации или отладка с отключенным режимом отключения сообщений.
Ограничения и безопасная работа
Прямое изменение типовой конфигурации может привести к потере правок при обновлении. Безопаснее использовать механизмы расширений или создавать собственную конфигурацию на базе типовой. Перед любыми структурными изменениями делается резервная копия информационной базы.
Права доступа пользователей ограничивают возможность запуска отчётов, обработок и изменения данных. Код не должен обходить эти ограничения без обоснования. Ошибки в логике проведения документов могут повредить остатки и отчётность, поэтому такие изменения требуют особой осторожности.
Сравнение подходов к размещению кода
Что важно запомнить
Пишите код в подходящем модуле, проверяйте синтаксис, отлаживайте на копии базы и не правьте типовую конфигурацию напрямую без резервной копии.
Часто задаваемые вопросы
Нужно ли знать SQL для работы с запросами в 1С?
Знание стандартного SQL не требуется, так как используется язык запросов платформы 1С. Полезно понимать принципы соединения таблиц, фильтрации и группировки данных.
Можно ли править типовую конфигурацию напрямую?
Технически возможно, но небезопасно: изменения могут пропасть при обновлении. Предпочтительнее использовать расширения или собственную конфигурацию с резервным копированием.
Где лучше писать общую логику для нескольких документов?
В общем модуле с экспортируемыми процедурами и функциями. Это позволяет вызывать одну и ту же логику из разных объектов без дублирования кода.
Что делать, если код работает в конфигураторе, но не у пользователей?
Проверьте права доступа, режим запуска и актуальность сохранённой конфигурации на сервере или в файловой базе. Возможно, пользователи работают со старой версией без обновления сеансов.
Нужно ли тестировать изменения на копии базы?
Да, особенно при изменении проведения, регистров и прав доступа. Тестирование на копии снижает риск повреждения рабочих данных и отчётности.