Как использовать протокол WebSocket в 1С:Предприятие 8.3.27 для двусторонней связи в реальном времени?

← На главную

С выходом версии платформы 1С:Предприятие 8.3.27 разработчики получили долгожданный инструмент — нативную поддержку протокола WebSocket. Это событие знаменует собой переход на новый уровень взаимодействия систем в реальном времени, позволяя отказаться от ресурсоемких «костылей» в виде постоянного опроса сервера (polling).

В этой статье мы подробно разберем, как устроена поддержка WebSocket в 1С, проанализируем архитектурные отличия от привычных HTTP-сервисов и научимся работать с новым объектом платформы ВебСокетКлиент.

В чем принципиальное отличие WebSocket от HTTP?

Для начала давайте выясним причину, по которой WebSocket стал стандартом для современных интерактивных приложений. Традиционный протокол HTTP работает по принципу «запрос-ответ». Чтобы клиент (1С) узнал о новых данных на сервере, он должен отправить запрос. Если данных нет, соединение закрывается, а через секунду цикл повторяется. Это создает огромную нагрузку на сеть и сервер.

WebSocket работает иначе:

Устанавливается единственное соединение (Handshake) через HTTP.
Протокол переключается на бинарный двунаправленный поток данных.
Соединение остается открытым. Сервер может «толкнуть» данные клиенту в любой момент без запроса со стороны последнего.

Рассмотрим сравнительную таблицу, чтобы закрепить понимание:

HTTP: Однонаправленный (клиент всегда инициатор), высокие задержки из-за пересоздания сессий, большой объем заголовков в каждом пакете.

WebSocket: Полнодуплексный (двусторонний), минимальные задержки, экономия трафика за счет отсутствия повторных заголовков.

Объект ВебСокетКлиент и асинхронная модель

В платформе 8.3.27 появился новый объект метаданных — ВебСокетКлиент. Важно понимать, что работа с ним строится исключительно на асинхронных вызовах. Это критически важно для того, чтобы интерфейс программы не «замирал» во время ожидания данных или установки соединения.

Рассмотрим основные методы, которые мы будем использовать:

ПодключитьсяАсинхронно() — инициирует соединение с сервером.
ОтправитьАсинхронно() — отправляет данные (текст или двоичные данные) на сервер.
ЗакрытьАсинхронно() — корректно завершает сеанс связи.

Разберем по шагам: реализация подключения

Проанализируем процесс создания подключения. Нам потребуется создать экземпляр объекта и назначить обработчики событий. В 1С предусмотрено четыре ключевых события:

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

Посмотрим на пример кода для инициализации соединения:


&НаКлиенте
Процедура УстановитьСоединениеWS()
    
    КлиентWS = Новый ВебСокетКлиент;
    
    // Настраиваем обработчики событий через ОписаниеОповещения
    ОповещениеПриОткрытии = Новый ОписаниеОповещения("ПриОткрытииСоединения", ЭтотОбъект);
    ОповещениеПриПолучении = Новый ОписаниеОповещения("ПриПолученииДанных", ЭтотОбъект);
    ОповещениеПриОшибке = Новый ОписаниеОповещения("ПриВозникновенииОшибки", ЭтотОбъект);
    ОповещениеПриЗакрытии = Новый ОписаниеОповещения("ПриЗакрытииСоединения", ЭтотОбъект);
    
    КлиентWS.УстановитьОбработчикПриОткрытии(ОповещениеПриОткрытии);
    КлиентWS.УстановитьОбработчикПриПолученииСообщения(ОповещениеПриПолучении);
    КлиентWS.УстановитьОбработчикПриОшибке(ОповещениеПриОшибке);
    КлиентWS.УстановитьОбработчикПриЗакрытии(ОповещениеПриЗакрытии);
    
    // Подключаемся к эхо-серверу для теста
    КлиентWS.ПодключитьсяАсинхронно("wss://echo.websocket.org");
    
КонецПроцедуры

Обработка входящих данных

Когда сервер присылает сообщение, срабатывает назначенный нами обработчик. Выясним, как правильно принять данные. Платформа поддерживает как обычный текст (JSON, XML), так и ДвоичныеДанные. Это открывает возможности для прямой интеграции с торговым оборудованием, системами мониторинга и SNMP-оповещениями или реализации прямого обмена сообщениями с Telegram без использования сторонних ботов.


&НаКлиенте
Процедура ПриПолученииДанных(Сообщение, ДополнительныеПараметры) Экспорт
    
    // Сообщение имеет тип ВебСокетСообщение
    Данные = Сообщение.Данные;
    
    Если ТипЗнч(Данные) = Тип("Строка") Тогда
        Сообщить("Получен текст: " + Данные);
    ИначеЕсли ТипЗнч(Данные) = Тип("ДвоичныеДанные") Тогда
        Сообщить("Получены бинарные данные, размер: " + Данные.Размер());
    КонецЕсли;
    
КонецПроцедуры

Безопасность и авторизация

Разберем важный аспект безопасности. 1С поддерживает защищенный протокол wss:// (WebSocket Secure), работающий поверх TLS. При создании соединения мы можем передать дополнительные параметры авторизации. Рассмотрим подробнее, как добавить заголовки HTTP (например, Bearer token) или Cookies, которые часто требуются современным API.

Для этого используется объект ВебСокетПараметрыИспользования. Мы можем программно задать:

Заголовки (Headers) для прохождения авторизации.
Прокси-сервер, если работа идет в защищенном корпоративном контуре.
Тайм-ауты ожидания ответа.

Ограничения и важные нюансы версии 8.3.27

Проанализируем ситуацию с доступностью функционала. На текущий момент платформа реализует только клиентскую часть WebSocket. Это означает:

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

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

Внимание: Начиная с версии 8.3.27, 1С прекратила поддержку устаревших ОС, таких как Windows XP и Windows Server 2008. Это цена перехода на современные сетевые протоколы, требующие актуальных библиотек безопасности.

Заключение

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