BSL в 1С: что это за язык и как с ним работать

BSL (Built-in Script Language) — это встроенный язык программирования платформы «1С:Предприятие», на котором пишется вся прикладная логика конфигураций: обработчики событий форм, проведение документов, расчёты, обмены данными. Часто его называют просто «встроенный язык 1С», а в инструментах разработки — «OneScript-подобный язык» или по расширению файлов модулей (.bsl) во внешних редакторах.

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

Характерная особенность BSL — двуязычный синтаксис. Ключевые слова и встроенные функции можно писать как на русском (Если ... Тогда ... КонецЕсли;), так и на английском (If ... Then ... EndIf;), причём оба варианта работают одинаково. В типовых конфигурациях исторически используется русский синтаксис, в новых проектах и открытых библиотеках всё чаще встречается английский.

Что такое BSL и где он используется

BSL — не отдельная программа, а часть платформы 1С. Код на нём хранится внутри конфигурации в специальных контейнерах — модулях — и исполняется либо на сервере 1С, либо на клиенте (тонком, веб- или толстом). Платформа компилирует код во внутреннее представление при запуске, поэтому BSL относят к интерпретируемым языкам, хотя формально в нём есть этап компиляции в байт-код.

Типичные задачи, которые решают на BSL: проведение документов с формированием движений по регистрам, заполнение и проверка данных перед записью, формирование отчётов через СКД и запросы, интеграция с внешними сервисами по HTTP, загрузка и выгрузка файлов, регламентные задания. Фактически любое поведение прикладного решения, выходящее за рамки настроек в конфигураторе, реализуется кодом на BSL.

Как устроен синтаксис языка

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

Управляющие конструкции привычны: условие Если ... ИначеЕсли ... Иначе ... КонецЕсли;, циклы Для ... Цикл ... КонецЦикла; и Пока ... Цикл ... КонецЦикла;, обход коллекций через Для Каждого ... Из ... Цикл. Обработка ошибок выполняется через Попытка ... Исключение ... КонецПопытки; с получением описания ошибки функцией ОписаниеОшибки() или объектом ИнформацияОбОшибке.

Пример простого кода на русском синтаксисе:

Функция РассчитатьСкидку(СуммаПокупки) Экспорт

Если СуммаПокупки >= 100000 Тогда
Возврат 10;
ИначеЕсли СуммаПокупки >= 50000 Тогда
Возврат 5;
КонецЕсли;

Возврат 0;

КонецФункции

Отдельный пласт языка — работа с запросами. Текст запроса пишется на собственном языке запросов 1С (похожем на SQL), который передаётся строкой в объект Запрос. Это не часть BSL в строгом смысле, но без владения языком запросов полноценная разработка невозможна: выборки из базы через запросы работают на порядки быстрее, чем перебор объектов в цикле.

Виды модулей и контекст исполнения

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

В модулях форм и общих клиент-серверных модулях используются директивы компиляции: &НаКлиенте, &НаСервере, &НаСервереБезКонтекста. Они указывают платформе, для какого контекста компилировать процедуру. Ошибка в выборе директивы — классический источник проблем: например, вызов серверной функции из клиентского кода без директивы приводит к ошибке «Процедура или функция не определена».

Как написать и запустить первый код

Минимальный путь к первому работающему коду выглядит так: открыть конфигуратор, создать обработку (или общий модуль), написать процедуру и вызвать её. Для экспериментов удобнее всего внешняя обработка — она не требует изменения конфигурации базы.

1. 1
   Откройте конфигуратор и создайте новую внешнюю обработку через Файл → Новый → Внешняя обработка
2. 2
   Добавьте форму обработки и разместите на ней кнопку
3. 3
   Создайте обработчик нажатия кнопки с директивой &НаКлиенте и вызовом Сообщить() или ПоказатьПредупреждение()
4. 4
   Сохраните обработку в файл .epf и откройте её в режиме 1С:Предприятие через Файл → Открыть
5. 5
   Нажмите кнопку и убедитесь, что сообщение появилось

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

&НаКлиенте
Процедура КомандаПривет(Команда)
	ПоказатьПредупреждение(, "Привет из BSL!");
КонецПроцедуры

Типичные ошибки начинающих разработчиков

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

Отдельно стоит сказать про обращения к базе внутри циклов. Конструкция вида «в цикле по строкам таблицы получить ссылку и прочитать объект» порождает по запросу к СУБД на каждую итерацию. На тестовой базе это незаметно, а на рабочей с тысячами строк приводит к тайм-аутам и блокировкам. Правильный подход — один запрос с соединением таблиц и обход уже готовой выборки.

Чем BSL отличается от OneScript и других языков

Начинающие часто путают BSL и OneScript. OneScript — независимый открытый проект, реализующий синтаксис, совместимый со встроенным языком 1С, но работающий вне платформы: в нём нет прикладных объектов (документов, регистров), зато можно писать консольные скрипты, автоматизацию сборки и утилиты. Код на OneScript выполняется своим интерпретатором и не имеет доступа к базе 1С напрямую.

По сравнению с языками общего назначения (C#, Java, Python) BSL проигрывает в экосистеме библиотек и инструментах, но выигрывает в скорости решения учётных задач: то, что на универсальном языке потребовало бы проектирования ORM и слоя доступа к данным, в 1С доступно из коробки. Поэтому BSL не конкурент общим языкам, а специализированный инструмент внутри своей платформы.

Как проверить, что код работает правильно

Проверка результата в 1С — это не только «программа не упала с ошибкой». Нужно убедиться, что данные в базе изменились именно так, как задумано, и не появились побочные эффекты: лишние движения по регистрам, дубли записей, потерянные связи.

Для поиска узких мест полезен замер производительности (Отладка → Замер производительности) — он показывает, какие строки кода и запросы занимают больше всего времени. А анализ плана запроса на стороне СУБД помогает понять, почему конкретный запрос работает медленно и не хватает ли индекса.

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