Мастер-Тур(15):Поиск вариантов программ туров

Материал из Megatec
Версия от 14:27, 13 апреля 2017; Biryukov (обсуждение | вклад) (Необязательные параметры URL-запроса)
Перейти к: навигация, поиск

Версия статьи от 13-04-2017.

Поддерживаемые версии ПК «Мастер-Тур»:
Начиная с 15 версии


Введение

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

Страница поиска туров

На данной странице есть несколько функциональных блоков:

  • главные фильтры
  • дополнительные фильтры
  • группировка результатов поиска
  • результаты поиска
Состав тура

Авторизация

Для наличия возможности бронирования заявки в корзине необходимо авторизоваться в системе, введя Имя пользователя и Пароль. Авторизация может происходить как в экране поиска (тогда перейдя в корзину авторизационные данные пользователя будут сохранены), либо в самой корзине.

Состав тура


Восстановление пароля

Если пароль для входа в систему бронирования забыт, то можно воспользоваться функцией восстановления пароля. Для этого на форме Вход в систему нужно нажать Забыли пароль?, после чего откроется экран Восстановление пароля.

Восстановление пароля

В одно из полей вводим известные данные:

  • Логин — вводим логин для входа в систему (если регистрировались как частное лицо и не меняли логин, то им является e-mail)
  • E-mail — адрес электронной почты, указанный при регистрации

Затем нажимаем кнопку Выслать пароль и на электронную почту придет письмо с логином и паролем для входа в систему бронирования.
Шаблон письма находится в MasterWeb → Templates → PasswordRecovery.xml.

Регистрация агентства

Для того чтобы зарегистрировать агентство на форме Вход в систему нужно выбрать пункт Регистрация агентства, после чего откроется экран Регистрация партнера.

Регистрация партнера

Поля для заполнения регистрационных данных:

  • Название агентства(торговая марка);
  • ФИО представителя компании;
  • Логин для доступа к системе;
  • Пароль для доступа к системе;
  • ФИО руководителя;
  • Должность руководителя - не обязательно для заполнения;
  • Страна;
  • Город;
  • Индекс;
  • Адрес места нахождения;
  • Телефон - указывается код города и номер телефона;
  • E-mail;
  • ИНН - не обязательно для заполнения;
  • Система налогооблажения - ОСН или УСН;
  • Р/с - расчетный счет в банке;
  • К/с - корреспондентский счет банка;
  • Наименование банка;
  • БИК - БИК банка.

После того, как все необходимые поля заполнены, нажимаем кнопку Зарегистрироваться. При этом регистрационные данные партнера запишутся в базу. Агентству будет отправлено письмо с логином и договором "О реализации туристического продукта". По умолчанию при регистрации добавляется один пользователь. Дополнительных пользователей можно добавить в Личном кабинете.

Регистрация частного лица

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

Регистрация частного лица


Заполняем регистрационные данные. Обязательные поля:

  • Имя;
  • Фамилия;
  • Телефон;
  • E-mail(Логин) - введенный e-mail будет являться логином. Поменять логин можно в Справочники->Постоянные клиенты->Регистрационные данные;
  • Пароль - должен содержать не менее шести символов, среди которых должны быть латинские буквы (строчные и прописные), цифры или символы;
  • Подтверждение пароля;
  • Ведите текст с картинки (латиница) - поле для ввода проверочного кода с картинки. Если код трудночитаемый, то можно нажать кнопку Обновить.

Необязательные поля:

  • Страна;
  • Город;
  • Адрес;
  • Примечание.


Дополнительная информация


В форму регистрации частного лица существует возможность добавить обязательное поле «Гражданство».
Регулируется настройкой Запрашивать гражданство при регистрации частника.

После того, как данные заполнены, нажимаем кнопку Зарегистрироваться. По факту регистрации на указанный e-mail частного лица приходит письмо, которое уведомляет об успешно пройденной регистрации. Также приходит письмо на электронную почту администратора системы, уведомляющее, что в системе произошла регистрация частного лица.
Шаблоны писем находятся в папке TourSearchOwin → NotifyResponse:

  • TemplateForTourist.txt - шаблон письма Произведена регистрация в системе онлайн бронирования;
  • TemplateForAdmin.txt - шаблон письма Новая регистрация частного лица

