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