Веб-сервисы 1С: что это, как создать и настроить

Веб-сервис в 1С

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

1С поддерживает создание веб-сервисов, работающих в качестве:

• потребителя, использующего веб-сервисы сторонних поставщиков;
• поставщика, предоставляющего доступ к своим сервисам.

В версии «1С:Предприятие 8.3» можно добавлять собственные web-сервисы даже в стандартные конфигурации для обмена данными с другими программами.

Поставщик web-сервисов

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

Потребитель web-сервисов

Этот тип веб-сервисов позволяет указывать ссылку на опубликованный сторонним поставщиком web-сервис. После этого прикладное решение сможет использовать данные из этого источника в своих алгоритмах и операциях.

Как настроить веб-сервис в 1С

При использовании клиент-серверного или файлового режима взаимодействие между потребителями и поставщиками веб-сервисов осуществляется через модуль расширения web-сервера. Этот модуль включен в конфигурацию и выполняет определенные процессы при вызове сервисных функций.

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

Программа «1С:Предприятие» поддерживает оптимизированную передачу бинарных данных по протоколу MTOM (режим активируется автоматически).

Как создать веб-сервис в 1С

Для интеграции стороннего ПО и 1С необходимо выполнить следующие шаги:

1. Открыть конфигурацию, добавить объект — веб-сервис в соответствующем разделе.
2. Определить операции, которые будет выполнять сервис, используя встроенный язык 1С.
3. Настроить параметры веб-сервиса с учетом механизмов XDTO.
4. Опубликовать веб-сервис на сервере.

Программа поддерживает стандарты WS-I BP, SSL/TLS, HTTP, WSDL и SOAP.

Обмен данными между информационными базами

С помощью веб-сервисов можно загружать и выгружать данные между разными информационными базами. Для этого необходимо использовать IIS или Apache.

Пример обмена:

• В удаленной базе создается веб-сервис с определенным именем.
• В разделе «Прочее» указываются параметры web-сервиса, включая «URL Пространства имен» для идентификации.
• Используются XDTO-пакеты для передачи данных в формате XML.
• Указывается имя файла публикации с расширением .1CWS и соответствующее название каталога на веб-сервере.

Далее необходимо создать операции для загрузки и выгрузки информации:

• Сформируйте операцию, например, с типом значения «ХранилищеДанных» и наименованием «ОстаткиПродукцииНаСкладах».
• Укажите параметры для процедуры. Например: Склад – с типом Строка, ОкончаниеПериода – с типом Дата, НачалоПериода – с типом Дата. 
• Пропишите программный код для операции «ОстаткиПродукцииНаСкладах». В свойствах операции выберите строку «ИмяПроцедуры», а затем модуль веб-сервиса. Нужные сведения будут предоставлены запросом.
• Опубликуйте web-сервис. Теперь сторонняя база, создав внешнюю оболочку и прописав соответствующий код, может подключиться к нему. Подключенная база сможет получать данные об остатках за выбранный период по конкретному складу.

Отладка веб-сервиса в 1С

Отладка как получателя:

1. В режиме «Предприятие» запустите «ПолучательWS» при запущенном конфигураторе «ПоставщикWS».
2. В разделе «Справочники» откройте обработку «Сотрудники через WS».
3. Укажите в строке поиска ФИО сотрудника (необязательно).
4. Нажмите «Получить список сотрудников» — откроется отладка модуля веб-сервиса.

Отладка как поставщика:

1. Запустите конфигуратор «Поставщика».
2. Опубликуйте веб-сервис «Сотрудники», добавьте точку остановки в коде.
3. В разделе «Сервис-Параметры» активируйте опцию «Устанавливать режим разрешения отладки».
4. В меню «Отладка-Подключение» включите автоматическое подключение web-сервисов.

Пример создания веб-сервиса в 1С

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

Инструкция:

1. В конфигураторе создайте веб-сервис, например «wa_LengthString».
2. Добавьте операцию «CalcLengthString» с типом возвращаемого значения integer и int.
3. Создайте параметр «InputString» с типом string.
4. В модуле веб-сервиса пропишите действие «CalcLengthSring». Для этого перейдите в свойства сформированного функционала, нажмите на лупу (расположена у строки ввода «Имени процедуры» в правой части). 
5. Программа сформирует функционал в модуле веб-сервиса и активирует для описания работы функции «CalcLengthSring». Действие функции укажите – определение длины введенной строки.
6. Опубликуйте веб-сервис.

Как опубликовать веб-сервис на сервере

Для публикации веб-сервиса требуется доступ к веб-серверу.

Инструкция:

1. Проверьте название файла веб-сервиса (например, «wa_LengthString.1cws»).

2. В конфигураторе откройте «Публикация на веб-сервере» в разделе «Администрирование».

3. Настройте параметры:

• Каталог: путь к серверу.
• Web-сервер: выбор установленного сервера.
• Имя: название папки, где будет находиться веб-сервис.
• Признаки: первый признак нужен, если требуется выполнить настройку доступа к конфигурации через веб-клиент. Для публикации веб-сервиса 1С нам нужна вторая отметка.

4. Убедитесь, что напротив сервиса стоит галочка, затем нажмите «Опубликовать».

5. Проверьте доступность сервиса в браузере.

6. Если браузер отображает структуру XML-файла, сервис опубликован успешно.

При возникновении ошибок, например, «Сбой при проведении файловой операции», повторите попытку.