Интеграция учетных систем с внешними сервисами — одна из классических задач разработчика 1С. Нередко возникает ситуация, когда при наступлении определенного события необходимо собрать данные и передать их на сторонний веб-сервис в формате XML. При этом сохранять промежуточный файл на диск не требуется. Разберем подробно, какими инструментами платформы 1С:Предприятие 8 можно решить эту задачу, как правильно обращаться к удаленным методам и избежать типичных ошибок при работе с объектами WSПрокси и фабрикой XDTO.
Основной и наиболее правильный способ взаимодействия с SOAP веб-сервисами в 1С — это использование встроенных механизмов WS. При таком подходе платформа сама считывает WSDL-описание сервиса и формирует типизированные прокси-объекты.
Рассмотрим по шагам реализацию данного механизма:
WSОпределения, куда передается ссылка на WSDL, а также логин и пароль при наличии авторизации. Если сервис работает по протоколу HTTPS, дополнительно настраивается защищенное соединение через ЗащищенноеСоединениеOpenSSL.WSПрокси, в который передаются URI пространства имен, имя сервиса и имя точки подключения (порта).Посмотрим на практический пример вызова веб-сервиса с заполнением типизированных параметров:
// Настраиваем защищенное соединение при работе по HTTPS
ЗащищенноеСоединение = Новый ЗащищенноеСоединениеOpenSSL(
Новый СертификатКлиентаWindows(),
Новый СертификатыУдостоверяющихЦентровWindows()
);
ИмяВебСервиса = "https://example.com/ws/service.asmx?WSDL";
Пользователь = "login";
Пароль = "password";
// Считываем описание сервиса
WS_Определения = Новый WSОпределения(ИмяВебСервиса, Пользователь, Пароль,,, ЗащищенноеСоединение);
// Получаем метаданные сервиса
СервисДанные = WS_Определения.Сервисы[0];
Пространство = СервисДанные.URIПространстваИмен;
ИмяСервиса = СервисДанные.Имя;
ТочкаВхода = СервисДанные.ТочкиПодключения[0].Имя;
// Создаем прокси
Прокси = Новый WSПрокси(WS_Определения, Пространство, ИмяСервиса, ТочкаВхода,, ЗащищенноеСоединение);
Прокси.Пользователь = Пользователь;
Прокси.Пароль = Пароль;
Прокси.Таймаут = 60; // Указываем таймаут в секундах, чтобы избежать зависания
// Создаем структуру запроса через Фабрику XDTO веб-сервиса
ТипПараметра = Прокси.ФабрикаXDTO.Тип(Пространство, "RequestData");
WSПараметр = Прокси.ФабрикаXDTO.Создать(ТипПараметра);
WSПараметр.Address = "г. Москва";
WSПараметр.Phone = "+79990000000";
// Вызываем метод веб-сервиса
Результат = Прокси.SendData(WSПараметр);
Часто разработчики сталкиваются с ситуацией, когда код Прокси.ИмяМетода(Параметры) завершается аварийно с ошибкой «Поле объекта не обнаружено». Выясним причину этой проблемы. Она кроется в одной из следующих деталей:
СервисДанные.ТочкиПодключения[0].Имя, платформа может выбрать порт, не поддерживающий требуемую операцию. Необходимо явно указывать имя SOAP-порта (например, ServiceNameSoap).name у тега wsdl:operation в схеме, а не имя входящего XDTO-сообщения или сложного типа данных.Document/literal. Если сторонний сервис описан в устаревшем стиле RPC/encoded, платформа не сможет динамически сгенерировать исполняемые методы у объекта WSПрокси.Если у вас уже есть готовая XML-строка, сформированная по правилам удаленного сервиса, вовсе не обязательно вручную заполнять каждый реквизит XDTO через цикл. Преобразуем входящую строку напрямую в объект нужного типа с помощью фабрики XDTO:
// Допустим, у нас есть строка с XML-данными
ТекстXML = "<RequestData xmlns=""http://example.com/service"">"
+ " <Address>г. Москва</Address>"
+ " <Phone>+79990000000</Phone>"
+ "</RequestData>";
// Читаем XML из памяти
ЧтениеXML = Новый ЧтениеXML;
ЧтениеXML.УстановитьСтроку(ТекстXML);
// Получаем целевой тип XDTO из фабрики прокси
ТипОбъекта = Прокси.ФабрикаXDTO.Тип("http://example.com/service", "RequestData");
// Десериализуем строку в полноценный объект XDTO
ОбъектПараметра = Прокси.ФабрикаXDTO.ПрочитатьXML(ЧтениеXML, ТипОбъекта);
ЧтениеXML.Закрыть();
// Передаем десериализованный объект в метод сервиса
Результат = Прокси.SendData(ОбъектПараметра);
Чтобы не сохранять XML во временные файлы на жестком диске перед отправкой, задействуем связку объекта ЗаписьXML и оперативной памяти платформы. Метод УстановитьСтроку() позволяет производить запись прямо в переменную:
ЗаписьXML = Новый ЗаписьXML;
ЗаписьXML.УстановитьСтроку(); // Инициализация записи в память
ЗаписьXML.ЗаписатьОбъявлениеXML();
ЗаписьXML.ЗаписатьНачалоЭлемента("RootData");
ЗаписьXML.ЗаписатьАтрибут("Version", "1.0");
ЗаписьXML.ЗаписатьНачалоЭлемента("Item");
ЗаписьXML.ЗаписатьТекст("Значение элемента");
ЗаписьXML.ЗаписатьКонецЭлемента(); // Item
ЗаписьXML.ЗаписатьКонецЭлемента(); // RootData
// Получаем готовую XML-строку
ИтоговыйXML = ЗаписьXML.Закрыть();
В некоторых случаях обращение через WSПрокси бывает невозможным: сервис требует специфические заголовки, цифровую подпись сообщения WS-Security (WSS) или использует нестандартные типы данных. В такой ситуации формируют SOAP-конверт вручную и отправляют его как стандартный HTTP POST-запрос.
Важное замечание: использование внешних COM-объектов Windows (таких как MSXML2.xmlHttp или WinHttp.WinHttpRequest) делает код неработоспособным на серверах под управлением Linux. Рекомендуется использовать встроенный кроссплатформенный объект HTTPСоединение.
Разберем пример отправки сырого XML через HTTPСоединение:
// Формируем полный текст SOAP-конверта
ТекстЗапросаSOAP =
"<soapenv:Envelope xmlns:soapenv=""http://schemas.xmlsoap.org/soap/envelope/"" xmlns:ws=""http://example.com/service"">" +
" <soapenv:Header/>" +
" <soapenv:Body>" +
" <ws:SendData>" +
" <ws:Address>г. Москва</ws:Address>" +
" <ws:Phone>+79990000000</ws:Phone>" +
" </ws:SendData>" +
" </soapenv:Body>" +
"</soapenv:Envelope>";
Сервер = "example.com";
Порт = 443;
Путь = "/ws/service.asmx";
ЗащищенноеСоединение = Новый ЗащищенноеСоединениеOpenSSL();
Соединение = Новый HTTPСоединение(Сервер, Порт, "login", "password",, 60, ЗащищенноеСоединение);
Запрос = Новый HTTPЗапрос(Путь);
// Устанавливаем обязательные заголовки для SOAP 1.1
Запрос.Заголовки.Вставить("Content-Type", "text/xml; charset=utf-8");
Запрос.Заголовки.Вставить("SOAPAction", "http://example.com/service/SendData");
// Записываем тело запроса из строки в UTF-8 без использования BOM
Запрос.УстановитьТелоИзСтроки(ТекстЗапросаSOAP, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
Попытка
Ответ = Соединение.ОтправитьДляОбработки(Запрос);
Если Ответ.КодСостояния = 200 Тогда
ТекстОтвета = Ответ.ПолучитьТелоКакСтроку(КодировкаТекста.UTF8);
// Обрабатываем полученный XML-ответ
Иначе
ВызватьИсключение "Ошибка сервиса. Код: " + Ответ.КодСостояния;
КонецЕсли;
Исключение
Сообщить("Не удалось выполнить запрос к сервису: " + ОписаниеОшибки());
КонецПопытки;
WSПрокси или HTTPСоединение. По умолчанию он равен 0 (бесконечное ожидание), что при проблемах на стороне шлюза приведет к полной блокировке сеанса пользователя или зависанию фонового задания.WSОпределения кэширует схему сервиса на время сеанса 1С. Если разработчики удаленного сервиса обновили состав методов, 1С не увидит изменений до перезапуска сеанса (или перезапуска рабочего процесса сервера 1С).