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

Другое · 6 мин

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

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

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

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

Как выглядит программный код 1С

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

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

ПроцедураНачинается со слова Процедура

Проверьте наличие пары КонецПроцедуры

ФункцияВозвращает значение через Возврат

Убедитесь, что во всех ветках есть оператор Возврат

Обращение к объектуИспользует точку

Проверьте, что объект существует в конфигурации

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

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

Модули и где находится код

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

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

Процедуры, функции и параметры

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

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

Порядок работы с фрагментом кода
  1. 1
    Определите тип модуля, где находится процедура
  2. 2
    Проверьте наличие КонецПроцедуры или КонецФункции
  3. 3
    Убедитесь, что все обращения к объектам существуют в конфигурации
  4. 4
    Выполните проверку синтаксиса в конфигураторе

Переменные, типы и работа с данными

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

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

Запросы и язык запросов 1С

Для выборки данных из регистров, справочников и документов используется встроенный язык запросов. Он работает с таблицами базы через конструкции ВЫБРАТЬ, ИЗ, ГДЕ, СГРУППИРОВАТЬ и другие. Запрос может содержать параметры, соединения таблиц и виртуальные таблицы регистров.

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

Типичные ошибки
01
Опечатка в имени реквизита приводит к ошибке при выполнении
02
Отсутствие Возврат в одной из веток функции
03
Обращение к неинициализированному объекту

Отладка, проверка и частые ошибки

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

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

Итог

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

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

Частые вопросы

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

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

Отличаются ли процедура и функция?

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

Где искать код конкретной кнопки на форме?

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

Безопасно ли править код в рабочей базе?

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

Что делать, если проверка синтаксиса выдаёт ошибку?

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