Web-сервисы: Сервис по работе с курсами валют
Введение
Данный модуль предназначен для работы с курсами валют.
Установка
Для установки Сервиса по работе с курсами валют нужно создать директорию WebServices в каталоге c:/inetpub/wwwroot/MasterWeb и выложить туда распакованные файлы из архива mw-megatecwebservices-2007.2.XX.XXXX.zip. В управлении IIS необходимо создать виртуальный каталог для папки WebServices.
Создание виртуального каталога
По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:
- 1. Зайти в Пуск (Start) – Настройки (Settings) – Панель управления (Control Panel)
- 2. В открывшемся окне выбрать Администрирование (Administrative Tools)
- 3. Запустить Internet Information Services (IIS) Manager
- 4. В открывшемся дереве каталогов выбрать Web Sites – Default Web Site. В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и зайти в Свойства (Properties)
- 5. В открывшемся окне, в закладке Directory нужно нажать кнопку «Create», а затем кнопку «ОК»
Подключение к базе данных ПК «Мастер-Тур»
В файле web.config, расположенном в папке WebServices пропишите необходимые параметры подключения (курсивом выделены значения, которые необходимо ввести). Строка подключения к базе данных ПК «Мастер-Тур»:
- 1. <add key = "connectionString" value = "Data Source=ip-адрес сервера базы данных ПК Мастер-тур;Initial Catalog=название базы данных ПК Мастер-тур;User ID=логин пользователя ПК Мастер-тур;Password=пароль пользователя ПК Мастер-тур"/>
- 2. <add key = "connectionStringShort" value = "Data Source=ip-адрес сервера базы данных ПК Мастер-Тур;Initial Catalog=название базы данных ПК Мастер-Тур"/>
Настройка
После установки «Сервис по работе с курсами валют» доступен по адресу http://ip- адрес сервера Мастер-Веб/WebServices/Rates.asmx.
Настройки web.config приложения ПК Мастер-Web
Дополнительные настройки, задаваемые в файле web.config, находящемся в папке MasterWeb позволяют задать дополнительные условия для отображения и проверки данных.
Описание:Путь к приложению WebServices
Значение:Ссылка на приложение WebServices
Настройка:<add key="webServicesSource" value="http://localhost/MasterWeb/WebService"/>
Добавление секций
- 1. В секции <ConfigSections> необходимо добавить подсекцию:
<sectionGroup name="Megatec.Web.Services"> <section name="servicesAccessibility" type="Megatec.Configuration.WebServicesSection, Megatec.Configuration"/> </sectionGroup>
- 2. На одном уровне с секцией <ConfigSections> необходимо добавить секцию:
<Megatec.Web.Services> <servicesAccessibility Enabled="true"> <Services> <add name="DoSearch" enabled="true"/> </Services> </servicesAccessibility> </Megatec.Web.Services>
Подготовка данных
Требования по подготовке данных в ПК Мастер-тур
В целях избежание ошибок в процессе бронирования предварительно должны быть корректно заполнены соответствующие справочники в ПК Мастер-Тур.
Справочник в ПК Мастер-Тур | Вносимые данные |
---|---|
Список валют | Код валюты |
Курс национальной валюты | Курс валюты |
Реальные кросс-курсы валют | Курсы валют |
Работа в системе
Exchange
Метод Exchange предназначен для пересчета стоимости из одной валюты в другую.
Для получения результата необходимо передать следующие значения:
- «cost» - сумма или стоимость, которую нужно пересчитать
- «rateCodeFrom» - код валюты, из которой нужно произвести конвертацию
- «rateCodeTo» - код валюты, в которую необходимо конвертировать стоимость
- «exchangeDate» - дата, на которую необходимо взять курсы валют.
Результаты возвращаются в виде xml-файлов.
GetCourse
Метод GetCourse предназначен для получения кросс-курса валют.
Для получения результата необходимо передать следующие значения:
• «rateCodeFrom» - код валюты, кросс-курс которой нужно вывести
• «rateCodeTo» - код валюты 2
• «exchangeDate» - дата, на которую необходимо взять курсы валют.
Результаты возвращаются в виде xml-файлов.
GetNationalCourse
Метод GetNationalCourse предназначен для получения курса валюты.
Для получения результата необходимо передать следующие значения:
- «rateCode - код валюты, курс которой нужно получить
- «exchangeDate» - дата, на которую необходимо взять курс валют.
Результаты возвращаются в виде xml-файлов.
GetNationalCourseToday
Метод GetNationalCourseToday предназначен для получения курса валюты на текущую дату.
Для получения результата необходимо передать следующие значения:
- «rateCode - код валюты, курс которой нужно получить
Результаты возвращаются в виде xml-файлов.
GetNationalRateCode
Метод GetNationalRateCode предназначен для получения кода национальной валюты.
Данный метод не принимает параметров.
Результаты возвращаются в виде xml-файлов.