Внешнее соединение 1С и общий модуль: что это значит и как использовать

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

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

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

Что такое внешнее соединение 1С и зачем оно нужно

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

Типовые сценарии использования:

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

Важно понимать: внешнее соединение создаёт полноценный сеанс в базе. Оно занимает лицензию, отображается в консоли кластера (для клиент-серверного варианта) и выполняется с правами указанного пользователя. Это не «лёгкий» способ доступа — по нагрузке сеанс сопоставим с работой обычного пользователя без интерфейса.

Какую роль играет общий модуль при внешнем подключении

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

Чтобы процедура общего модуля была доступна извне, должны совпасть три условия:

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

Если хотя бы одно условие не выполнено, при попытке вызова возникнет ошибка вида «Метод объекта не обнаружен (ИмяПроцедуры)» или «Попытка передачи с клиента на сервер мутабельного значения». Это самая частая причина, по которой «общий модуль не виден» через внешнее соединение.

Как настроить общий модуль для работы через внешнее соединение

Настройка выполняется в конфигураторе и занимает несколько минут. Порядок действий:

1. Откройте конфигуратор, найдите нужный общий модуль в ветке «Общие → Общие модули» (или создайте новый, например ОбменВнешний).
2. Откройте палитру свойств модуля (правый клик → «Свойства»).
3. Установите флаги: Сервер, Внешнее соединение, Вызов сервера. Флаг «Привилегированный режим» ставьте только если процедурам действительно нужен обход прав — это снижает безопасность.
4. Напишите экспортную процедуру или функцию с параметрами и возвращаемым значением.
5. Обновите конфигурацию базы данных (F7), иначе изменения не попадут в рабочую базу.

Пример минимального общего модуля:

Функция ПолучитьОстатокТовара(НоменклатураСсылка) Экспорт
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ ЕСТЬNULL(СУММА(Остатки.КоличествоОстаток), 0) КАК Остаток
|ИЗ РегистрНакопления.ТоварыНаСкладах.Остатки(, Номенклатура = &Номенклатура) КАК Остатки";
Запрос.УстановитьПараметр("Номенклатура", НоменклатураСсылка);
Выборка = Запрос.Выполнить().Выбрать();
Выборка.Следующий();
Возврат Выборка.Остаток;
КонецФункции

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

1. 1
   Создайте или откройте общий модуль в конфигураторе
2. 2
   В свойствах включите флаги «Сервер», «Внешнее соединение», «Вызов сервера»
3. 3
   Объявите процедуру или функцию с ключевым словом Экспорт
4. 4
   Обновите конфигурацию базы данных (F7)
5. 5
   Проверьте вызов через тестовый скрипт подключения

Как подключиться и вызвать процедуру: пример кода

Подключение из другой базы 1С выполняется через COM-коннектор. Типовой код выглядит так:

Коннектор = Новый COMОбъект("V83.COMConnector");
СтрокаПодключения = "Srvr=""Server1C""; Ref=""TradeBase""; Usr=""Обмен""; Pwd=""Пароль"";";
Соединение = Коннектор.Connect(СтрокаПодключения);

Остаток = Соединение.ОбменВнешний.ПолучитьОстатокТовара(СсылкаНаТовар);
Сообщить("Остаток: " + Остаток);

Для файловой базы строка подключения другая: File="C:\Bases\Trade"; Usr="Обмен"; Pwd="Пароль";. Для подключения из внешних скриптов (например, VBScript или PowerShell) используется тот же COM-объект — CreateObject("V83.COMConnector").

Несколько практических правил вызова:

• Обращение к модулю идёт по цепочке Соединение.ИмяМодуля.ИмяПроцедуры(Параметры) — без создания экземпляров.
• Параметры-ссылки передаются как COM-объекты ссылок той же базы; ссылку из «своей» базы передать нельзя — ищите объект по GUID или по реквизитам (код, наименование).
• Каждое обращение через COM — это сетевой вызов. Цикл из тысячи обращений по одному элементу работает на порядки медленнее, чем один вызов, обрабатывающий пакет данных целиком.

Коннектор = Новый COMОбъект("V83.COMConnector");
Соединение = Коннектор.Connect("File=""C:\Bases\Trade""; Usr=""Обмен""; Pwd=""123"";");
Результат = Соединение.ОбменВнешний.ПолучитьОстатокТовара(Ссылка);
Соединение = Неопределено; // закрытие сеанса

Ограничения и риски внешнего соединения

Внешнее соединение — мощный, но небезопасный при неосторожном применении механизм. Основные ограничения:

• Лицензии. Каждое соединение занимает клиентскую лицензию. Скрипт, забывший закрыть соединение, держит лицензию до завершения процесса.
• Версии платформы. Имя COM-класса зависит от версии платформы (V83 для 8.3). Если на машине несколько версий, регистрируется та, чья компонента зарегистрирована последней — возможны подключения «не к той» версии.
• Интерактивные вызовы. В контексте внешнего соединения недоступны модальные окна, предупреждения, оповещения пользователя — код с такими вызовами завершится ошибкой.
• Права. Процедуры выполняются с правами пользователя, указанного в строке подключения. Создавать для обмена отдельного пользователя с минимально необходимыми правами — обязательная практика.

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

Диагностика типичных ошибок

Большинство проблем при работе через внешнее соединение сводится к нескольким узнаваемым сообщениям:

Если соединение устанавливается, но вызов «молча» возвращает не то, что ожидалось, добавьте в общий модуль временное логирование — запись в журнал регистрации или в файл. Отладчиком внешнее соединение ловить сложнее: сеанс нужно явно разрешить для отладки в свойствах базы (флаг «Отладка разрешена» и протокол отладки).

Альтернативы внешнему COM-соединению

COM-подключение — не единственный и не всегда лучший способ интеграции. В зависимости от задачи рассмотрите варианты:

• HTTP-сервисы и веб-сервисы — платформа позволяет опубликовать собственные HTTP/ SOAP-сервисы. Подходит для интеграции с не-Windows системами и через интернет; COM в таких сценариях не работает.
• Стандартный REST-интерфейс (OData) — автоматически генерируемый доступ к данным базы без написания кода, но с ограниченной логикой.
• Планы обмена и файловый обмен — надёжнее для регулярной синхронизации: данные передаются пакетами с подтверждением, сбой не рушит процесс.
• Фоновые задания и регламентные операции — если задача выполняется внутри одной базы, внешнее соединение вообще не нужно.

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

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

После настройки выполните контрольную проверку по трём точкам: соединение устанавливается, процедура вызывается, результат соответствует данным в базе. Простейший тест — функция, возвращающая константу или текущую дату сервера: если она отработала, цепочка «коннектор → соединение → общий модуль → экспортная функция» исправна целиком.

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

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