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

Другое · 7 мин

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

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

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

Внешне скрипт напоминает процедурный язык с русскими ключевыми словами: Процедура, Функция, Если, Тогда, Иначе, Для, Пока. Имена объектов конфигурации часто пишутся на русском и берутся из метаданных, поэтому код выглядит близко к бизнес-терминам, а не к абстрактным переменным.

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

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

Как выглядит код на языке 1С

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

Типичный фрагмент модуля формы

Процедура ОбработкаОткрытия(Отказ)
Сообщить("Форма открыта");
ЭтаФорма.Элементы.ПолеВвода.Доступность = Истина;
КонецПроцедуры

В этом примере процедура срабатывает при открытии формы, меняет доступность элемента и выводит сообщение. Имя «ЭтаФорма» относится к текущему объекту интерфейса, а реквизиты обращаются через точку.

Общий модуль с экспортной функцией

Функция СуммаДвух(Число1, Число2) Экспорт
Возврат Число1 + Число2;
КонецФункции

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

Где размещать код и как он выполняется

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

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

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

Сценарий клиентского кода формы

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

Основные конструкции: переменные, процедуры и функции

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

Параметры передаются по значению или по ссылке в зависимости от типа и способа вызова. Условный оператор Если ... Тогда ... Иначе ... КонецЕсли управляет ветвлением, а циклы Для и Пока повторяют действия по коллекциям или диапазонам.

Сценарий расчета суммы

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

Сценарий проверки заполнения

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

Типы данных и объекты конфигурации

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

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

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

Как безопасно проверять и вносить изменения

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

Типичные ошибки
01
Серверный код в клиентском модуле вызывает ошибки доступа и замедляет форму
02
Изменение реквизита без поиска всех использований ломает отчеты и документы

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

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

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

Общий модуль

Подходит для повторяемых расчетов в разных частях конфигурации; не подходит для логики одного документа

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

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

Модуль формы

Подходит для управления интерфейсом и проверки ввода; не подходит для тяжелых запросов к базе без серверного вызова

Частые ошибки и выбор подходящего варианта

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

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

Итог

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

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

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

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

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

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

В чем разница между процедурой и функцией?

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

Где лучше размещать общие расчеты?

В общем модуле с модификатором Экспорт, чтобы функция была доступна из документов, отчетов и форм без дублирования кода.

Как понять, что изменение сработало правильно?

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