Для отправки писем в Megateс.TourSearchOwin.exe.config службы TourSearchOwin нужно указать настройки:

Описание Настройка
1 Адрес, с которого отправляются письма из системы бронирования
<add key="mailFrom"value="MasterWeb@EmailServiceProvider.com" />
2 Адрес администратора системы, на который приходит уведомление о новой регистрации (можно добавить несколько адресов через « ; »)
<add key="rcptTo"value="MasterWebAdmin@EmailServiceProvider.com"/>
3 Дополнительные e-mail адреса, на которые приходят сообщения о новой регистрации и заявке на бронирование (можно добавить несколько e-mail адресов через « ; »)
<add key="addRcptTo"value="Email1@EmailServiceProvider.com; Email2@EmailServiceProvider.com" />
4 Почтовый сервер SMTP
<add key="smtpServer"value="Smtp.EmailServiceProvider.com" />
5 SMTP порт почтового сервера (по умолчанию — 25)
<add key="smtpPort" value="25" />
6 Тип авторизации на сервере: None, Base64 или TLS/SSL
<add key="smtpAuthentication" value="Base64" />
7 Активация протокола SSL (Нужно включить при использовании TLS/SSL авторизации.)
<add key="EnableSsl" value="false" />
8 Имя пользователя для подключения к почтовому серверу
<add key="smtpUser" value="Domain\Username" />
После того, как указаны настройки, необходимо перезапустить службу TourSearchWebApi.

Главные фильтры

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

  • Откуда - город начала поездки, существует возможность задать несколько городов начала поездки;
  • Куда - страна, город, курорт, отель. По умолчанию в фильтр подгружаются только страны и выбрать можно только одну страну. Для поиска по городу, курорту или отелю необходимо воспользоваться контекстным поиском;
  • Тип тура - по умолчанию фильтр заполняется значением Все. В фильтр подгружаются значения (типы туров), соответствующие выбранному направлению. Возможен выбор нескольких вариантов типа тура;
  • Даты начала тура - календарь, где актуальные даты начала тура в выбранную страну подсвечены зеленым цветом. Подсвечиваются только те даты, на которые есть возможность сформировать хотя бы один вариант результата поиска согласно заведенных программ туров;
  • Количество дней - список возможных продолжительностей, которые сформированы автоматически. Отображаются только те продолжительности, на которые есть возможность сформировать хотя бы один вариант результата поиска согласно заведенных программ туров;
  • Взрослые, дети (возраст детей). Если указано количество детей, то возраст детей обязателен для заполнения.
Существует возможность добавить Город в главные фильтры. Для этого необходимо
воспользоваться настройкой Отображать фильтр по городам на главной странице поиска.

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

  • Есть
  • Есть+запрос
  • Все

По умолчанию выбран вариант "Есть+запрос"

Валюта - валюта, в которой будет отображаться цена тура. Отображаются все валюты из справочника "Список валют", у который выбран признак "Отображать в поиске"
По умолчанию выбрана "национальная" валюта.

Расчет стоимости тура

Расчет стоимости услуг в составе заказа (Цена тура):
Изначально расчет всегда ведется в валюте тура (например: если цены на услуги заведены в $, а валюта тура EU, то в момент расчета происходит конвертация значения цены в валюте $ в валюту EU по курсу на дату расчета). Затем применяются настройки округления, указанные в ПК Мастер-Тур (если указаны настройки округления стоимости услуг). Стоимости этих услуг суммируются и общая сумма также округляется (по настройкам округления ПК Мастер-Тур). Полученная сумма отображается в корзине как стоимость тура (всегда в валюте тура).

