К статье
Практический материал

Другое · 5 мин

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

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

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

Основные средства — CreateObject для локального приложения и COMConnection для удалённого или уже запущенного экземпляра. Результат может быть строкой, числом, датой, массивом, коллекцией, ссылкой или объектом, а также вызывать ошибку, если объект недоступен.

Перед чтением проверьте, что целевое приложение установлено и зарегистрировано в системе, запускается под подходящей учётной записью, а 1С имеет права на создание COM-компонентов. Иначе вместо значения вы получите исключение или неопределённое значение.

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

COM уместно для локальной автоматизации приложений Windows, например таблиц, документов или почтовых клиентов, когда нужна прямая работа с объектной моделью программы. Это подходит для толстого клиента и отдельных сценариев на рабочем месте пользователя.

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

Порядок получения значения
  1. 1
    Убедитесь, что целевое приложение установлено и зарегистрировано в системе.
  2. 2
    Создайте COM-объект через CreateObject или подключитесь через COMConnection.
  3. 3
    Обратитесь к свойству или вызовите метод объекта.
  4. 4
    Проверьте тип результата и обработайте исключение.

Способы подключения к COM-объекту в 1С

Для локального приложения используйте CreateObject с идентификатором компонента, например CreateObject("Excel.Application"). Если нужно подключиться к уже запущенному экземпляру, уточните способ получения ссылки на объект в документации целевого приложения.

Для удалённого подключения примените COMConnection, указав сервер, пользователя и пароль при необходимости. Проверьте, что сетевые политики и права доступа позволяют создавать COM-компоненты от имени учётной записи, под которой работает 1С.

Простые значения: строка, число, дата

Скалярное значение присваивается напрямую: Значение = Объект.Свойство или Значение = Объект.Метод(). Даты и числа могут приходить в вариантах, которые 1С преобразует автоматически, но не всегда без потерь точности или формата.

Массивы, коллекции и ссылки на объекты

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

Проверка результата и обработка ошибок

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

Типичные ошибки
01
Указание неверного идентификатора компонента приводит к ошибке создания объекта, а не к отсутствию значения.
02
Чтение свойства из закрытого внешнего приложения вызывает исключение при обращении к уже несуществующему COM-объекту.
03
Попытка использовать COM в тонком клиенте или на сервере без проверки поддерживаемого режима работы.

Проверяйте результат на неопределённое значение и пустую ссылку перед дальнейшим использованием. Если COM-объект стал недействительным после закрытия внешнего приложения, повторное обращение к его свойствам приведёт к ошибке.

Ограничения, безопасность и альтернативы

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

Контрольные точки

Как проверить результат

Объект создан и ссылка не равна неопределённому значению
Норма

Свойство или метод возвращает ожидаемый тип значения

Тревожный признак

Получено исключение, пустая ссылка или несовместимый тип

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

Сравнение способов доступа к внешним данным

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

Итог

Что важно запомнить

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

Нужно ли регистрировать COM-компонент в системе?

Да, приложение должно быть установлено и его объектная модель доступна в системе. Без регистрации компонента CreateObject не сможет создать объект, и чтение значения не сработает.

Работает ли COM в веб-клиенте 1С?

Обычно нет или с существенными ограничениями, так как веб-клиент выполняется на сервере и в браузере, а не на рабочем столе пользователя. Проверяйте режим работы перед тем, как полагаться на COM.

Что делать, если метод возвращает другой COM-объект?

Присвойте результат переменной и продолжайте работу с ним как с COM-объектом: читайте свойства и вызывайте методы. Проверяйте, что ссылка не стала недействительной после закрытия внешнего приложения.

Какая альтернатива, если COM недоступен на сервере?

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