Если вы работаете с платформой 1С:Предприятие, то рано или поздно столкнётесь с необходимостью автоматизировать рутинные операции, интегрировать системы или писать внешние обработки. Здесь на помощь приходит OneScript — мощный инструмент, который расширяет возможности стандартного языка 1С. Но что это такое на самом деле? Почему многие разработчики выбирают именно его, а не встроенные механизмы?

На первый взгляд, OneScript может показаться очередным "велосипедом" для 1С, но на деле это полноценный скриптовый язык, который работает поверх платформы и позволяет решать задачи, недоступные штатными средствами. Он сочетает в себе гибкость Python-подобных скриптов и привычный синтаксис 1С, что делает его идеальным решением для администраторов, аналитиков и даже новичков в программировании.

В этой статье мы разберём, что такое OneScript, как он устроен, где его применяют на практике, и почему без него сложно обойтись при серьёзной работе с 1С. А ещё — покажем реальные примеры кода, которые можно использовать уже сегодня.

Что такое OneScript и зачем он нужен

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

В отличие от встроенного языка 1С, который работает только внутри конфигураций, OneScript выполняется вне платформы. Это значит, что вы можете писать скрипты, которые:

  • 🔹 Обходят ограничения клиент-серверной архитектуры 1С;
  • 🔹 Работают с файловой системой, реестром Windows и сетевыми ресурсами;
  • 🔹 Интегрируются с другими программами через COM, HTTP или SQL;
  • 🔹 Автоматизируют массовые операции (например, загрузку данных из Excel в сотни баз).

Проекты на OneScript компилируются в исполняемые файлы (.exe или .dll), что позволяет распределять их между пользователями без установки дополнительного ПО. Например, можно написать скрипт для автоматического резервного копирования баз 1С и запускать его по расписанию через Планировщик задач Windows.

📊 Как вы обычно автоматизируете задачи в 1С?
Стандартными средствами 1С
OneScript
Внешними обработками
Собственными программами на C#/Python

Отличия OneScript от встроенного языка 1С

На первый взгляд, синтаксис OneScript очень похож на язык 1С, но между ними есть принципиальные различия. Вот ключевые из них:

Критерий Встроенный язык 1С OneScript
Среда выполнения Только внутри платформы 1С:Предприятие Вне платформы (консоль, .exe-файлы)
Доступ к файловой системе Ограничен (только через объекты Файл, Каталог) Полный доступ (работа с FileSystemObject, Shell)
Многопоточность Нет (за исключением фоновых заданий в серверных вызовах) Да (через библиотеку oscript-library)
Интеграция с внешними системами Ограничена (только через HTTPСервис, COMОбъект) Гибкая (работа с REST API, SQL, DLL)

Ещё одно важное отличие — OneScript поддерживает модульное программирование. Вы можете подключать внешние библиотеки (например, для работы с JSON, XML или Telegram Bot API), тогда как в стандартном языке 1С придётся писать всё с нуля или использовать ограниченные возможности платформы.

OneScript не заменяет встроенный язык 1С, а дополняет его. Например, вы не сможете написать на нём обработку для формы документа, но легко автоматизируете массовое обновление справочников в сотне баз за одну ночь.

💡

Если вам нужно быстро протестировать скрипт на OneScript, используйте OneScript Playground — онлайн-песочницу для выполнения кода без установки.

Где применяется OneScript на практике

Давайте разберём реальные кейсы, где OneScript становится незаменимым инструментом:

  • 📊 Массовая обработка данных: обновление цен, перенос справочников между базами, очистка дублей. Например, скрипт может за одну ночь обновить номенклатуру в 50 магазинах сети.
  • 🔄 Интеграция с внешними системами: обмен данными с CRM, ERP, банками или маркетплейсами. OneScript умеет работать с REST API, SOAP и даже 1С:EDT.
  • 🖥️ Администрирование серверов 1С: автоматическое резервное копирование, мониторинг производительности, перезапуск служб. Скрипт может отправлять уведомления в Telegram, если база "упала".
  • 📂 Работа с файлами и отчётами: генерация Excel-отчётов, конвертация данных в PDF, парсинг логов. Например, можно автоматически формировать сводку по продажам из нескольких баз.

Один из самых популярных сценариев — автоматизация рутинных задач бухгалтеров и кадровиков. Например, скрипт может:

  1. Скачать выписку из банка в формате 1С;
  2. Загрузить её в базу;
  3. Сверить платежи с документами;
  4. Отправить отчёт о расхождениях на почту.

Все эти операции выполняются без участия человека, экономя часы рабочего времени.

Пример кода для загрузки выписки из банка

ПодключитьБиблиотеку("OneScript.BankClient");


// Подключаемся к банку


Клиент = Новый КлиентБанка("Сбербанк", "Логин", "Пароль");


