Web-сервисы: Сервис поиска и бронирования авиабилетов
Данный модуль не поддерживается.
Версия статьи от 5-06-2015.
Содержание
Введение
Данный модуль предназначен для поиска и подбора данных по рейсам, проверки их стоимости и наличия мест.
Установка
Для установки Сервиса поиска авиабилетов нужно создать отдельную директорию, например, wsaviasearch (далее в примерах будет использоваться данное название каталога) в корневом каталоге IIS (по умолчанию c:/inetpub/wwwroot) и выложить туда распакованные файлы из архива mw-ws-aviasearch-2009.2.XX.XXXX.zip.
В управлении IIS необходимо создать виртуальный каталог для папки wsAviaSearch.
Создание виртуального каталога
По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:
1. Зайти в Пуск (Start) – Панель управления (Control Panel) – Администрирование (Administrative Tools).
2. Запустить Internet Information Services (IIS) Manager.
3. В открывшемся дереве каталогов выбрать сайты (Web Sites) – Default Web Site (либо другой сайт, на который планируется установить приложение). В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и выбрать пункт «Преобразовать в приложение».
Подключение к базе данных ПК «Мастер-Тур»
В файле web.config, расположенном в папке wsAviaSearch, в которую установлен web-сервис «Сервис поиска авиабилетов», пропишите необходимые параметры подключения (курсивом выделены значения, которые необходимо ввести). Строка подключения к базе данных ПК «Мастер-Тур»:
<add key = "connectionString" value = "Data Source=ip-адрес сервера базы данных ПК Мастер-тур;Initial Catalog=название базы данных ПК Мастер-тур;User ID= логин пользователя ПК Мастер-тур;Password=пароль пользователя ПК Мастер-тур"/>
Настройка
После установки «Сервис поиска авиабилетов» доступен по адресу: http://ip-адрес сервера Мастер-Веб/wsAviaSearch/TicketSerachService.asmx.
Подготовка данных
Выставление туров в интернет
Требования по подготовке данных в ПК «Мастер-тур»
В целях избежания ошибок в процессе бронирования предварительно должны быть корректно заполнены соответствующие справочники в ПК «Мастер-Тур».
Справочник в ПК «Мастер-Тур» | Вносимые данные | Примечание |
---|---|---|
Авиаперелеты | Расписание авиарейсов | Необходимо для подбора авиаперелетов при выборе направления |
Трансферы | Город, к которому привязан трансфер; место отправки и прибытия |
Пример: трансфер Анталья - Сиде должен быть привязан к городу Анталья, трансфер Сиде-Анталья должен быть привязан к городу Сиде. Место отправки и прибытия – это текстовые поля. Их заполнение необходимо для правильного отображения курортов при выборе трансферов. |
Выставление туров в систему on-line бронирования
Формирование тура в ПК «Мастер-Тур»
- В конструкторе туров отдельно создаются туры для перелетов в оба конца и для перелетов только в один конец.
- Услуги, входящие в туры, привязаны к отдельному пакету.
- У тура проставлены даты заезда.
- Трансферы заводятся в этих же турах. Без перелета трансфер забронировать нельзя.
- Обратный перелет заводится на любой день кроме первого дня тура.
- Услуги, входящие в туры, привязаны к отдельному пакету.
- Заведены цены на услуги.
Выставление тура в Интернет в ПК «Мастер-Web»
В ПК «Мастер-Web» существует возможность выставления для продажи необсчитанных туров в системе online-бронирования авиабилетов. Делается это в Системе администрирования ПК «Мастер-Web» (http://ip-адрес сервера Мастер-Веб/MasterWebStandard/Admin
).
Войти в систему администрирования можно под именем (логином) и паролем пользователя ПК Мастер-Тур, если это не ограничено настройками системы (см. инструкции по установке и настройке ПК «Мастер- Web»). Выберите раздел Выставить тур в Интернет. В загрузившемся экране с помощью фильтра найдите нужный тур и нажмите на ссылку Изменить слева от названия тура в ПК Мастер-Тур. Загрузится экран Тур для выставления тура в Интернет.
В данном экране необходимо поставить галку «Разрешить бронирование без пароля», а затем сохранить изменения, после чего тур попадет в систему бронирования авиабилетов. (Галка появляется при добавлении настройки anonymousUserKey в файле web.config Cистемы администрирования.)
По каждому направлению «Город вылета-Страна-Город прилета» может быть не более 3х туров, выставленных для надстройки «Бронирование авиабилетов». Из этих трех туров только один тур может быть «Туда-Обратно», только один «Только туда» и только один «Рейс только обратно».
Работа в системе
Сервис принимает токен авторизации. Токен можно получить через сервис авторизации.
Метод «GetArrivalCities»
Метод возвращает все города/аэропорты прибытия для заданного города или страны вылета.
Сигнатура метода
public AirportInfo[] GetArrivalCities(string token, int cityFromKey, int countryFromKey)
Описание принимаемых методом параметров
- token - идентификатор аутентификации;
- cityFromKey - город вылета;
- countryFromKey - страна вылета.
Возвращаемые значения
Метод возвращает результат своей работы в виде элементов массива AirportInfo[].
- CountryKey - ключ страны прилета;
- CountryCode - код страны прилета;
- CountryName - название страны;
- CityKey - ключ города прилёта;
- CityCode - код города прилёта;
- CityName - название города прилёта;
- AirportCode - код аэропорта прилёта;
- AirportName - название аэропорта.
Метод «GetBackFlightDates»
Метод возвращает даты обратных перелётов.
Сигнатура метода
public DateTime[] GetBackFlightDates(string token, int cityToKey, int countryToKey, int cityFromKey, int countryFromKey, DateTime tourDate)
Описание принимаемых методом параметров
- token - идентификатор аутентификации;
- cityToKey - город прилёта;
- countryToKey - страна прилёта;
- cityFromKey - город вылета;
- countryFromKey - страна вылета;
- tourDate - дата вылета.
Возвращаемые значения
Метод возвращает результат своей работы в виде элементов массива DateTime[].
- dateTime - дата обратного перелёта.
Метод «GetDepartureCities»
Метод возвращает все возможные города/аэропорты вылета.
Сигнатура метода
public AirportInfo[] GetDepartureCities(string token)
Описание принимаемых методом параметров
- token - идентификатор аутентификации.
Возвращаемые значения
Метод возвращает результат своей работы в виде элементов массива AirportInfo[].
- CountryKey - ключ страны прилёта;
- CountryCode - код страны прилёта;
- CountryName - название страны прилёта;
- CityKey - ключ города прилёта;
- CityCode - код города прилёта;
- CityName - название города прилёта;
- AirportCode - код аэропорта прилёта;
- AirportName - название аэропорта прилёта.
Метод «GetFlights»
Метод возвращает перелёты по заданным параметрам.
Сигнатура метода
public FlightTour[] GetFlights(string token, FlightSearchFilter searchFilter)
Описание принимаемых методом параметров
- token - идентификатор аутентификации;
- CountryToKey - ключ страны прилёта;
- CountryFromKey - ключ страны вылета;
- CityFromKey - ключ города вылета;
- CityToKey - ключ города прилёта;
- TourDate - дата вылета;
- DateBack - дата прилёта;
- AgentKey - ключ партнёра, для которого будут искаться перелёты;
- RateISOCode - ISO-код валюты;
- CharterClass - код класса перелёта;
- TransferTo - трансфер.
Возвращаемые значения
Метод возвращает результат своей работы в виде элементов массива FlightTour[].
- AirlineBackCode - код авиакомпании (обратный рейс);
- AirlineBackKey - ключ авиакомпании (обратный рейс);
- AirlineBackName - название авиакомпании (обратный рейс);
- AirlineCode - код авиакомпании(прямой рейс);
- AirlineKey - ключ авиакомпании(прямой рейс);
- AirlineName - название авиакомпании(прямой рейс);
- AirportFromCode - код аэропорта вылета;
- AirportToCode - код аэропорта прилёта;
- CharterBackClass - класс перелёта(обратный рейс);
- CharterBackNumber - номер рейса(обратный рейс);
- CharterBackQuote - код квоты (обратный рейс). Возвращает следующие значения:
Yes = 1, No = 2, Request = 4, None = 0, AFew = 3, OnlyAgent = 6, NoFlight = 5, All = 7, NotChecked = 10
- CharterBackTime - время рейса(обратный рейс);
- CharterClass - класс перелёта(прямой рейс);
- CharterNumber - номер рейса(прямой рейс);
- CharterTime - время рейса(прямой рейс);
- CharterToQuote - код квоты прямого перелёта. Возвращает те же значения, что и charterBackQuote.
- CityFromCode - код города вылета;
- CityFromName - название города вылета;
- CityToCode - код города прилёта;
- CityToName - название города прилёта;
- Cost - цена(может быть дробной);
- CountryFromCode - код страны вылета;
- CountryFromName - название страны вылета;
- CountryToCode - код страны прилёта;
- CountryToName - название страны прилёта;
- DateBack - дата обратного перелёта;
- DateTo - дата прямого перелёта;
- Rate - код валюты;
- Url - ссылка на бронирование.
Метод «GetStraightFlightDates»
Метод возвращает даты прямых перелётов.
Сигнатура метода
public DateTime[] GetStraightFlightDates(string token, int cityToKey, int countryToKey, int cityFromKey, int countryFromKey)
Описание принимаемых методом параметров
- token - идентификатор аутентификации;
- CityToKey - ключ города прилёта;
- CountryToKey - ключ страны прилёта;
- CityFromKey - ключ города вылета;
- CountryFromKey - ключ страны вылета.
Возвращаемые значения
Метод возвращает результат своей работы в виде элементов массива DateTime[].
- dateTime - дата прямого перелёта.