Мастер-Web:Дополнительный модуль Распределенный поиск — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
Строка 76: Строка 76:
 
</ul>
 
</ul>
 
</TD></TR>
 
</TD></TR>
<TR><TD STYLE="font-family:courier new"><CostForRoom></TD><TD>Устанавливает всем странам из удаленного источника тип цены за номер.</TD></TR>
+
<TR><TD STYLE="font-family:courier new"><CostForRoom></TD><TD>Устанавливает всем странам из удаленного источника тип цены за номер.<br />Обрабатывается аналогично настройке [[Мастер-Web:Установка_и_настройка#.D0.9D.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2_.D1.84.D0.B0.D0.B9.D0.BB.D0.B5_WEB.CONFIG_.D0.BE.D1.81.D0.BD.D0.BE.D0.B2.D0.BD.D0.BE.D0.B3.D0.BE_.D0.BF.D1.80.D0.B8.D0.BB.D0.BE.D0.B6.D0.B5.D0.BD.D0.B8.D1.8F|costForRoom]] в экране [[Мастер-Web:Дополнительный_модуль_Подбор_туров_с_наличием_мест|Подбор туров с наличием мест (QuotedDynamic)]].<br /><span style="color:#808080">Если по одной стране выводятся туры из локального и внешнего источника, то при несовпадении настроек преимуществом обладает настройка из web.config ПК «Мастер-Web» — т.е. будут отображены туры только из локальной базы данных.</span></TD></TR>
<TR><TD STYLE="font-family:courier new"><CostForRoomCountries></TD><TD>Устанавливает странам с перечисленными ключами тип цены за номер.<br /><span style="color:#808080">Ключи стран через запятую, например, «3, 40, 90».</span></TD></TR>
+
<TR><TD STYLE="font-family:courier new"><CostForRoomCountries></TD><TD>Устанавливает странам с перечисленными ключами тип цены за номер.<br />Обрабатывается аналогично настройке [[Мастер-Web:Установка_и_настройка#.D0.9D.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2_.D1.84.D0.B0.D0.B9.D0.BB.D0.B5_WEB.CONFIG_.D0.BE.D1.81.D0.BD.D0.BE.D0.B2.D0.BD.D0.BE.D0.B3.D0.BE_.D0.BF.D1.80.D0.B8.D0.BB.D0.BE.D0.B6.D0.B5.D0.BD.D0.B8.D1.8F|costForRoomCountries]] в экране [[Мастер-Web:Дополнительный_модуль_Подбор_туров_с_наличием_мест|Подбор туров с наличием мест (QuotedDynamic)]].<br /><span style="color:#808080">Ключи стран через запятую, например, «3, 40, 90».</span></TD></TR>
 
</TABLE>
 
</TABLE>
  
Правило подстановки данных из поискового фильтра данного источника в локальный фильтр задается при помощи набора элементов ''<ReplcamentSubItem>'', где
+
Правило подстановки данных из поискового фильтра данного источника в локальный фильтр задается при помощи набора элементов <font style="font-family:courier new"><ReplcamentSubItem></font>, где:
* '''Type''' - тип условия подстановки; возможные значения: departFrom, country, city
+
 
* '''LocalValue''' - ключ сущности в локальной базе (если в локальном источнике отсутствует такой ключ, то LocalValue указывать не нужно)
+
<TABLE CLASS="wikitable" WIDTH="100%">
* '''RemoteValue''' - ключ сущности во внешнем источнике
+
<TR><TD STYLE="font-family:courier new">Type</TD><TD>Тип условия подстановки<br />Возможные значения:
* '''Name''' - название сущности (настройка используется при отсутствии сущности в локальном источнике)
+
<ul>
 +
<li>departFrom</li>
 +
<li>country</li>
 +
<li>city</li>
 +
</ul>
 +
</TD></TR>
 +
<TR><TD STYLE="font-family:courier new">LocalValue</TD><TD>Ключ сущности в локальной базе<br /><span style="color:#808080">Если в локальном источнике отсутствует такой ключ, то LocalValue указывать не нужно.</span></TD></TR>
 +
<TR><TD STYLE="font-family:courier new">RemoteValue</TD><TD>Ключ сущности во внешнем источнике</TD></TR>
 +
<TR><TD STYLE="font-family:courier new">Name</TD><TD>Название сущности<br /><span style="color:#808080">Настройка используется при отсутствии сущности в локальном источнике.</span></TD></TR>
 +
</TABLE>
 +
 
 +
====Примеры добавления сущностей====
 +
<ol>
 +
<li>Добавление предложения по Хорватии (в локальном источнике отсутствует, ключ 123 во внешнем источнике) при вылете из Москвы (ключ 30 в локальном источнике и 1 во внешнем источнике):
 +
<syntaxhighlight lang="xml">
 +
<ReplcamentSearchItem>
 +
<SubItems>
 +
<ReplcamentSubItem
 +
Type="departFrom"
 +
LocalValue="30"
 +
RemoteValue="1" />
 +
<ReplcamentSubItem
 +
Type="country"
 +
RemoteValue="123"
 +
Name="Хорватия" />
 +
</SubItems>
 +
</ReplcamentSearchItem>
 +
</syntaxhighlight>
 +
<br />
 +
</li>
 +
<li>Добавление предложения по Греции (ключ 520 в локальном источнике и 29 во внешнем источнике) при вылете из Москвы (ключ 30 в локальном источнике и 1 во внешнем источнике):
 +
<syntaxhighlight lang="xml">
 +
<ReplcamentSearchItem>
 +
<SubItems>
 +
<ReplcamentSubItem
 +
Type="departFrom"
 +
LocalValue="30"
 +
RemoteValue="1" />
 +
<ReplcamentSubItem
 +
Type="country"
 +
LocalValue="520"
 +
RemoteValue="29"
 +
</SubItems>
 +
</ReplcamentSearchItem>
 +
</syntaxhighlight>
 +
<br />
 +
</li>
 +
<li>Включение в предложения по Греции (ключ 520 в локальном источнике и 29 во внешнем источнике) при вылете из Екатеринбурга (ключ 648 в локальном источнике и 266 во внешнем источнике) города Салоники (в локальном источнике отсутствует, ключ 615 во внешнем источнике):
 +
<syntaxhighlight lang="xml">
 +
<ReplcamentSearchItem>
 +
<SubItems>
 +
<ReplcamentSubItem
 +
Type="departFrom"
 +
LocalValue="648"
 +
RemoteValue="266" />
 +
<ReplcamentSubItem
 +
Type="country"
 +
LocalValue="520"
 +
RemoteValue="29" />
 +
<ReplcamentSubItem
 +
Type="city"
 +
RemoteValue="615"
 +
Name="Салоники" />
 +
</SubItems>
 +
</ReplcamentSearchItem>
 +
</syntaxhighlight>
 +
<br />
 +
</li>
 +
</ol>
  
Примеры:<br />
 
* Пример 1. Добавить предложения по Хорватии (в локальном источнике отсутствует, ключ во внешнем источнике - 123) при вылете из Москвы (ключ 30 в локальном источнике и 1 во внешнем источнике)
 
<ReplcamentSearchItem>
 
  <SubItems>
 
  <ReplcamentSubItem Type="departFrom" LocalValue="30" RemoteValue="1" />
 
  <ReplcamentSubItem Type="country" LocalValue="0" RemoteValue="123" Name="Хорватия" />
 
  </SubItems>
 
</ReplcamentSearchItem>
 
* Пример 2. Добавить предложения по Греции (ключ 520 в локальном источнике и 29 во внешнем источнике) при вылете из Москвы (ключ 30 в локальном источнике и 1 во внешнем источнике)
 
<ReplcamentSearchItem>
 
  <SubItems>
 
  <ReplcamentSubItem Type="departFrom" LocalValue="30" RemoteValue="1" />
 
  <ReplcamentSubItem Type="country" LocalValue="520" RemoteValue="29" Name="Греция" />
 
  </SubItems>
 
</ReplcamentSearchItem>
 
* Пример 3. Включить в предложения по Греции (ключ 520 в локальном источнике и 29 во внешнем источнике) при вылете из Екатеринбурга (ключ 648 в локальном источнике и 266 во внешнем источнике) город Салоники (в локальном источнике отсутствует ; ключ во внешнем источнике - 615)
 
<ReplcamentSearchItem>
 
  <SubItems>
 
  <ReplcamentSubItem Type="departFrom" LocalValue="648" RemoteValue="266" />
 
  <ReplcamentSubItem Type="country" LocalValue="520" RemoteValue="29" Name="Греция" />
 
  <ReplcamentSubItem Type="city" RemoteValue="615" Name="Салоники" />
 
  </SubItems>
 
</ReplcamentSearchItem>
 
 
===Настройка полей данных о туристах===
 
===Настройка полей данных о туристах===
 
Настройка отображения полей данных о туристах производится в файле <tt>descriptions.xml</tt>. Данный файл содержит следующие настройки:
 
Настройка отображения полей данных о туристах производится в файле <tt>descriptions.xml</tt>. Данный файл содержит следующие настройки:
Строка 209: Строка 254:
 
<li>wsAuthPassowrd — пароль доступа к WsAuthorization;</li>
 
<li>wsAuthPassowrd — пароль доступа к WsAuthorization;</li>
 
<li>tokenLifeTime — время до повторной авторизационной проверки;</li>
 
<li>tokenLifeTime — время до повторной авторизационной проверки;</li>
<li>usePasswordHashing — включение хеширования пароля.<br />
+
<li>usePasswordHashing — включение хеширования пароля.</li>
<span style="color:#808080">При включении хеширования в distributedSearchSettings.xml нужно указывать не пароль, а его хеш, например:</span>
 
<syntaxhighlight lang="xml">
 
<DistributedSearchSource
 
 
WsAuthPassword="xMpCOKC5I4INzFCab3WEmw==">
 
</syntaxhighlight>
 
</li>
 
 
</ul>
 
</ul>
 
</li>
 
</li>
Строка 234: Строка 272:
  
 
=====Настройка агентского ПК «Мастер-Web»=====
 
=====Настройка агентского ПК «Мастер-Web»=====
В файле настроек распределенного поиска distributedSearchSettings.xml, расположенного в папке templates каталога ПК «Мастер-Web», для использования сервиса авторизации WsAuthorization необходимо указать 3 настройки:
 
 
<ul>
 
<ul>
<li>WsAuthLogin — логин для обращения к WsAuthorization;</li>
+
<li>В файле настроек распределенного поиска distributedSearchSettings.xml, расположенного в папке templates каталога ПК «Мастер-Web», для использования сервиса авторизации WsAuthorization необходимо указать 3 настройки:
<li>WsAuthPassword — пароль для обращения к WsAuthorization;</li>
+
<ul>
<li>AuthorizationServiceUrl — адрес авторизационного сервиса.</li>
+
<li>WsAuthLogin — логин для обращения к WsAuthorization;</li>
</ul>
+
<li>WsAuthPassword — пароль для обращения к WsAuthorization;</li>
<br />
+
<li>AuthorizationServiceUrl — адрес авторизационного сервиса.</li>
 +
</ul>
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
 
<DistributedSearchSource
 
<DistributedSearchSource
Строка 255: Строка 293:
 
</syntaxhighlight>
 
</syntaxhighlight>
 
<br />
 
<br />
 +
</li>
 +
<li>При включении хеширования (usePasswordHashing) в настройке WsAuthPassword нужно указывать не пароль, а его хеш:
 +
<syntaxhighlight lang="xml">
 +
<DistributedSearchSource
 +
Id="Внешний источник № 7"
 +
WsAuthLogin="qaz"
 +
WsAuthPassword="xMpCOKC5I4INzFCab3WEmw==">
 +
</syntaxhighlight>
 +
<br />
 +
</li>
 +
</ul>
 +
 +
  
 
===Валидный distributedSearchSettings.xml===
 
===Валидный distributedSearchSettings.xml===

Версия 16:47, 7 февраля 2013

Статья находится на стадии разработки.

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

Более ранние версии:
До версии ПК «Мастер-Web» 2009.2.16 включительно


Введение

Модуль «Распределенный поиск» предназначен для отображения в едином поисковом модуле как своих, так и сторонних предложений. Модуль позволяет осуществлять поиск и бронирование туров от различных туроператоров в одном приложении ПК Мастер-Web.

Установка

Для установки «Распределенного поиска» нужно распаковать архив надстройки mw-distributedsearch-2007.2.XX.XXXX.zip в корень каталога, где установлено приложение ПК Мастер-Web.

Для развертывания распределенного поиска необходимо на web-сервере каждого туроператора, цены которого необходимо отображать в собственном приложении, установить Сервис по загрузке поисковых фильтров (FilterBinding), Поисковый сервис (SearchService), Сервис проверки наличия мест (CheckQuotes) и Сервис бронирования (Reservation). Описание процесса установки сервисов приведено в руководстве пользователя соответствующего сервиса.

Если собственные предложения также должны загружаться через web-сервис, то такие же web-сервисы необходимо установить и на своем web-сервере.

Настройка

Добавление секций

Добавление секций в конфигурационный файл web.config производится только в случае, если локальные предложения туроператора подключаются через сервис.

  • 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="FilterBinding" enabled="true" url="http://somesite/ws-filter-binding/FilterBindingService.asmx"/>
   <add name="DoSearch" enabled="true" url="http://somesite/ws-search/Search.asmx"/>
   <add name="Reservation" enabled="true" url="http://somesite/ws-reservation/ReservationService.asmx"/>
   <add name="ServiceProvider" enabled="true" url="http://somesite/ws-reservation/ServiceProvider.asmx"/>
   <add name="CheckQuotes" enabled="true" url="http://somesite/ws-checkquotes/CheckQuotesService.asmx"/>
   </Services>
 </servicesAccessibility>
</Megatec.Web.Services>

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

Настройки файла distributedSearchSettings.xml

Файл distributedSearchSettings.xml содержит информацию о внешних источниках данных.

Элемент <Enabled>true</Enabled> в секции <DistributedSearchSettings> указывает на необходимость проведения поиска во внешних источниках данных.

Каждый из элементов <DistributedSearchSource Id="source"> в секции <SearchSources> представляет собой описание источника данных. Атрибут id может быть произвольным, но должен быть уникальным в рамках документа.

НастройкаОписание
<FilterBindingServiceUrl>Адрес сервиса по загрузке поисковых фильтров FilterBinding
<SearchServiceUrl>Адрес поискового сервиса Search
<ReservationServiceUrl>Адрес сервиса бронирования ReservationService
<ServiceProviderServiceUrl>Адрес сервиса формирования списка услуг ServiceProvider
<CheckQuotesServiceUrl>Адрес сервиса по проверке наличия мест CheckQuotesService
<ReplcamentSearchItems>Правила подстановки данных из поискового фильтра данного источника в локальный фильтр
<FlightGroups>Группы тарифов на авиаперелеты
<PartnerKey>Ключ партнера в удаленном источнике, являющегося владельцем приложения ПК «Мастер-Web»
<InternalPartnerKey>Ключ партнера в локальном источнике, являющегося поставщиком цен
<InternalServiceKey>Класс услуги в базе данных турагента, являющегося владельцем приложения ПК «Мастер-Web», используемый для сохранения услуг из базы стороннего туроператора
Все услуги по путевке, забронированной по туру стороннего туроператора, будут сохранены с этим классом услуги.
<InternalCreator>Ключ пользователя из таблицы [UserList] турагента, являющегося владельцем приложения ПК «Мастер-Web», который прописывается создателем для путевок, оформленных по турам стороннего туроператора
<InternalFilialKey>Ключ филиала ([PR_Filial] = 2) из таблицы [tbl_Partners] турагента, являющегося владельцем приложения ПК «Мастер-Web», который прописывается филиалом для путевок, оформленных по турам стороннего туроператора
<InternalTourKey>Ключ тура из таблицы [tbl_TurList] турагента, являющегося владельцем приложения ПК «Мастер-Web», который прописывается в поле [DG_TRKey] у путевок, оформленных по турам стороннего туроператора
<DefaultCountryKey>DefaultCountryKey
<DefaultCityKey>DefaultCityKey
<ReservationWaitStatus>ReservationWaitStatus
<ReservationOKStatus>ReservationOKStatus
<AdditionalComission>Наценка в процентах к общей стоимости тура от стороннего туроператора
Настройка применяется в экране поиска DSearchPageM и в корзине RemoteBasketM.
<AdditionalComissionFixed>Фиксированная наценка к общей стоимости тура от стороннего туроператора
Настройка применяется только в корзине RemoteBasketM.
<AdditionalServiceComission>Фиксированная наценка к стоимости доп. услуг при бронировании туров от стороннего туроператора
Настройка применяется только в корзине RemoteBasketM.
<FilialKey>FilialKey
<EMail>Дополнительные e-mail адреса для отправления писем о новых бронированиях, осуществленных через распределенный поиск
Адреса перечисляются через точку с запятой.
<DontSendBookingMail>Настройка, управляющая отправкой письма о новом бронировании агентству
Возможные значения:
  • true — не отправлять письмо агентству;
  • false — отправлять письмо о новом бронировании агентству.
<CostForRoom>Устанавливает всем странам из удаленного источника тип цены за номер.
Обрабатывается аналогично настройке costForRoom в экране Подбор туров с наличием мест (QuotedDynamic).
Если по одной стране выводятся туры из локального и внешнего источника, то при несовпадении настроек преимуществом обладает настройка из web.config ПК «Мастер-Web» — т.е. будут отображены туры только из локальной базы данных.
<CostForRoomCountries>Устанавливает странам с перечисленными ключами тип цены за номер.
Обрабатывается аналогично настройке costForRoomCountries в экране Подбор туров с наличием мест (QuotedDynamic).
Ключи стран через запятую, например, «3, 40, 90».

Правило подстановки данных из поискового фильтра данного источника в локальный фильтр задается при помощи набора элементов <ReplcamentSubItem>, где:

TypeТип условия подстановки
Возможные значения:
  • departFrom
  • country
  • city
LocalValueКлюч сущности в локальной базе
Если в локальном источнике отсутствует такой ключ, то LocalValue указывать не нужно.
RemoteValueКлюч сущности во внешнем источнике
NameНазвание сущности
Настройка используется при отсутствии сущности в локальном источнике.

Примеры добавления сущностей

  1. Добавление предложения по Хорватии (в локальном источнике отсутствует, ключ 123 во внешнем источнике) при вылете из Москвы (ключ 30 в локальном источнике и 1 во внешнем источнике):
    <ReplcamentSearchItem>
    	<SubItems>
    		<ReplcamentSubItem
    			Type="departFrom"
    			LocalValue="30"
    			RemoteValue="1" />
    		<ReplcamentSubItem
    			Type="country"
    			RemoteValue="123"
    			Name="Хорватия" />
    	</SubItems>
    </ReplcamentSearchItem>
    


  2. Добавление предложения по Греции (ключ 520 в локальном источнике и 29 во внешнем источнике) при вылете из Москвы (ключ 30 в локальном источнике и 1 во внешнем источнике):
    <ReplcamentSearchItem>
    	<SubItems>
    		<ReplcamentSubItem
    			Type="departFrom"
    			LocalValue="30"
    			RemoteValue="1" />
    		<ReplcamentSubItem
    			Type="country"
    			LocalValue="520"
    			RemoteValue="29"
    	</SubItems>
    </ReplcamentSearchItem>
    


  3. Включение в предложения по Греции (ключ 520 в локальном источнике и 29 во внешнем источнике) при вылете из Екатеринбурга (ключ 648 в локальном источнике и 266 во внешнем источнике) города Салоники (в локальном источнике отсутствует, ключ 615 во внешнем источнике):
    <ReplcamentSearchItem>
    	<SubItems>
    		<ReplcamentSubItem
    			Type="departFrom"
    			LocalValue="648"
    			RemoteValue="266" />
    		<ReplcamentSubItem
    			Type="country"
    			LocalValue="520"
    			RemoteValue="29" />
    		<ReplcamentSubItem
    			Type="city"
    			RemoteValue="615"
    			Name="Салоники" />
    	</SubItems>
    </ReplcamentSearchItem>
    


Настройка полей данных о туристах

Настройка отображения полей данных о туристах производится в файле descriptions.xml. Данный файл содержит следующие настройки:

1. Настройка отображения поля «Главный турист»:

<column code="ismain" header="<img src="../images/mw_main_tourist.gif" border="0" alt="Главный турист" />" visible="True" required="True" translit="False" letterCase="0" edit="False" />

2. Настройка отображения поля «Пол туриста»:

<column code="sex" header="Пол<font color="red">*</font>" visible="True" required="False" translit="False" letterCase="0" edit="True" />

3. Настройка отображения поля «Имя рус.»:

<column code="firstnamerus" header="" visible="False" required="False" translit="False" letterCase="0" edit="False" />

4. Настройка отображения поля «Отчество рус.»:

<column code="patronymicrus" header="Отчество" visible="False" required="False" translit="False" letterCase="3" edit="False" />

5. Настройка отображения поля «Фамилия рус.»:

<column code="lastnamerus" header="" visible="False" required="False" translit="False" letterCase="0" edit="False" />

6. Настройка отображения поля «Имя лат.»:

<column code="firstname" header="Имя<font color="red">*</font>" visible="True" required="True" translit="True" letterCase="2" edit="True" validationgroup="TouristsGroup" />

7. Настройка отображения поля «Отчество лат.»:

<column code="patronymic" header="" visible="False" required="False" translit="False" letterCase="2" edit="False" />

8. Настройка отображения поля «Фамилия лат.»:

<column code="lastname" header="Фамилия<font color="red">*</font>" visible="True" required="True" translit="True" letterCase="2" edit="True" validationgroup="TouristsGroup" />

9. Настройка отображения поля «Дата рождения»:

<column code="birthdate" header="Дата рождения<font color="red">*</font><br />(dd.MM.yyyy)" visible="True" required="true" translit="False" letterCase="0" edit="True" validationgroup="TouristsGroup" />

10. Настройка отображения поля «Номер общегражданского паспорта»:

<column code="passportrus" header="" visible="False" required="False" translit="False" letterCase="0" edit="False" />

11. Настройка отображения поля «Дата выдачи общегражданского паспорта»:

<column code="passportdaterus" header="" visible="False" required="False" translit="False" letterCase="0" edit="False" />

12. Настройка отображения поля «Общегражданский паспорт: кем выдан»:

<column code="passportbywhomrus" header="Паспорт: кем выдан" visible="False" required="False" translit="False" letterCase="0" edit="False" />

13. Настройка отображения поля «Номер загранпаспорта»:

<column code="passport" header="Паспорт" visible="True" required="true" translit="False" letterCase="2" edit="True" validationgroup="TouristsGroup" />

14. Настройка отображения поля «Дата выдачи загранпаспорта»:

<column code="passportdate" header="Загран-паспорт: дата выдачи" visible="False" required="False" translit="False" letterCase="0" edit="False" />

15. Настройка отображения поля «Срок действия загранпаспорта»:

<column code="passportdateend" header="Действителен до<br />(dd.MM.yyyy)" visible="true" required="true" translit="False" letterCase="0" edit="True" validationgroup="TouristsGroup"/>

16. Настройка отображения поля «Гражданство»:

<column code="citizenship" header="Гражданство" visible="False" required="False" translit="False" letterCase="0" edit="False" />

17. Настройка отображения поля «Загранпаспорт: кем выдан»:

<column code="passportbywhom" header="" visible="False" required="False" translit="False" letterCase="0" edit="False" />

18. Настройка отображения поля «Удаление записи»:

<column code="delete" header="" visible="true" required="False" edit="True" />

Настройки отображения полей данных о туристах содержат параметры:

  1. Code= - зашитая в коде константа, которую нельзя изменять.
  2. Header= - заголовок поля
  3. Visible= - видимость поля; значения: True – видимый, Flse – невидимый
  4. Required= - обязательность заполнения поля; значения: True – обязательное, False – необязательное
  5. Translit= - транслитерация; значения: True – транслитерировать, False – не транслитерировать
  6. letterCase= - регистр символов в поле; значения: 1 – первая буква заглавная, 2 – все буквы большие, 3 – все буквы маленькие
  7. Edit= - редактирование поля; значения: True – редактируемое, False – нередактируемое

Настройки в web.config приложения ПК Мастер-Web

Дополнительные настройки, задаваемые в секции <appSettings/> файла web.config, находящемся в папке с приложением ПК Мастер-Web.

1. Настройка, определяющая страницу, на которую будет попадать пользователь после бронирования тура от стороннего туроператора.

  • true – переход осуществляется на страницу «Информация о заказе» (OrderInfo.aspx);
  • false или отсутствие настройки – переход осуществляется на страницу ReservationResultPage.aspx
<add name="DSRedirectToResultPage" enabled="true" url="true"/>

Сервис авторизации

Начиная с релиза 2009.2.16 ПК «Мастер-Web» появилась возможность защиты веб-сервисов распределенного поиска от несанкционированного использования посредством сервиса авторизации WsAuthorization.

Настройка внешнего источника туроператора
  1. Настройка базы данных
    • Начиная с ПК «Мастер-Web» 2009.2.17.1 (пакет обновлений № 1 для релиза ПК «Мастер-Web» 2009.2.17) использование сервиса авторизации по умолчанию не требуется.
    • Для защиты веб-сервисов от несанкционированного использования нужно выполнить по базе данных ПК «Мастер-Тур» скрипт:
      insert into [SystemSettings] (SS_ParmName,SS_ParmValue) values ('SYSCheckSecurityToken','1')
      
    • Отключить использование сервиса авторизации можно скриптом:
      update [SystemSettings] set [SS_ParmValue] = '0' where [SS_ParmName] in ('SYSCheckSecurityToken')
      
    • При необходимости использования веб-сервисов распределенного поиска без сервиса авторизации на релизах до ПК «Мастер-Web» 2009.2.17.1 нужно выполнить скрипт fn_mwCheckToken.sql — его можно запросить в отделе поддержки.
  2. Развертывание сервиса авторизации
    • Необходимо развернуть веб-сервис WsAuthorization из архива mw-ws-authorization-9.2.x.xxxxx.zip как отдельное веб-приложение на IIS, например, можно добавить его на сайт с уже развернутыми сервисами распределенного поиска.
  3. Настройки Web.config
    • Строка подключения к базе данных ПК «Мастер-Тур», например:
      <add key="connectionString" value="Data Source=server; Initial Catalog=database; User Id=root; Password=toor; Application Name=ds"/>
      
    • Нужно заполнить следующие основные настройки секции <appSettings>:
      <add key="wsAuthLogin" value="qaz"/>
      <add key="wsAuthPassowrd" value="123"/>
      <add key="tokenLifeTime" value="5"/>
      <add key="usePasswordHashing" value="false"/>
      
      • wsAuthLogin — логин доступа к WsAuthorization;
      • wsAuthPassowrd — пароль доступа к WsAuthorization;
      • tokenLifeTime — время до повторной авторизационной проверки;
      • usePasswordHashing — включение хеширования пароля.
  4. Поддержка репликации
    • При использовании репликации возможны 2 варианта настройки сервиса авторизации:
      1. Без защиты — полное отключение сервиса авторизации: и на основной, и на поисковой базе данных;
      2. Частичная защита — включение сервиса авторизации на поисковой базе данных.
        В этом случае обращения к веб-сервисам FilterBindingService и Search, использующим поисковую базу данных, будут проверяться сервисом WsAuthorization, а обращения к сервисам ServiceProvider, ReservationService и CheckQuotesService, использующим основную базу данных, проверяться не будут.
Настройка агентского ПК «Мастер-Web»
  • В файле настроек распределенного поиска distributedSearchSettings.xml, расположенного в папке templates каталога ПК «Мастер-Web», для использования сервиса авторизации WsAuthorization необходимо указать 3 настройки:
    • WsAuthLogin — логин для обращения к WsAuthorization;
    • WsAuthPassword — пароль для обращения к WsAuthorization;
    • AuthorizationServiceUrl — адрес авторизационного сервиса.
    <DistributedSearchSource
    		Id="Внешний источник № 7"
    		WsAuthLogin="qaz"
    		WsAuthPassword="123">
    
    	<!-- Адрес авторизационного сервиса -->
    	<AuthorizationServiceUrl>
    	http://server:8080/distributedsearch/mw-ws-authorization/WsAuthorization.asmx
    	</AuthorizationServiceUrl></DistributedSearchSource>
    


  • При включении хеширования (usePasswordHashing) в настройке WsAuthPassword нужно указывать не пароль, а его хеш:
    <DistributedSearchSource
    		Id="Внешний источник № 7"
    		WsAuthLogin="qaz"
    		WsAuthPassword="xMpCOKC5I4INzFCab3WEmw==">
    



Валидный distributedSearchSettings.xml

Конфигурационный файл распределенного поиска distributedSearchSettings.xml расположен в папке templates каталога ПК «Мастер-Web». Ниже представлен пример валидного файла конфигурации для работы с одним внешним источником. Подключены 2 страны: Англия и Андорра — для Англии поиск цен производится только по турам с городом отправления Москва (departFrom = 1), а для Андорры — как по турам из Москвы, так и по турам без перелета (departFrom = 0).

Данный файл distributedSearchSettings.xml актуален для ПК «Мастер-Web» релиза 2009.2.17, а также для сервис-паков 2009.2.16.

<?xml version="1.0"?>
<DistributedSearchSettings
		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
		xmlns:xsd="http://www.w3.org/2001/XMLSchema">
 
 	<!-- РП включен\выключен -->
 	<Enabled>true</Enabled>
 
 	<!-- Список удаленных источников -->
 	<SearchSources>
 		<!--
 		Удаленный источник.
 		
 		Id - идентификатор удаленного источника в РП. Любая строка, кроме local.
 		WsAuthLogin - логин для авторизации на сервисе.
 		WsAuthPassword - пароль для авторизации на сервисе.
 		-->
 
 		<DistributedSearchSource
				Id="Внешний источник № 7"
				WsAuthLogin="qaz"
				WsAuthPassword="123">
 
 			<!-- Адрес авторизационного сервиса -->
 			<AuthorizationServiceUrl>
 			http://server:8080/distributedsearch/mw-ws-authorization/WsAuthorization.asmx
 			</AuthorizationServiceUrl>
 			
 			<!-- Адрес сервиса получения поискового фильтра -->
 			<FilterBindingServiceUrl>
 			http://server:8080/distributedsearch/mw-filterbinding/FilterBindingService.asmx
 			</FilterBindingServiceUrl>
 			
 			<!-- Адрес поискового сервиса -->
 			<SearchServiceUrl>
 			http://server:8080/distributedsearch/mw-megatecwebservices/Search.asmx
 			</SearchServiceUrl>
 			
 			<!-- Адрес сервиса бронирования -->
 			<ReservationServiceUrl>
 			http://server:8080/distributedsearch/mw-ws-reservation/ReservationService.asmx
 			</ReservationServiceUrl>
 			
 			<!-- Адрес сервиса работы с услугами -->
 			<ServiceProviderServiceUrl>
 			http://server:8080/distributedsearch/mw-ws-reservation/ServiceProvider.asmx
 			</ServiceProviderServiceUrl>
 			
 			<!-- Адрес сервиса проверки квот -->
 			<CheckQuotesServiceUrl>
 			http://server:8080/distributedsearch/mw-ws-checkquotes/CheckQuotesService.asmx
 			</CheckQuotesServiceUrl>
 
 			<!--
 				Ключ партнера в локальной БД.
 				Значение, которое будет установлено записи в таблице tbl_Dogovor,
				поле DG_PARTNERKEY, и записям в таблице tbl_DogovorList, поле DL_PARTNERKEY.
 				Берется из таблицы Partners, поле PR_KEY.
 			-->
 			<InternalPartnerKey>10760</InternalPartnerKey>
 
 			<!--
 				Ключ создателя тура в локальной БД.
 				Значение, которое будет установлено записи в таблице tbl_Dogovor,
				поле DG_CREATOR, и записям в таблице tbl_DogovorList, поле DL_CREATOR.
 				Берется из таблицы UserList, поле US_KEY.
 			-->
 			<InternalCreator>89</InternalCreator>
 
 			<!--
 				Ключ класса услуг для фейковых услуг путевки в локальной БД.
 				Значение, которое будет установлено записям в таблице tbl_DogovorList,
				поле DL_SVKEY.
 				Берется из таблицы Service, поле SV_KEY.
 			-->
 			<InternalServiceKey>1040</InternalServiceKey>
 
 			<!-- Устанавливает всем странам из удаленного источника тип цены за номер. -->
 			<CostForRoom>false</CostForRoom>
 
 			<!--
 				Устанавливает странам с перечисленными ключами тип цены за номер.
 				Формат: "1,2,3,..", - ключи стран через запятую.
 			-->
 			<CostForRoomCountries></CostForRoomCountries>
 
 			<!-- Список элементов, которые будут получаться из удаленного источника -->
 			<ReplcamentSearchItems>
 				<ReplcamentSearchItem>
 					<SubItems>
 						<ReplcamentSubItem
							Type="departFrom"
							LocalValue="0"
							RemoteValue="0" />
 						<ReplcamentSubItem
							Type="country"
							RemoteValue="376"
							Name="Андорра № 7" />
 					</SubItems>
 				</ReplcamentSearchItem>
 				<ReplcamentSearchItem>
 					<SubItems>
 						<ReplcamentSubItem
							Type="departFrom"
							LocalValue="1"
							RemoteValue="1" />
						<ReplcamentSubItem
							Type="country"
							RemoteValue="222"
							Name="Англия № 7" />
 					</SubItems>
 				</ReplcamentSearchItem>
 				<ReplcamentSearchItem>
 					<SubItems>
 						<ReplcamentSubItem
							Type="departFrom"
							LocalValue="1"
							RemoteValue="1" />
 						<ReplcamentSubItem
							Type="country"
							RemoteValue="376"
							Name="Андорра № 7" />
 					</SubItems>
 				</ReplcamentSearchItem>
 			</ReplcamentSearchItems>
 		</DistributedSearchSource>

	</SearchSources>
</DistributedSearchSettings>


Работа в системе

Схема распределенного поиска


818.PNG

Поиск цен

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

  1. Типу тура
  2. Курорту
  3. Городу
  4. Названию тура
  5. Названию отеля (по ссылке с названия отеля пользователь может перейти на страницу с описанием отеля)
  6. Типу номера
  7. Стоимости
  8. Продолжительности
  9. Классу гостиницы
  10. Питанию
  11. Наличию мест в отеле и на рейсе

Ds052.png
По нажатию кнопки «Подобрать тур», системой будут отобраны туры, отвечающие заданным условиям. Информация в результатах поиска представлена в виде таблицы, содержащей следующие поля:

  1. Дата заезда – дата заезда по туру
  2. Отель – название отеля (по ссылке с названия отеля пользователь может перейти на страницу с описанием отеля)
  3. Категория - категория отеля
  4. Город – город, к которому привязан отель
  5. Тип номера – тип номера, на который указана цена
  6. Категория номера – категория номера, на который указана цена
  7. Размещение – размещение, на которое указана цена
  8. Питание – тип питания, на которое указана цена
  9. Ночи – продолжительность тура в ночах
  10. Цена
  11. Вал – валюта, в которой указана цена
  12. Источник цены – название тура
  13. Цена за – тип рассчитанной цены: за человека или за номер
  14. Наличие мест – наличие мест в гостинице
  15. Эконом, Бизнес - наличие мест на авиаперелеты. Колонки и их названия формируются динамически. Их отображение регулируется настройкой в конфигурационном файле web.config

По нажатию на цену пользователь попадает в экран бронирования тура. При переходе в экран бронирования по собственным турам пользователь попадает в экран «Корзина» (Basket.aspx), «Упрощенная корзина» (SimpleBasket.aspx), «Упрощенная корзина 2» (SimpleBasket.aspx) или «Расширенная корзина» (Basket.aspx) в зависимости от настроек в конфигурационном файле web.config и наличия установленных надстроек.

При переходе в экран бронирования по турам стороннего туроператора пользователь попадает в экран «Удаленная корзина» (RemoteBasket.aspx).

Актуальность цен

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

Актуальность наличия мест

В экране распределенного поиска и в экранах бронирования туров наличие мест отображается в соответствии с наличием мест в квоте на момент проверки.

Для собственных туров наличие мест отображается в соответствии с настройками в конфигурационном файле основного приложения ПК Мастер-Web.

Для туров сторонних операторов наличие мест отображается в соответствии с настройками в конфигурационном файле web-сервиса «Сервис проверки наличия мест» (ws-checkquotes).

Корректировка цен стороннего туроператора

Существует возможность корректировки цен при отображении данных от стороннего туроператора. Есть несколько вариантов корректировки цен:

  1. Добавление фиксированной наценки к общей стоимости тура от стороннего туроператора
  2. Добавление процентной наценки к общей стоимости тура от стороннего туроператора
  3. Добавление фиксированной наценки к стоимости услуг определенных классов
  4. Добавление процентной наценки с стоимости услуг определенных классов

Соответственно корректировка с добавлением наценки к общей стоимости тура применяется и в экране и поиска, и в экране бронирования туров от стороннего туроператора.

А корректировка с добавлением наценки к стоимости доп.услуг применяется только в экране бронирования туров от стороннего туроператора.

Бронирование заявки

Бронирование тура из стороннего источника происходит в экране «Удаленная корзина». Бронирование доступно только для зарегистрированных и авторизованных в системе пользователей. Ds053.png
Экран «Удаленная корзина» разделен на несколько блоков. В верхней части экрана отображаются параметры тура:

  1. Страна
  2. Название тура
  3. Даты заезда
  4. Продолжительность
  5. Состав заказа
  6. Наличие мест для отеля и авиаперелета
  7. Если в туре несколько рейсов, таблица для выбора перелетов.

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

  1. Название отеля
  2. Размещение
  3. Питание

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

Далее отображается форма для ввода туристов. Поля, обязательные для ввода определяются настройками ( см. Настройка полей данных о туристах)
Ds054.png
Если в туре присутствует несколько рейсов, то экран «Удаленная корзина» позволяет внести необходимые изменения – выбрать другой рейс. Для расчета стоимости тура с учетом изменения рейса, нужно нажать на кнопку «Пересчитать». Если в туре присутствуют услуги, исключенные при обсчете прайс-листа, то существует возможность добавления этих услуг для конкретных туристов. Для этого необходимо проставить отметки в чек-боксах для нужных услуг. Для расчета стоимости тура с учетом добавленных услуг, нужно нажать на кнопку «Пересчитать».

Для бронирования заявки необходимо нажать кнопку «Забронировать».

По нажатию кнопки «Забронировать», заявка запишется в базу данных стороннего туроператора и туроператора, являющегося владельцем приложения ПК Мастер-Web, и пользователю откроется экран с информацией о сделанном заказе.
Ds055.png
Здесь пользователю представлена информация о сделанном заказе:

  1. Номер заявки в базе стороннего туроператора
  2. Даты заезда
  3. Продолжительность
  4. Название отеля
  5. Размещение в отеле
  6. Количество человек по путевке
  7. Список туристов по услуге отель
  8. Экскурсионная программа тура
  9. Дополнительные услуги
  10. Сумма к оплате
  11. Полная стоимость заказа
  12. Номер путевки в базе туроператора, являющегося владельцем приложения ПК Мастер-Web
  13. Дата оформления заказа

При включенной настройке DSRedirectToResultPage переход осуществляется на стандартную страницу «Информация о заказе» (OrderInfo.aspx).

При бронировании заявки отправляется письмо о новом заказе на адреса:

  1. Бронирующему агентству (адрес представителя, авторизованного в системе)
  2. Адреса, указанные в настройке <Email /> в файле templates/distributedSearchSettings.xml

Поиск цен в нескольких источниках

Загрузка фильтров

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

  1. Фильтры по своим турам грузятся через прямые запросы к БД, а фильтры по данным сторонних туроператоров грузятся через web-сервис FilterBinding
  2. Фильтры по всем данным грузятся через web-сервис FilterBinding

В первом случае web-сервис устанавливается только у стороннего туроператора, чьи цены необходимо встроить в приложение туроператора – владельца приложения ПК Мастер-Web.

Во втором случае web-сервис FilterBinding устанавливается и у стороннего туроператора и у туроператора-владельца приложения ПК Мастер-Web.

Экран распределенного поиска

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

  1. Город вылета - названия городов с признаком CT_IsDeparture=1 из таблицы CityDictionary, перегружает все последующие фильтры (для туров от стороннего источника сопоставление городов вылета делается в файле templates/distributedSearchSettings.xml. При этом название города вылета может отображаться либо из базы туроператора, являющегося владельцем приложения ПК Мастер-Web, либо берется значение параметра Name для Type=departFrom из файла templates/distributedSearchSettings.xml)
  2. Страна - названия стран из таблицы tbl_Country, перегружает все последующие фильтры (для туров от стороннего источника сопоставление стран делается в файле templates/distributedSearchSettings.xml. При этом название страны может отображаться либо из базы туроператора, являющегося владельцем приложения ПК Мастер-Web, либо берется значение параметра Name для Type=country из файла templates/distributedSearchSettings.xml)
  3. Тип тура - названия типов туров из таблицы TipTur, перегружает все последующие фильтры
  4. Курорт - названия курортов из таблицы Resorts, перегружает все последующие фильтры
  5. Город - названия городов из таблицы CityDictionary, перегружает все последующие фильтры
  6. Тур - названия типов туров из таблицы tbl_TurList, перегружает все последующие фильтры
  7. Отель - названия отелей из таблицы HotelDictionary, перегружает все последующие фильтры (если поле HD_HTTP заполнено, то в названии отеля формируется ссылка на адрес, указанный в данном поле)
  8. Даты заезда - даты заезда по турам подсвечиваются в календарях
  9. Тип номера, либо количество основных и доп.мест - названия типов номеров из таблицы Rooms
  10. Цена не более указанной величины
  11. Ночи - рассчитанные продолжительности по выбранным в предыдущих фильтрах параметрам
  12. Категория - рассчитанные категории отелей по выбранным в предыдущих фильтрах параметрам
  13. Питание - рассчитанные типы питания по выбранным в предыдущих фильтрах параметрам
  14. Наличие мест в отеле и на рейсе - наличие мест "Есть", "Запрос" и "Нет"

Таблица с результатами поиска содержит поля:

  1. Дата заезда
  2. Отель
  3. Категория - категория отеля
  4. Город – город, к которому привязан отель
  5. Тип номера – тип номера, на который указана цена
  6. Категория номера – категория номера, на который указана цена
  7. Размещение – размещение, на которое указана цена
  8. Питание – тип питания, на которое указана цена
  9. Ночи – продолжительность тура в ночах
  10. Цена
  11. Вал – валюта, в которой указана цена
  12. Источник цены – название тура
  13. Цена за – тип рассчитанной цены: за человека или за номер
  14. Наличие мест – наличие мест в гостинице
  15. Эконом, Бизнес

Все поля являются текстовыми и нередактируемыми.

*Если поле HD_HTTP в таблице HotelDictionary заполнено, то в названии отеля в поле «Отель» формируется ссылка на адрес, указанный в данном поле.
*Если поле TL_WEBHTTP в таблице tbl_TurList заполнено, то в названии тура в поле «Источник цены» формируется ссылка на адрес, указанный в данном поле.

По умолчанию данные в результатах поиска отсортированы по полю «Цена» по возрастанию.

Корректировка цен стороннего туроператора

Необходимо добавить настройки для корректировки цен стороннего туроператора:

  1. Настройка для добавления фиксированной наценки к общей стоимости тура от стороннего туроператора
  2. Настройка для добавления процентной наценки к общей стоимости тура от стороннего туроператора
  3. Настройка для добавления фиксированной наценки к стоимости доп. услуг определенных классов
  4. Настройка для добавления процентной наценки с стоимости доп. услуг определенных классов

Список параметров, которые можно передать в «Распределенный поиск»

Параметры в URL для распределенного поиска

  • departfrom
  • country
  • city
  • hotel
  • resort
  • tourtype
  • tour
  • nights