Выписка = Клиент.ПолучитьВыписку(ТекущаяДата(), ТекущаяДата());



// Загружаем в 1С


Загрузчик = Новый ЗагрузчикВыписки(Выписка);


Загрузчик.Выполнить();

💡

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

Как установить и настроить OneScript

Чтобы начать работать с OneScript, достаточно скачать и установить его с официального сайта. Процесс установки занимает не больше 5 минут:

  1. Скачайте дистрибутив для вашей ОС (поддерживаются Windows, Linux и macOS).
  2. Запустите установщик и следуйте инструкциям (по умолчанию OneScript устанавливается в C:\Program Files\OneScript).
  3. После установки проверьте работу в командной строке: 
    oscript -v

    Должна отобразиться версия интерпретатора.

Для удобной разработки рекомендуется использовать:

  • 📝 VS Code с расширением OneScript Language (подсветка синтаксиса, автодополнение);
  • 🛠️ OneScript IDE — специализированная среда разработки;
  • 📦 Менеджер пакетов opm для установки библиотек (аналог npm для JavaScript).

После установки вы можете создать первый скрипт. Например, сохраните следующий код в файл hello.os:

Сообщить("Привет, мир из OneScript!");


// Подключаем библиотеку для работы с 1С


ПодключитьБиблиотеку("OneScript.StandardLibrary");



База = Новый База1С("File=C:\Bases\Demo");


База.Подключиться("Администратор", "");



Сообщить("Подключились к базе: " + База.Имя());

И выполните его в командной строке:

oscript hello.os

Установить OneScript|Добавить путь к oscript в PATH|Установить VS Code + расширение|Скачать библиотеку OneScript.StandardLibrary|Проверить подключение к тестовой базе-->

Примеры кода: что можно сделать на OneScript

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

1. Массовое обновление справочника "Номенклатура"

Допустим, вам нужно увеличить цены на все товары на 10%. В стандартной 1С это заняло бы часы ручной работы. На OneScript задача решается за минуты:

ПодключитьБиблиотеку("OneScript.StandardLibrary");


База = Новый База1С("File=C:\Bases\Trade");


База.Подключиться("Администратор", "");



Запрос = База.НовыйЗапрос();


Запрос.Текст =


"ВЫБРАТЬ


|   Номенклатура.Ссылка КАК Ссылка,


|   Номенклатура.Цена КАК Цена


|ИЗ


|   Справочник.Номенклатура КАК Номенклатура";



Результат = Запрос.Выполнить();


Выборка = Результат.Выбрать();



Пока Выборка.Следующий() Цикл


Товар = Выборка.Ссылка.ПолучитьОбъект();


Товар.Цена = Товар.Цена * 1.1;


Товар.Записать();


КонецЦикла;



Сообщить("Цены обновлены!");

2. Экспорт данных в Excel

OneScript умеет работать с Excel через COM-объекты. Например, так можно сгенерировать отчёт по остаткам:

ПодключитьБиблиотеку("OneScript.StandardLibrary");


Excel = Новый COMОбъект("Excel.Application");


Книга = Excel.Workbooks.Add();


Лист = Книга.ActiveSheet;



Лист.Cells(1, 1).Value = "Номенклатура";


Лист.Cells(1, 2).Value = "Остаток";



База = Новый База1С("File=C:\Bases\Trade");


Запрос = База.НовыйЗапрос("ВЫБРАТЬ Номенклатура, ОстаткиТоваров.Остаток ИЗ Справочник.Номенклатура КАК Номенклатура ЛЕВОЕ СОЕДИНЕНИЕ РегистрНакопления.ОстаткиТоваров КАК ОстаткиТоваров ПО Номенклатура.Ссылка = ОстаткиТоваров.Номенклатура");



Результат = Запрос.Выполнить();


Строка = 2;



Пока Результат.Следующий() Цикл


Лист.Cells(Строка, 1).Value = Результат.Номенклатура;


Лист.Cells(Строка, 2).Value = Результат.Остаток;


Строка = Строка + 1;


КонецЦикла;



Книга.SaveAs("C:\Reports\Остатки.xlsx");


Excel.Quit();

3. Отправка уведомлений в Telegram

С помощью библиотеки OneScript.TelegramBot можно настроить оповещения о критичных событиях (например, падении базы):

ПодключитьБиблиотеку("OneScript.TelegramBot");


Бот = Новый TelegramBot("ВАШ_TOKEN");


Бот.ОтправитьСообщение(-100123456789, "⚠️ Внимание! База Trade не отвечает. Последняя ошибка: " + ПолучитьПоследнююОшибкуИзЛога());

Эти примеры показывают, как OneScript упрощает задачи, которые в стандартной 1С потребовали бы сложных доработок или внешних обработок.

💡

