Запуск внешнего соединения 1С: что это такое и как его использовать

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

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

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

Что такое внешнее соединение и как оно работает

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

Существует два основных механизма. Первый — COM-соединитель: внешнее приложение создаёт объект V83.COMConnector, вызывает метод Connect со строкой подключения и получает объект соединения, через который обращается к данным базы. Второй — объект ВнешнееСоединение внутри кода 1С, когда одна база подключается к другой напрямую, без COM, через методы глобального контекста.

Важно понимать различие скорости и возможностей. COM-соединение передаёт каждый вызов через механизм COM, что заметно медленнее при обходе больших выборок. Встроенное внешнее соединение между базами 1С работает быстрее, но доступно только из кода на встроенном языке. В обоих случаях недоступны интерактивные возможности: предупреждения, вопросы пользователю, открытие форм — вызов таких методов приведёт к ошибке.

Когда внешнее соединение — правильный выбор

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

Другой частый случай — интеграция со сторонними системами на Windows: скрипт PowerShell, приложение на C# или Python через COM-объект забирает остатки, цены или создаёт заказы. Это просто в реализации, но привязывает решение к Windows-окружению и требует установленной платформы 1С на машине, откуда идёт подключение.

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

Как запустить внешнее соединение через COM-соединитель

Для подключения из внешнего приложения используется COM-объект V83.COMConnector. Он регистрируется в системе при установке платформы; если регистрация слетела, компоненту можно зарегистрировать вручную командой regsvr32 для библиотеки comcntr.dll из каталога bin нужной версии платформы. Разрядность имеет значение: 64-разрядное приложение требует 64-разрядного соединителя.

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

// Пример на VBScript
Set connector = CreateObject("V83.COMConnector")
Set connection = connector.Connect("Srvr=""Server1"";Ref=""Trade"";Usr=""Обмен"";Pwd=""secret"";")
// Теперь доступны данные базы
остатки = connection.Справочники.Номенклатура.Выбрать()

Внутри кода 1С аналогичное подключение выполняется проще — через объект ВнешнееСоединение либо тот же COMConnector, созданный как COMОбъект. Второй вариант до сих пор встречается в старых обработках, хотя прямое внешнее соединение предпочтительнее по производительности.

1. 1
   Убедитесь, что на машине установлена платформа 1С той же версии, что и сервер, и зарегистрирована comcntr.dll нужной разрядности.
2. 2
   Создайте в целевой базе отдельного пользователя для интеграции с минимально необходимыми правами.
3. 3
   Сформируйте строку подключения: Srvr и Ref для серверной базы или File для файловой, плюс Usr и Pwd.
4. 4
   Создайте объект V83.COMConnector и вызовите Connect со строкой подключения.
5. 5
   Выполните нужные операции и освободите объект соединения, чтобы сеанс завершился и лицензия освободилась.

Запуск в режиме внешнего соединения из командной строки

Отдельный сценарий — запуск толстого клиента в режиме внешнего соединения. Исполняемый файл 1cv8.exe поддерживает параметры командной строки, позволяющие стартовать базу в нужном режиме и сразу выполнить внешнюю обработку. Это удобно для задач по расписанию: планировщик Windows запускает команду, обработка выполняется, сеанс закрывается.

"C:\Program Files\1cv8\8.3.22.1750\bin\1cv8.exe" ENTERPRISE /S"Server\Trade" /N"Обмен" /P"secret" /Execute"C:\Обмен\Загрузка.epf" /DisableStartupDialogs

Ключ /Execute указывает файл внешней обработки, которая запустится после входа. Ключи /DisableStartupDialogs и /DisableStartupMessages подавляют стартовые окна. Для файловой базы вместо /S используется /F"путь_к_каталогу". Обработка должна сама завершать сеанс вызовом ЗавершитьРаботуСистемы(Ложь), иначе процесс останется висеть.

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

Права, лицензии и безопасность

Каждое внешнее соединение — это сеанс, который занимает клиентскую лицензию. Если скрипт подключается в цикле или не освобождает объект соединения, лицензии быстро исчерпываются, и пользователи получают ошибку «не найдено свободной лицензии». Всегда явно завершайте соединение и обрабатывайте исключения, чтобы объект освобождался даже при ошибке.

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

Ещё одно ограничение: через внешнее соединение нельзя выполнять интерактивные действия и работать с модальными вызовами. Код, который штатно вызывает Вопрос(), Предупреждение() или открывает формы, в сеансе внешнего соединения выдаст исключение. Общие модули, предназначенные для вызова извне, должны быть написаны с учётом серверного неинтерактивного контекста.

Типичные ошибки и их устранение

Самая частая проблема — ошибка создания объекта V83.COMConnector («класс не зарегистрирован»). Причины: платформа не установлена на машине, не зарегистрирована comcntr.dll, либо несовпадение разрядности — 32-разрядный скрипт пытается использовать 64-разрядный компонент или наоборот. Лечится регистрацией библиотеки нужной разрядности через regsvr32 от имени администратора.

Вторая группа ошибок — отказ в подключении: неверные имя сервера или базы, недоступность сервера 1С по сети, неверный логин или пароль, блокировка базы. Текст исключения обычно содержит причину; проверяйте строку подключения, доступность сервера и то, не установлена ли в базе блокировка соединений.

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

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

После настройки проверьте базовые признаки успешного подключения. Объект соединения создался без исключения, простой запрос или чтение константы возвращает ожидаемое значение, а в консоли кластера (или в списке активных пользователей файловой базы) виден сеанс с типом «COM-соединение» или «Внешнее соединение» под нужным пользователем.

Отдельно проверьте завершение работы: после окончания скрипта сеанс должен исчезнуть из списка активных. Если сеанс остаётся висеть — объект не освобождён или процесс завис. Для регламентных запусков полезно вести лог: фиксировать время старта, результат и текст ошибки, чтобы проблемы обнаруживались сразу, а не когда пользователи заметят отсутствие данных.

FAQ