Web-сервисы: Сервис поиска и бронирования авиабилетов — различия между версиями
[досмотренная версия] | [досмотренная версия] |
Biryukov (обсуждение | вклад) (→Ссылка на тестовый сервис) |
Porunova (обсуждение | вклад) |
||
(не показаны 2 промежуточные версии этого же участника) | |||
Строка 38: | Строка 38: | ||
==Настройка== | ==Настройка== | ||
− | После установки «Сервис поиска авиабилетов» доступен по адресу: http://''ip-адрес сервера Мастер-Веб/wsAviaSearch/TicketSerachService.asmx'' | + | После установки «Сервис поиска авиабилетов» доступен по адресу: http://''ip-адрес сервера Мастер-Веб/wsAviaSearch/TicketSerachService.asmx''. |
− | |||
==Подготовка данных== | ==Подготовка данных== | ||
− | === | + | ===Выставление туров в интернет=== |
− | ==== | + | ====Требования по подготовке данных в ПК Мастер-тур==== |
− | + | В целях избежания ошибок в процессе бронирования предварительно должны быть корректно заполнены соответствующие справочники в ПК «Мастер-Тур». | |
− | + | {| class="wikitable" | |
− | + | |- | |
− | + | ! Справочник в ПК «Мастер-Тур» | |
− | + | ! Вносимые данные | |
− | + | ! Примечание | |
− | + | |- | |
− | + | | Авиаперелеты | |
− | + | | Расписание авиарейсов | |
+ | | Необходимо для подбора авиаперелетов при выборе направления | ||
+ | |- | ||
+ | | Трансферы | ||
+ | | Город, к которому привязан трансфер;<br />место отправки и прибытия | ||
+ | | Пример: ''трансфер Анталья - Сиде'' должен быть привязан к городу ''Анталья'', ''трансфер Сиде-Анталья'' должен быть привязан к городу ''Сиде''. Место отправки и прибытия – это текстовые поля. Их заполнение необходимо для правильного отображения курортов при выборе трансферов. | ||
+ | |- | ||
+ | |} | ||
+ | ===Выставление туров в систему on-line бронирования=== | ||
+ | ====Формирование тура в ПК «Мастер-Тур»==== | ||
+ | # В [[Мастер-Тур:Конструктор_туров|конструкторе туров]] отдельно создаются туры для перелетов в оба конца и для перелетов только в один конец. | ||
+ | #* Услуги, входящие в туры, привязаны к ''отдельному пакету''.<br />[[Файл: am_711.png|Состав пакетов для туров]] | ||
+ | #* У тура проставлены ''[[Мастер-Тур:Конструктор_туров#Даты туров|даты заезда]]''. | ||
+ | #* ''Трансферы'' заводятся в этих же турах. Без перелета трансфер забронировать нельзя. | ||
+ | #* ''Обратный перелет'' заводится на любой день кроме первого дня тура. | ||
+ | # Заведены ''цены на услуги''. | ||
+ | #* Если в туре перелет ''в один конец'': только вылет или только возврат, то заводить цены на продолжительность необязательно. | ||
+ | #* Если в туре и на прямой, и на обратный перелеты, то цены заводятся ''на продолжительности''.<br />[[Файл: am_712.png|Цена услуги в пакете]] | ||
− | + | ====Выставление тура в Интернет в ПК «Мастер-Web»==== | |
− | + | В ПК «Мастер-Web» существует возможность выставления для продажи необсчитанных туров в системе online-бронирования авиабилетов. Делается это в [[Мастер-Web:Руководство пользователя. Администрирование ПК Мастер-Web|Системе администрирования ПК «Мастер-Web»]] (<code>'''<nowiki>http://ip-адрес сервера Мастер-Веб/MasterWebStandard/Admin</nowiki>'''</code>). | |
− | |||
− | |||
− | |||
− | + | [[Файл:am_713.png|Система администрирования ПК «Мастер-Web»]] | |
− | + | Войти в систему администрирования можно под именем (логином) и паролем пользователя ПК Мастер-Тур, если это не ограничено настройками системы (см. инструкции по установке и настройке ПК «Мастер- Web»). | |
− | + | Выберите раздел Выставить тур в Интернет. В загрузившемся экране с помощью фильтра найдите нужный тур и нажмите на ссылку Изменить слева от названия тура в ПК Мастер-Тур. Загрузится экран Тур для выставления тура в Интернет. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | В данном экране необходимо поставить галку «<font style="color:red">Разрешить бронирование без пароля</font>», а затем сохранить изменения, | |
− | + | после чего тур попадет в систему бронирования авиабилетов. (Галка появляется при добавлении настройки ''anonymousUserKey'' | |
− | + | в [[Мастер-Web:Установка_и_настройка#Настройки в файле WEB.CONFIG системы администрирования|файле web.config Cистемы администрирования]].) | |
− | |||
− | |||
− | |||
− | + | [[Файл: am_714.png|x500px|Разрешить бронирование без пароля]] | |
− | + | По каждому направлению «Город вылета-Страна-Город прилета» может быть не более 3х туров, | |
− | + | выставленных для надстройки «Бронирование авиабилетов». | |
− | + | Из этих трех туров только один тур может быть «Туда-Обратно», только один «Только туда» и только один «Рейс только обратно». | |
− | |||
− | |||
− | |||
− | |||
− | + | ==Работа в системе== | |
− | + | [[Файл: am_064.png|left|Полезная информация]] <BR> | |
− | + | Сервис принимает токен авторизации. '''Токен''' можно получить через [[Мастер-Web:Дополнительный модуль Сервис для авторизации|'''сервис авторизации''']]. | |
− | + | <br /> | |
− | |||
− | |||
− | ==== | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | ===Метод «GetArrivalCities» === | |
− | + | Метод возвращает все города/аэропорты прибытия для заданного города или страны вылета. | |
− | + | ====Сигнатура метода==== | |
− | + | <code>public AirportInfo[] GetArrivalCities(string token, int cityFromKey, int countryFromKey)</code> | |
− | * | + | ====Описание принимаемых методом параметров==== |
− | * | + | * '''token''' - идентификатор аутентификации; |
− | * | + | * '''cityFromKey''' - город вылета; |
− | + | * '''countryFromKey''' - страна вылета. | |
− | + | ====Возвращаемые значения==== | |
− | + | Метод возвращает результат своей работы в виде элементов массива '''AirportInfo[]'''. | |
− | + | * '''CountryKey''' - ключ страны прилета; | |
− | + | * '''CountryCode''' - код страны прилета; | |
− | + | * '''CountryName''' - название страны; | |
− | * | + | * '''CityKey''' - ключ города прилёта; |
− | * | + | * '''CityCode''' - код города прилёта; |
− | * | + | * '''CityName''' - название города прилёта; |
− | * | + | * '''AirportCode''' - код аэропорта прилёта; |
− | * | + | * '''AirportName''' - название аэропорта. |
− | * | ||
− | * | ||
− | * | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ==== | + | ===Метод «GetBackFlightDates»=== |
+ | Метод возвращает даты обратных перелётов. | ||
+ | ====Сигнатура метода==== | ||
+ | <code>public DateTime[] GetBackFlightDates(string token, int cityToKey, int countryToKey, int cityFromKey, int countryFromKey, DateTime tourDate)</code> | ||
+ | ====Описание принимаемых методом параметров==== | ||
+ | * '''token''' - идентификатор аутентификации; | ||
+ | * '''cityToKey''' - город прилёта; | ||
+ | * '''countryToKey''' - страна прилёта; | ||
+ | * '''cityFromKey''' - город вылета; | ||
+ | * '''countryFromKey''' - страна вылета; | ||
+ | * '''tourDate''' - дата вылета. | ||
+ | ====Возвращаемые значения==== | ||
+ | Метод возвращает результат своей работы в виде элементов массива '''DateTime[]'''. | ||
+ | * '''dateTime''' - дата обратного перелёта. | ||
− | + | ===Метод «GetDepartureCities»=== | |
− | + | Метод возвращает все возможные города/аэропорты вылета. | |
− | + | ====Сигнатура метода==== | |
− | + | <code>public AirportInfo[] GetDepartureCities(string token)</code> | |
− | + | ====Описание принимаемых методом параметров==== | |
− | + | * '''token''' - идентификатор аутентификации. | |
− | + | ====Возвращаемые значения==== | |
− | + | Метод возвращает результат своей работы в виде элементов массива '''AirportInfo[]'''. | |
− | + | * '''CountryKey''' - ключ страны прилёта; | |
+ | * '''CountryCode''' - код страны прилёта; | ||
+ | * '''CountryName''' - название страны прилёта; | ||
+ | * '''CityKey''' - ключ города прилёта; | ||
+ | * '''CityCode''' - код города прилёта; | ||
+ | * '''CityName''' - название города прилёта; | ||
+ | * '''AirportCode''' - код аэропорта прилёта; | ||
+ | * '''AirportName''' - название аэропорта прилёта. | ||
− | + | ===Метод «GetFlights»=== | |
− | * | + | Метод возвращает перелёты по заданным параметрам. |
− | * | + | ====Сигнатура метода==== |
− | * | + | <code>public FlightTour[] GetFlights(string token, FlightSearchFilter searchFilter)</code> |
− | * | + | ====Описание принимаемых методом параметров==== |
+ | * '''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»=== |
− | + | Метод возвращает даты прямых перелётов. | |
− | + | ====Сигнатура метода==== | |
− | + | <code>public DateTime[] GetStraightFlightDates(string token, int cityToKey, int countryToKey, int cityFromKey, int countryFromKey)</code> | |
− | + | ====Описание принимаемых методом параметров==== | |
− | ==== | + | * '''token''' - идентификатор аутентификации; |
− | + | * '''CityToKey''' - ключ города прилёта; | |
− | [ | + | * '''CountryToKey''' - ключ страны прилёта; |
− | + | * '''CityFromKey''' - ключ города вылета; | |
− | + | * '''CountryFromKey''' - ключ страны вылета. | |
− | |||
− | |||
− | |||
− | ==== | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ''' | + | ====Возвращаемые значения==== |
− | + | Метод возвращает результат своей работы в виде элементов массива '''DateTime[]'''. | |
− | ''' | + | * '''dateTime''' - дата прямого перелёта. |
− | |||
[[Category:Мастер-Web_Дополнительные_модули]] | [[Category:Мастер-Web_Дополнительные_модули]] | ||
[[Category:Мастер-Тур_Веб-сервисы]] | [[Category:Мастер-Тур_Веб-сервисы]] |
Версия 12:04, 20 мая 2015
Данный модуль не поддерживается.
Версия статьи от 20-05-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 - дата прямого перелёта.