Что такое ADO в 1С и как его использовать

ADO (ActiveX Data Objects) — это технология Microsoft для доступа к данным из внешних источников: баз SQL Server, файлов Excel, Access, текстовых файлов и других хранилищ, для которых существует OLE DB-провайдер или ODBC-драйвер. В контексте 1С термин «ADO» почти всегда означает работу с COM-объектами семейства ADODB — Connection, Command, Recordset — из встроенного языка платформы.

Типовая задача, где применяется ADO, — обмен данными между 1С и внешней системой без промежуточных файлов. Например, нужно напрямую прочитать справочник товаров из базы старой учётной программы, выгрузить остатки в SQL-базу корпоративного портала или забрать данные из файла Excel, который поставщик присылает в нестандартном формате. Во всех этих случаях 1С выступает клиентом, который через ADO подключается к источнику и выполняет SQL-запросы.

Важно понимать ограничение: COM-технология ADO доступна только в Windows и только там, где код выполняется на стороне, способной создавать COM-объекты, — в толстом клиенте или на сервере 1С под Windows. В тонком и веб-клиенте напрямую создать объект ADODB.Connection нельзя, поэтому в клиент-серверном режиме весь ADO-код размещают в серверных процедурах. Современные версии платформы также предлагают альтернативу — внешние источники данных, которые во многих сценариях удобнее «ручного» ADO.

Как устроена работа с ADO в 1С

Механика проста: встроенный язык 1С умеет создавать COM-объекты через конструктор Новый COMОбъект("ADODB.Connection"). После создания объекта программист работает с ним по документации Microsoft: открывает соединение строкой подключения, выполняет запросы, перебирает записи возвращённого набора данных. Сама платформа 1С здесь выступает лишь «хостом» COM — она не контролирует SQL и не знает о структуре внешней базы.

Три основных объекта, которые используются чаще всего:

• ADODB.Connection — соединение с источником данных. Открывается строкой подключения (provider, server, database, учётные данные), через него выполняются запросы и управляются транзакции.
• ADODB.Command — параметризованная команда. Позволяет безопасно передавать параметры в запрос вместо конкатенации строк, что защищает от SQL-инъекций и ошибок с типами данных.
• ADODB.Recordset — набор записей, результат выполнения SELECT. Перебирается в цикле методом MoveNext, поля доступны через коллекцию Fields.

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

Когда ADO оправдан, а когда лучше выбрать другое

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

Однако у технологии есть серьёзные конкуренты внутри самой платформы. Механизм внешних источников данных (ExternalDataSource) позволяет подключить ODBC-доступную базу как часть конфигурации: таблицы становятся похожи на объекты 1С, к ним можно строить запросы на языке 1С, использовать в отчётах СКД и даже размещать в формах. Для постоянных интеграций это почти всегда удобнее, чем ручной перебор Recordset.

Если источник данных живёт на Linux, если 1С работает на Linux-сервере или если нужен обмен в реальном времени с веб-приложением — ADO отпадает сразу, и правильнее смотреть в сторону HTTP-сервисов или файлового обмена.

Пример: подключение к SQL Server и чтение данных

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

Процедура ЗагрузитьТовары() Экспорт
	Соединение = Новый COMОбъект("ADODB.Connection");
	СтрокаПодключения = "Provider=SQLOLEDB;Data Source=SQLSERVER;Initial Catalog=ShopDB;User ID=user;Password=pass;";
	Соединение.Open(СтрокаПодключения);
	НаборЗаписей = Соединение.Execute("SELECT Code, Name, Price FROM Goods");
	Пока НЕ НаборЗаписей.EOF Цикл
		КодТовара = НаборЗаписей.Fields("Code").Value;
		Наименование = НаборЗаписей.Fields("Name").Value;
		// ... поиск или создание элемента справочника ...
		НаборЗаписей.MoveNext();
	КонецЦикла;
	НаборЗаписей.Close();
	Соединение.Close();
КонецПроцедуры

Обратите внимание на обязательное закрытие Recordset и Connection. COM-объекты не освобождаются сборщиком мусора 1С мгновенно; незакрытые соединения копятся на SQL Server и рано или поздно упираются в лимиты. В продуктивном коде весь блок работы с ADO оборачивают в попытку/исключение с гарантированным закрытием соединения в ветке исключения.

Для запросов с параметрами используйте ADODB.Command вместо подстановки значений в строку запроса. Это устраняет проблемы с кавычками в наименованиях, форматами дат и десятичными разделителями, а главное — исключает SQL-инъекции, если часть условий приходит от пользователя.

Пример: чтение данных из Excel через ADO

Вторая частая задача — прочитать xls- или xlsx-файл как таблицу базы данных. Это удобно, когда файл большой, листов много, а стандартный табличный документ 1С справляется медленно или требует установленного Excel на машине.

Соединение = Новый COMОбъект("ADODB.Connection");
СтрокаПодключения = "Provider=Microsoft.ACE.OLEDB.12.0;Data Source=C:\data\price.xlsx;Extended Properties=""Excel 12.0;HDR=YES"";";
Соединение.Open(СтрокаПодключения);
НаборЗаписей = Соединение.Execute("SELECT * FROM [Лист1$]");

Нюансы, о которых часто забывают. Параметр HDR=YES означает, что первая строка листа — заголовки колонок; если заголовков нет, укажите HDR=NO, и поля получат имена F1, F2 и так далее. Имя листа в запросе пишется с символом доллара и в квадратных скобках: [Лист1$]. Для провайдера ACE.OLEDB нужен установленный драйвер Access Database Engine соответствующей разрядности — на 64-битном сервере 1С нужен 64-битный драйвер.

Ещё одна ловушка: драйвер определяет тип колонки по первым строкам. Если в «числовой» колонке ниже встречается текст, значения могут прочитаться как NULL. Лечится параметром IMEX=1 в Extended Properties либо приведением форматов в самом файле.

Типичные ошибки и как их диагностировать

Большинство проблем с ADO в 1С сводится к нескольким повторяющимся сценариям. Знание симптомов экономит часы отладки.

При отладке полезно проверить строку подключения вне 1С: создайте на той же машине файл с расширением .udl, настройте соединение визуально, нажмите «Проверить подключение», а затем откройте файл блокнотом — внутри будет готовая корректная строка. Если соединение не работает даже в UDL-файле, проблема в драйверах или сетевом доступе, а не в коде 1С.

Безопасность и ограничения

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

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

Порядок внедрения ADO-обмена в конфигурацию

1. 1
   Определите источник данных и убедитесь, что для него существует OLE DB-провайдер или ODBC-драйвер нужной разрядности
2. 2
   Проверьте строку подключения через UDL-файл на сервере 1С, где будет выполняться код
3. 3
   Создайте серверную функцию или процедуру в общем модуле с признаком «Сервер»
4. 4
   Реализуйте чтение через ADODB.Connection и Recordset с обработкой исключений и гарантированным Close()
5. 5
   Для запросов с параметрами используйте ADODB.Command
6. 6
   Протестируйте на копии: сверьте количество и содержимое загруженных записей с источником
7. 7
   Настройте права учётной записи по минимуму и вынесите секреты из кода
8. 8
   Для регулярного обмена оберните вызов в регламентное задание с логированием ошибок

Если обмен планируется постоянным, а не разовым, перед внедрением ещё раз сравните ADO с внешними источниками данных: второй вариант даст пользователям отчёты и просмотр данных «из коробки», без написания обработок для каждой задачи.

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