Использование внешних вебсервисов в 1С на примере загрузки курсов валют на Хабре

Использование внешних веб-сервисов в 1С на примере загрузки курсов валют.

Знаю, что на хабре не очень-то жалуют многострадальную 1С. Хотя, с выходом платформы 8.3 (с клиентами под Linux), ее стали любить несколько больше. Кстати, так же, совсем недавно интерфейс одной из основных разработок 1С — конфигурация Управление производственным предприятием — был полностью переведен на английский язык. Много раз я встречал вопросы о том, почему здесь не пишут об 1С. Ответ на них довольно очевиден — существует множество ресурсов, где можно оперативно обсудить все вопросы и что-то почитать.

В 1С есть некоторые интересные вещи, которые стоит рассказать.

С некоторых пор в 1С 8. появилась возможность использования веб-сервисов: 1С может выступать в качестве поставщика, так и потребителя. В этой статье я покажу, как использовать 1С в качестве потребителя на примере использования курсов валют с сервера ЦБР.

Веб-сервис.

У Центробанка существует веб-сервис для получения ежедневных данных: курсы валют, новости, динамика курсов и т.д. Описание сервиса можно найти здесь http://www.cbr.ru/scripts/Root.asp?Prtid=DWS. Нас интересует один из методов этого сервиса: GetCursOnDate (On_date) — получение курсов валют на заданную дату. В методе передается один аргумент On_date — это дата, на которую требуется получить курсы. В результате возвращается XML, представленная таблица ValuteCursOnDate (сами курсы и сопутствующая информация).

Конфигурирование.

Для разработки я взял 1С 8.2 (8.2.15.317 в моем случае) и создал пустую конфигурацию. Для использования внешних веб-сервисов предусмотрен объект WS-ссылки, но использовать его не обязательно, к сервису можно использовать динамически из кода. Я буду использовать первый вариант, а затем покажу, как можно использовать второй. В создал конфигурацию обработки и назвал ее «ЗагрузкаКурсовВалютЦБР». Добавил форму (управляемую) и сделал ее основной. На рисунке я создал реквизиты и разместил элементы управления так, как показано на рисунке..

Сейчас самое главное — создаем ссылку на описание веб-сервиса. В конфигурации добавляем новый объект типа WS-ссылка. В появившемся окне указываем ссылку на WSDL (описание данного формата выходит за рамки статьи, вы можете почитать о нем на Википедии): http://www.cbr.ru/DailyInfoWebServ/DailyInfo.asmx?WSDL.

1С на основании полученного описания автоматически создаст визуальную карту веб-сервиса. Можно увидеть название веб-сервиса, посмотреть какие у него доступны операции а так же используемые данные.

Конфигурация настроена на этом почти закончено, чтобы приложение выглядело более эстетично. Кликнем командной кнопкой мыши по корню конфигурации и вызовем меню «Открыть интерфейс рабочего стола». В появившемся окне необходимо снять флаг «Видимость» напротив обработки «Загрузка курсов валют ЦБР». Нажмем кнопку Ок. Далее еще правый клик по корню конфигурации и вызовем меню «Открыть рабочую область рабочего стола», там сделаем настройку как на рисунке:

Эти настройки позволяют нам подставить форму обработки прямо на рабочем столе (имеется ввиду рабочий стол программы 1С) в режиме 1С Предприятие.

Программирование.

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

Здесь сначала проверяется, заполнена ли дата (если не заполнена, то сообщаем об этом пользователю и больше ничего не делаем). Затем очищается процедура, расположенная на форме и вызывается ЗагрузитьКурсыВалют (), в которую передается процедура.

Код процедуры ЗагрузитьКурсыВалют (), пояснения данны в комментариях к коду:

Теперь можно обновлять конфигурацию БД (F7) и запускать 1С Предприятие (F5). Если все сделали верно, то должны увидеть окно как на рисунке ниже:

Чтобы получить результат, нам нужно проверить, нажмите на кнопку «Загрузить валюту». В случае успешного запроса, таблица на форме заполнится значениями курсов:

Напоследок хочу показать, как можно обратиться динамически к внешнему веб-сервису, то есть без добавления объекта WS-ссылка. Таким образом мы можем использовать такие веб-сервисы из внешних обработок без привязки к конфигурации.

В процедуре ЗагрузитьКурсыВалют () ввод.

необходимо заменить двумя строками.

Сначала мы создаем так называемые определения для веб-сервиса из его WSDL. Затем так же создаем прокси для обращения к нему.

Как видно, использовать внешние веб-сервисы из 1С в целом довольно просто (хотя и есть некоторая сложность в понимании типов, у меня в том числе).

Если данная публикация найдет здесь отклик, то есть еще несколько тем, о которых можно рассказать.

По ссылке можно скачать конфигурацию с примером (cf-файл).

Похожие статьи