Для работы с JSON в OneScript используйте библиотеку OneScript.JSON. Она позволяет сериализовать и десериализовать данные всего в одну строку.

Популярные библиотеки для OneScript

Одним из главных преимуществ OneScript является экосистема библиотек, которые расширяют его возможности. Вот самые полезные из них:

Библиотека Назначение Пример использования
OneScript.StandardLibrary Базовые функции для работы с 1С, файлами, датами 
Файл = Новый Файл("report.txt");

Файл.Записать("Отчёт сформирован");
OneScript.JSON Работа с форматом JSON (парсинг, генерация) 
Данные = JSON.Прочитать('{"name": "Иван"}');

Сообщить(Данные.name);
OneScript.TelegramBot Интеграция с Telegram API для уведомлений 
Бот.ОтправитьСообщение(чатID, "Тестовое сообщение");
OneScript.SQL Выполнение SQL-запросов к внешним БД 
Результат = SQL.Выполнить("SELECT * FROM Customers");
OneScript.Web Работа с HTTP-запросами (GET, POST, обработка ответов) 
Ответ = HTTP.Получить("https://api.example.com/data");

Установить библиотеку можно через менеджер пакетов opm. Например:

opm install oscript-json

После установки подключите её в скрипте:

ПодключитьБиблиотеку("OneScript.JSON");
💡

Библиотеки для OneScript позволяют решать задачи, на которые в стандартной 1С ушли бы недели разработки.

Типичные ошибки и как их избежать

При работе с OneScript новички часто сталкиваются с типичными проблемами. Вот самые распространённые из них и способы их решения:

  • ❌ Ошибка подключения к базе: убедитесь, что путь к базе указан правильно и у пользователя есть права. Пример правильного пути: 
    File=C:\Bases\Demo;Usr=Администратор;Pwd=;
  • ❌ Не хватает библиотек: если скрипт выдаёт ошибку о отсутствующей функции, проверьте, подключена ли нужная библиотека через ПодключитьБиблиотеку().
  • ❌ Проблемы с кодировкой: при работе с файлами явно указывайте кодировку: 
    Файл = Новый Файл("data.txt", КодировкаТекста.UTF8);
  • ❌ Зависание скрипта: если скрипт долго выполняется, добавьте вывод лога для отладки: 
    Сообщить("Шаг 1: Подключение к базе...");

Ещё одна частая проблема — ошибки при работе с COM-объектами (например, Excel или Word). Чтобы их избежать:

  1. Убедитесь, что на компьютере установлено соответствующее ПО (например, Microsoft Office);
  2. Запускайте скрипт от имени администратора;
  3. Используйте блок Попытка...Исключение для обработки ошибок: 
    Попытка

    Excel = Новый COMОбъект("Excel.Application");
    

    Исключение
    

    Сообщить("Ошибка: " + ОписаниеОшибки());
    

    КонецПопытки;

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

Как отладить скрипт, если он не работает?

1. Добавьте вывод промежуточных значений через Сообщить().

2. Проверьте логи в файле oscript.log (обычно лежит в папке с OneScript).

3. Запустите скрипт в отладочном режиме:

oscript -debug my_script.os

4. Если проблема с подключением к 1С, проверьте права пользователя и версию платформы.

⚠️ Внимание: При работе с COM-объектами (например, Excel) всегда освобождайте ресурсы с помощью Excel.Quit(). Иначе процесс может остаться висеть в памяти.

FAQ: Частые вопросы о OneScript

Можно ли использовать OneScript для изменения конфигурации 1С?

Нет, OneScript не предназначен для изменения структуры конфигурации (добавления справочников, документов и т.п.). Он работает с данными внутри базы, но не с её метаданными. Для изменений конфигурации используйте Конфигуратор 1С или 1С:EDT.

Нужно ли платить за использование OneScript?

Нет, OneScript — это открытое ПО с лицензией MIT. Вы можете свободно использовать его в коммерческих проектах без ограничений. Оплачиваются только некоторые проприетарные библиотеки (например, для работы с 1С:Документооборот), но их большинство — бесплатные.

Можно ли запускать скрипты OneScript на Linux?

Да, OneScript поддерживает Linux и macOS через Mono или .NET Core. Однако для работы с 1С потребуется виртуальная машина с Windows или Wine, так как платформа 1С:Предприятие официально не поддерживает Linux.

Как защитить исходный код скрипта?

Вы можете скомпилировать скрипт в .exe-файл с помощью команды: 

oscriptc my_script.os

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

Где искать помощь по OneScript?

Официальная документация: oscript.io/docs

Сообщество в Telegram: @oscript

Репозиторий библиотек: GitHub

Форум на Инфостарт (раздел "OneScript").

⚠️ Внимание: Версии библиотек для OneScript могут конфликтовать друг с другом. Перед обновлением проверяйте совместимость в документации или тестируйте на копии проекта.