WS-ссылка 1С - это общий объект конфигурации, предназначенный для доступа к сторонним веб-сервисам по статической ссылке, которая состоит:
- из модели данных (по сути - пакета XDTO);
- web-сервиса, с которого опубликована ссылка.
WS-ссылка представляет собой WSDL описание веб-сервиса стороннего производителя (его реквизитов и типов данных), импортированное из указанного источника и предназначенное для последующей интеграции со сторонним веб-сервером (веб-сервисом другой базы 1С, другой программы или веб-сайта).
Язык описания веб-сервисов WSDL (Web Services Description Language) основан на языке XML. В июне 2007 года была утверждена WSDL 2.0 в качестве стандарта W3C (World Wide Web Consortium), но несмотря на это версия WSDL 1.1 остается широко используемой формой описания Web-сервисов SOAP.
WS-ссылка недоступна для редактирования, однако можно просмотреть ее структуру и структуру типов данных, которые используются для описания параметров и возвращаемых значений.
Пример настройки, свойств, методов использования WS-ссылки на примере ссылки из библиотеки стандартных подсистем 1С — «ОтправкаSMSЧерезМТС».
Добавление WS-ссылки 1С
Добавление WS-ссылки на веб-сервис производится в конфигураторе командой "Добавить" с указанием пути к WSDL описанию веб-сервиса. В результате добавления WS-ссылки 1С будет автоматически создана такая же структура, какая создается вручную при добавлении Web-сервиса.
Ссылку на веб-сервис в конфигурацию добавлять не обязательно, ее можно создавать динамически при выполнении кода на языке 1С (указав URL WSDL описания). Однако при этом следует учитывать, что на импорт WSDL в момент создания объекта будет потрачено некоторое время.
ВАЖНО! При добавлении WS-ссылки ошибка «Extra content at the end of the document» возникает, если:
- используется прокси и 1С не смогла произвести соединение с веб-сервисом;
- не верный формат XML в описании веб-сервиса.
Пример функции вызова Web-сервиса
Работа с WS-ссылками на примере ЦБ РФ