Расчет стоимости тура в валюте, выбранной в поиске:
Округленная (по настройкам, указанным в ПК Мастер-Тур) стоимость в валюте тура конвертируется по текущему курсу в валюту поиска и итоговый результат также округляется (по настройкам, указанным в ПК Мастер-Тур). Аналогичным способом рассчитывается стоимость в национальной валюте в корзине, только в качестве отображаемой валюты всегда выступает национальная валюта.
Расчет стоимости в экранах OrderInfo и OrderList:
При отображении стоимостей в экранах OrderInfo и OrderList, выводятся две цены: первая в валюте тура, полученная в п.1 (не важно в результате расчета или введенная руками), и вторая в национальной валюте, которая получается путем конвертации по зафиксированному курсу, либо курсу на текущую дату (регулируется наличием курса и настройкой courseExchangeDate (описание в разделе Настройки в файле WEB.CONFIG основного приложения ) из стоимости в валюте путевки. Результат округляется математически до сотых. Аналогично происходит расчет в национальной валюте в экране Путевка (исходя из наличия зафиксированного курса).


После выбора значений в главных фильтрах становится доступной кнопка "Найти", при нажатии на которую система отберет туры по заданным параметрам.

Состав тура

Результаты поиска

По каждому найденному варианту туру будет представлена следующая информация:

  • Даты туров и продолжительность тура (в днях)
  • Город начала поездки
  • Название тура
  • Отель, город, курорт, категория, продолжительность проживания (в ночах)
  • Авиаперелет - информация по рейсам авиаперелета
  • Цена - минимальная возможная цена варианта тура по заданным в фильтрах дате, продолжительности, количеству людей, туру и отелю.

Для просмотра информации о доступных вариантах размещения и типах питания необходимо кликнуть по слову "Варианты" в соответствующей строке тура. Откроется список доступных вариантов размещения и типов питания по данному отелю.
Слева от варианта размещения или авиаперелета отображается наличие мест.

Состав тура

Дополнительные фильтры

Для удобства поиска туров по определенным параметрам можно воспользоваться дополнительными фильтрами.
Дополнительные фильтры применяются к уже отобранным по главным фильтрам вариантам туров. В программе представлены следующие дополнительные фильтры:

  • Цена - отбор туров в заданном диапазоне цен;
  • Программа тура - отбор по самой программе тура;
  • Дата начала тура и продолжительность - отбор по дате начала тура и продолжительности (в днях);
  • Параметры проживания - отбор по городу, курорту, категории отеля, признаку отеля и названию отеля;
  • Параметры авиаперелета - отбор по параметрам авиаперелета (время вылета/прилета, аэропорт вылета/прилета, авиакомпания);

Заданные дополнительные фильтры отображаются в виде "плашек".

Состав тура

Группировка результатов поиска

Группировать отобранные результаты поиска можно по одному или нескольким параметрам одновременно. Возможны группировки по следующим параметрам:

  • название тура
  • дата тура
  • продолжительность
  • город начала поездки
  • отель
  • город
  • курорт
  • категория отеля

Отдельные случаи группировок по отель, городу, курорту и категории отеля:

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

Для просмотра результатов поиска после применения группировки необходимо нажать "Варианты" в определенной строке. Параметры, по которым производилась группировка подсвечиваются синим цветом.

Состав тура

Примечание по стране

Блок Примечание по стране появляется в том случае, если в системе администрирования ПК "Мастер-Web" в поле Примечание подраздела Страны -> Страна задано описание страны.

Примечания по стране

Параметры, передаваемые через URL страницы

Предусмотрена возможность поиска тура по параметрам, указанным в URL-запросе страницы.

Пример URL-запроса:

http://ip-адрес сервера/TourSearchClient?departureCities=1&destination=1_30&tourType=5,2&dates=23.06.2016,24.06.2016,25.06.2016&durations=2,3,4,5,6,7,8,9&adultCount=2&hotelQuota=7&aviaQuota=7&currency=USD

Обязательные параметры URL-запроса

Ниже перечисленные параметры являются обязательными:

  • departureCities — код города вылета из таблицы CityDictionary;
  • destination — "1_" + код страны места назначения из таблицы Country;
  • destCities — код города места назначения из таблицы CityDictionary (только при включенной настройке Отображать фильтр по городам на главной странице поиска);
  • tourType — код типа тура;
  • dates — даты начала тура (даты задаются в формате ДД.ММ.ГГГГ, более одной даты указываются через запятую);
  • durations — продолжительности (задаются через запятую);
  • adultCount — количество взрослых;
  • hotelQuota/aviaQuota — код варианта наличия мест на отели/авиаперелеты (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все");
  • currency — ISO код валюты (задается в справочнике Список валют).

Необязательные параметры URL-запроса

  • childAges — возраст ребенка (если детей более одного, то возраста перечисляется через запятую, если возраст ребенка "0" - то обрабатывается как "не указан");
  • groupingKeys — группировка результатов поиска по:
    • Названию тура;
    • Дате тура;
    • Продолжительности;
    • Городу начала поездки;
    • Отелю;
    • Городу;
    • Курорту;
    • Категории отеля.

Пример: http://ip-адрес сервера/TourSearchClient?departureCities=1&destination=1_30&tourType=5,2&dates=27.06.2016&durations=5&adultCount=2& childAges=1,3&hotelQuota=5&aviaQuota=7&currency=USD&groupingKeys=2,4,8

Параметры фильтров:

1. Цена

  • minPrice — минимальная цена;
  • maxPrice — максимальная цена;

Параметры фильтра Цена можно использовать как в совокупности, так и по отдельности.

2. Программа тура

  • tours — ключ программы тура из таблицы TourPrograms;

3. Параметры проживания

  • cities — код города из таблицы CityDictionary;
  • resorts — код курорта из таблицы Resorts;
  • cats — код категории отеля из таблицы CategoriesofHotel;
  • hotelTypes — код признака отеля из таблицы HotelTypes;
  • pansions — код типа питания из таблицы Pansion;
  • hotels — код отеля из таблицы HotelDictionary;

4. Параметры авиаперелета

  • depTimeFrom/depTimeTo — временной интервал вылета (задается в формате ЧЧ:ММ);
  • arrTimeFrom/arrTimeTo — временной интервал прилета (задается в формате ЧЧ:ММ);

Пример URL-запроса с использованием временных интервалов вылета и прилета:
http://ip-адрес сервера/TourSearchClient?departureCities=232&destination=1_10&tourType=5,2&dates=27.06.2016&durations=5&adultCount=2&hotelQuota=5&aviaQuota=7&currency=USD&depTimeFrom=01:00 &depTimeTo=01:59&arrTimeFrom=02:00& arrTimeTo=03:59

  • dep_airports/arr_airports — коды аэропортов вылета/прилета;
  • flightCityDeparture — код города вылета;
  • airlines — код авиакомпании из таблицы Airline;
  • flightTariffs — код класса перелета;

Ниже перечисленные параметры подразумевают установку признака активности,поэтому принимают только значение true:

  • dTransfer=true — запрет на пересадку для прилета (без пересадок в прямом направлении);
  • aTransfer=true — запрет на пересадку для вылета (без пересадок в обратном направлении);
  • byAirlineAll=true — авиакомпания, признак во всех перелетах в туре;
  • tariffAll=true — класс перелета, признак во всех перелетах в туре.

Пример: http://ip-адрес сервера/TourSearchClient?departureCities=1&destination=1_30 &tourType=5,2&dates=27.06.2016&durations=5&adultCount=2&hotelQuota=5&aviaQuota=7&currency=USD&dTransfer=true&aTransfer=true&tariffAll=true&byAirlineAll=true

Быстрый поиск

Также можно осуществить поиск, воспользовавшись формой Быстрый поиск. Данная форма вставляется в любую страницу сайта (для этого используются фреймы).
Mb 237.png
Для того, чтобы вставить эту форму на страницу, нужно добавить следующий текст:

<IFRAME SRC="HTTP://ip-сервера/TourSearchClient/DemoSearch" scrolling="no" width="280" height="450" FRAMEBORDER="0">

Дизайн настраивается в файле \TourSearchClient\Views\DemoSearch\Index.cshtml. Стили прописываются в файле \TourSearchClient\Content\Shared\Common.css.
На форме отображены фильтры, аналогичные основным фильтрам поиска: Откуда, Куда, Тип тура, Даты заезда, Количество ночей от... до..., Взрослые, Дети. После их заполнения и нажатия кнопки Найти происходит переход на основной поиск, куда передаются все параметры, выбранные в фильтрах быстрого поиска.