Внешнее соединение 1С

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

История и предпосылки появления

В ранних версиях платформы «1С:Предприятие» (до версии 7.7) возможности интеграции с внешними системами были ограничены. Основным способом взаимодействия был обмен через текстовые файлы (dbf, txt) или прямые SQL-запросы к таблицам базы данных, что было небезопасно и не поддерживало бизнес-логику платформы. С появлением версии 8.0 (2003 год) была внедрена компонента COMConnector, которая и реализовала механизм внешнего соединения. Это позволило разработчикам создавать внешние приложения (например, на C++, C#, Python, VBA), которые могли работать с данными 1С как с обычной COM-библиотекой.

Позднее, с развитием веб-технологий и появлением серверных версий платформы, внешнее соединение стало доступно и через HTTP-сервисы (REST) и веб-сервисы (SOAP), что расширило сферу применения на веб-приложения и мобильные платформы. В современных версиях (8.3 и выше) внешнее соединение является стандартным механизмом для интеграции, наряду с ODBC-драйвером и прямым доступом к данным через SQL (с использованием обмена через «Правила конвертации данных»).

Архитектура и принцип работы

Компонента COMConnector

Внешнее соединение реализовано в виде COM-объекта V83.COMConnector (для 64-разрядных систем — V83.COMConnector.x64). Этот объект предоставляет метод Connect, который принимает строку соединения — путь к информационной базе (файловый или серверный вариант), имя пользователя и пароль. После успешного подключения возвращается ссылка на объект «ВнешнееСоединение», который является аналогом глобального контекста сеанса 1С.

Основные отличия от сеанса, запущенного через клиентское приложение:

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

Строка соединения

Строка соединения (Connection String) формируется в зависимости от типа базы:

Файловая база: File="C:\Path\To\Base"; Usr="ИмяПользователя"; Pwd="Пароль";
Серверная база: Srvr="ИмяСервера"; Ref="ИмяБазы"; Usr="ИмяПользователя"; Pwd="Пароль";

Дополнительные параметры: Locale (код локали), AppID (идентификатор приложения), AuthMode (режим аутентификации — 0 = платформенная, 1 = ОС Windows).

Ограничения и особенности

Внешнее соединение не поддерживает работу с управляемыми формами и отчётами в интерактивном режиме.
Нельзя открывать модальные окна, диалоги выбора файлов, предупреждения.
Сеанс внешнего соединения не отображается в списке активных пользователей конфигурации (в режиме «Пользователи»), но фиксируется в журнале регистрации.
Для работы с внешним соединением на сервере 1С:Предприятие необходимо, чтобы на компьютере, где выполняется внешнее приложение, был установлен клиент 1С (толстый клиент или тонкий клиент с компонентой COM).
Внешнее соединение может быть создано только в рамках одного сеанса; одновременная работа с несколькими базами требует создания нескольких объектов соединения.

Применение

Интеграция с внешними системами

Внешнее соединение используется для обмена данными между 1С и другими программами:

Сайты и интернет-магазины: загрузка заказов, выгрузка остатков, синхронизация номенклатуры.
CRM-системы: передача контактов, сделок, истории взаимодействий.
ERP-системы: обмен заказами на производство, складскими документами.
Банковские системы: выгрузка платёжных поручений, загрузка выписок.
Складские терминалы и весы: автоматическое формирование документов при приёмке/отгрузке.

Создание внешних обработок и отчётов

Разработчики могут создавать внешние обработки (файлы .epf), которые подключаются к базе через внешнее соединение, но при этом не требуют установки на сервер. Такие обработки удобны для:

Однократного исправления данных (например, массового пересчёта остатков).
Формирования сложных отчётов с использованием внешних библиотек (например, Excel, Word).
Автоматизации рутинных операций (заполнение документов, рассылка уведомлений).

Автоматизация обмена данными

Внешнее соединение часто используется в регламентных заданиях (фоновых процессах) для выполнения операций по расписанию:

Выгрузка данных в файлы (XML, CSV, JSON).
Загрузка данных из внешних источников (FTP, электронная почта, веб-сервисы).
Синхронизация справочников и документов между различными базами 1С.

Тестирование и отладка

Внешнее соединение позволяет проводить автоматизированное тестирование конфигураций без участия пользователя. С помощью скриптов (например, на Python или PowerShell) можно:

Создавать тестовые данные (справочники, документы).
Проверять корректность расчётов (например, себестоимости, налогов).
Выполнять нагрузочное тестирование (имитация массового ввода документов).

Примеры использования

Пример 1: Чтение данных из справочника (VBA)

``vba Dim Connector As Object Set Connector = CreateObject("V83.COMConnector") Dim Connection As Object Set Connection = Connector.Connect("File=""C:\Base""; Usr=""Администратор""; Pwd="""";") Dim Справочник As Object Set Справочник = Connection.Справочники.Номенклатура Dim Элемент As Object For Each Элемент In Справочник.Выбрать() MsgBox Элемент.Наименование Next ``

Пример 2: Создание документа (Python)

```python import win32com.client

connector = win32com.client.Dispatch("V83.COMConnector") connection = connector.Connect("Srvr=""MyServer""; Ref=""MyBase""; Usr=""Admin""; Pwd=""123"";")

doc = connection.Documents.ПоступлениеТоваров.CreateDocument() doc.Дата = "2024-01-15" doc.Организация = connection.Справочники.Организации.FindByCode("000000001") doc.Контрагент = connection.Справочники.Контрагенты.FindByCode("000000002") doc.Write() print("Документ создан:", doc.Ссылка) ```

Пример 3: Выполнение запроса (C#)

```csharp using System; using System.Runtime.InteropServices;

class Program { static void Main() { Type comType = Type.GetTypeFromProgID("V83.COMConnector"); object connector = Activator.CreateInstance(comType); object connection = comType.InvokeMember("Connect", System.Reflection.BindingFlags.InvokeMethod, null, connector, new object[] { "File=\"C:\\Base\"; Usr=\"Admin\"; Pwd=\"\";" });

object query = comType.InvokeMember("NewObject", System.Reflection.BindingFlags.InvokeMethod, null, connection, new object[] { "Запрос" });

comType.InvokeMember("Text", System.Reflection.BindingFlags.SetProperty, null, query, new object[] { "ВЫБРАТЬ Наименование ИЗ Справочник.Номенклатура" });

object result = comType.InvokeMember("Выполнить", System.Reflection.BindingFlags.InvokeMethod, null, query, null);

object selection = comType.InvokeMember("Выбрать", System.Reflection.BindingFlags.InvokeMethod, null, result, null);

while ((bool)comType.InvokeMember("Следующий", System.Reflection.BindingFlags.InvokeMethod, null, selection, null)) { Console.WriteLine(comType.InvokeMember("Наименование", System.Reflection.BindingFlags.GetProperty, null, selection, null)); } } } ```

Критика и ограничения

Безопасность: Внешнее соединение требует передачи пароля в открытом виде в строке соединения, что может быть уязвимостью при хранении скриптов в открытом доступе.
Производительность: При массовой обработке данных (например, пакетной загрузке тысяч документов) внешнее соединение может работать медленнее, чем выполнение аналогичных операций внутри сеанса 1С, из-за накладных расходов на COM-взаимодействие.
Отсутствие транзакционности: Внешнее соединение не поддерживает явное управление транзакциями на уровне COM-объекта; каждая операция записи выполняется в своей транзакции, что может привести к проблемам при сложных сценариях.
Ограниченная поддержка в веб-клиенте: Внешнее соединение не работает в веб-клиенте 1С; для интеграции с веб-приложениями необходимо использовать HTTP-сервисы или веб-сервисы.
Зависимость от версии платформы: COM-объект привязан к установленной версии платформы 1С; при обновлении платформы может потребоваться перекомпиляция внешних приложений.

Альтернативные технологии

ODBC-драйвер 1С: Позволяет выполнять SQL-запросы напрямую к таблицам базы данных, но не поддерживает объектную модель (нельзя создавать документы, работать с бизнес-логикой).
HTTP-сервисы (REST): Современный способ интеграции, не требующий установки клиента 1С на стороне вызывающего приложения. Позволяет выполнять чтение, запись и вызов методов через HTTP-запросы.
Веб-сервисы (SOAP): Аналогично HTTP-сервисам, но с использованием протокола SOAP. Поддерживается в платформе 1С:Предприятие 8.
Прямой доступ к данным через SQL: Используется редко из-за сложности и небезопасности; требует знания структуры таблиц конкретной конфигурации.

Источники

1С:Предприятие 8.3. Руководство разработчика. Раздел «Внешнее соединение». Фирма «1С», 2023.
Документация к COM-объекту V83.COMConnector. Файл справки 1CV8COM.HLP.
Статья «Интеграция 1С:Предприятие 8 с внешними системами» на портале 1С:ИТС (its.1c.ru).
Книга «1С:Предприятие 8.3. Практическое пособие разработчика» (Г. Н. Кашаев, 2022).
Материалы конференций INFOSTART EVENT (2019–2023).

BFOmetr — база данных и аналитика по компаниям России.

На главную BFOmetr →