WS-ссылки в 1С: что это и как с ними работать

WS-ссылка в 1С — это объект конфигурации, который описывает подключение к внешнему веб-сервису по протоколу SOAP. По сути, платформа берёт WSDL-описание сервиса (адрес, операции, типы данных) и превращает его в удобный объект, через который из встроенного языка можно вызывать операции удалённого сервиса так, будто это обычные методы 1С.

Механизм нужен, когда информационная база должна обмениваться данными с внешними системами: банковскими сервисами, проверкой контрагентов, службами доставки, государственными порталами, другими базами 1С, опубликованными как веб-сервисы. Вместо ручной сборки XML-пакетов разработчик работает со знакомыми объектами платформы.

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

Что такое WS-ссылка и из чего она состоит

WS-ссылка (WSReference) — это не сам сервис и не подключение, а «паспорт» веб-сервиса внутри конфигурации. При добавлении ссылки платформа загружает WSDL-документ по указанному URL и сохраняет его в конфигурации. В этот момент фиксируются пространство имён сервиса, список операций, типы параметров и возвращаемых значений.

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

Где в конфигураторе находятся WS-ссылки

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

Чтобы увидеть состав существующей ссылки, откройте её свойства: там указаны URL WSDL-файла, URL-точка подключения и пространство имён. Изменение этих параметров требует обновления конфигурации базы данных, поэтому правки выполняйте в тестовой копии, если база рабочая.

Как создать WS-ссылку: пошагово

1. 1
   Откройте конфигуратор, ветка «Общие» → «WS-ссылки», нажмите «Добавить».
2. 2
   Укажите URL WSDL-документа сервиса — обычно это адрес вида http://сервер/путь?wsdl или ссылка на .wsdl-файл.
3. 3
   Дождитесь загрузки описания: платформа покажет дерево операций и типов данных.
4. 4
   Проверьте пространство имён и точку подключения, при необходимости скорректируйте адрес реального сервиса.
5. 5
   Сохраните конфигурацию и обновите конфигурацию базы данных.
6. 6
   Проверьте вызов простой операции без параметров из внешней обработки или консоли кода.

Если WSDL недоступен по сети (например, сервис в закрытом контуре), файл описания можно сохранить локально и указать путь к нему при создании ссылки. Учтите, что точка подключения внутри файла всё равно должна указывать на реальный рабочий адрес сервиса, иначе вызовы операций будут уходить «в никуда».

Как вызвать операции веб-сервиса из кода

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

Определение = Новый WSОпределения(WSСсылки.МойСервис);
Прокси = Новый WSПрокси(Определение,
    "http://example.com/service",  // пространство имён
    "MyService",                   // имя сервиса
    "MyServiceSoap");              // имя точки подключения
Результат = Прокси.GetInfo("параметр");

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

Сложные параметры операций создаются через фабрику XDTO: объект Прокси.ФабрикаXDTO позволяет построить значение типа, описанного в WSDL, заполнить его свойства и передать в вызов. Примитивные типы (строки, числа, даты) передаются напрямую.

Аутентификация, прокси-сервер и таймауты

Большинство промышленных сервисов требуют аутентификацию. Базовая (Basic) авторизация задаётся параметрами пользователя и пароля в конструкторе WSПрокси. Хранить пароль открытым текстом в коде нельзя — используйте безопасное хранилище данных или параметры сеанса, задаваемые администратором.

Если сервер 1С выходит в интернет через корпоративный прокси, настройте его в конструкторе: Новый ИнтернетПрокси с указанием сервера, порта и учётных данных. Без этого вызов зависнет или вернёт ошибку соединения, хотя с рабочей станции разработчика сервис может открываться нормально — проверяйте доступ именно с сервера, где работает кластер 1С.

Таймаут по умолчанию может быть слишком большим для интерактивных операций. Задавайте его явно последним параметром конструктора WSПрокси, чтобы «мёртвый» сервис не блокировал сеанс пользователя на минуты. Для длительных операций выносите вызов в фоновое задание.

Типичные ошибки и их причины

Отдельная группа проблем — кодировка и национальные символы. Если в ответе «кракозябры», проверьте, что сервис корректно отдаёт UTF-8, и не пытайтесь чинить это перекодировкой строк в 1С: проблема почти всегда на стороне сервиса или промежуточного прокси.

WS-ссылка или HTTP-запрос: что выбрать

Правило выбора простое: если у поставщика сервиса есть WSDL — берите WS-ссылку, это быстрее и надёжнее за счёт контроля типов. Если документация описывает REST с JSON — используйте HTTPСоединение, попытка «натянуть» WS-ссылку на REST не удастся.

Как проверить, что интеграция работает

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

Частые вопросы о WS-ссылках в 1С