Мастер-Тур:Дополнительный модуль Акции

Статья находится на стадии разработки.
Версия статьи от 5-08-2015.

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

Введение

Дополнительный модуль «Акции» дает возможность корректно вносить и рассчитывать стоимость услуги проживания в тех случаях, когда отели или DMC-операторы предлагают различные специальные предложения. Например «PayStay» (живешь 7 ночей, платишь за 5). Использование модуля позволяет рассчитывать на сайт турпакет точно по цене СПО. Кроме этого в создаваемых заявках корректно рассчитывается и цена Нетто, что позволяет, в свою очередь, правильно рассчитывать планируемую прибыль по заказу. Важно отметить, что использование плагина в несколько раз сокращает затраты сотрудников на внесение цен по СПО и уменьшает вероятность ошибок за счет упрощения процесса внесения цен.

Системные требования

Релиз 9.2.20 ПК «Мастер-Тур»/«Мастер-Web»
Минимальная поддерживаемая версия SQL Server 2008 R2 SP1 (10.50.2500.0)
IIS 8.0 (.Net Framework 4.5) для дополнительного модуля «Акции».
Google Chrome на клиентских компьютерах. Дополнительный модуль «Акции» корректно отображается только в браузере Google Chrome.

Установка

Установка дополнительного модуля «Акции» производится в несколько этапов, которые описаны ниже.

Обновление базы данных

Необходимо выполнить скрипты обновления по базе данных ПК «Мастер-Тур»:

• 1_CreateSpecialsTables.sql
• 2_Enable_Change_Tracking_Specials.sql
• 3_sp_GetServiceCost.sql

Установка службы кэширования

Данная служба предназначена для увеличения производительности работы модуля «Акции» путем хранения суточных 
цен в оперативной памяти сервера. Рекомендуется устанавливать ее в том случае, если суммарный объем цен 
превышает 20 млн. (ниже представлен запрос для определения количества суточных цен. В противном случае 
можно пропустить этот шаг и сразу приступать к установке модуля «Акции».

Запрос для определения количества суточных цен

select count (*) from tbl_Costs 
where (CS_DATEEND >= DATEADD(dd, 0, DATEDIFF(dd, 0, GETDATE())) 
 or CS_CHECKINDATEEND >= DATEADD(dd, 0, DATEDIFF(dd, 0, GETDATE())))
 and CS_SVKEY = 3 

• Копирование каталога SpecialsCacheService из дистрибутива на сервер приложений.
• Настройка конфигурационного файла Megatec.MasterTour.SpecialsCacheService.exe.config.

№	Описание	Значение	Настройка
1	Строка подключения	Строка подключения к базе данных ПК «Мастер-Тур» указывается в секции appSettings. Внимание! Для корректной работы в поле User Id необходимо указать пользователя sa.	<add key="connectionString" value="Data Source=Server; Initial Catalog=MasterTourDatabase; User Id=User; Password=123; Application Name=CalculateTourBalanser" />
2	Логирование	Пути к лог-файлам задаются в секциях логирования.	<param name="File" value="Logs\\SpecialsCacheErrorLog.txt" /> Логирование ошибок работы службы кэширования <param name="File" value="Logs\\SpecialsCacheLog.txt" /> Логирование работы процессов службы кэширования
3	Порт	По умолчанию служба кэширования использует порт 52529. Рекомендуется использование порта по умолчанию. Внимание! При смене порта необходимо также изменить порт в установочном скрипте _Install.bat.	<add baseAddress="http://*:52529/SpecialsCache/SpecialsAccommodationsCacheService" />

• Установка осуществляется запуском скрипта _Install.bat от имени администратора.
• При установке в Брандмауэре Windows создаются правила для входящих подключений для открытия порта кэширования.
• В Службах Windows добавляется служба SpecialsCacheService.
  

• Для удаления службы кэширования необходимо запустить скрипт _UnInstall.bat от имени администратора. При этом будут удалены правила для входящих подключений.

Установка модуля «Акции»

Для установки модуля «Акции» нужно создать отдельную директорию, например, wsSpecials (далее в примерах будет использоваться данное название каталога) в корневом каталоге IIS (по умолчанию c:/inetpub/wwwroot) и выложить туда распакованные файлы из архива Specials9.2.X.XXXXX.zip. В управлении IIS необходимо создать виртуальный каталог для папки wsSpecials.

Создание виртуального каталога

По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:

1. Зайти в Пуск (Start) – Панель управления (Control Panel) – Администрирование (Administrative Tools).

2. Запустить Internet Information Services (IIS) Manager.

3. В открывшемся дереве каталогов выбрать сайты (Web Sites) – Default Web Site (либо другой сайт, на который планируется установить приложение). В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и выбрать пункт «Преобразовать в приложение».

Подключение к базе данных ПК «Мастер-Тур»

В файле web.config, расположенном в папке wsSpecials, в которую установлен web-сервис «Акции», пропишите необходимые параметры подключения (курсивом выделены значения, которые необходимо ввести). Строка подключения к базе данных ПК «Мастер-Тур»: <add key = "connectionString" value = "Data Source=ip-адрес сервера базы данных ПК Мастер-тур;Initial Catalog=название базы данных ПК Мастер-тур;User ID= логин пользователя ПК Мастер-тур;Password=пароль пользователя ПК Мастер-тур"/>

Настройки в файле WEB.CONFIG

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

№	Описание	Значение	Настройка
1	Настройка, позволяющая переходить из экрана «Список туров для перерасчета» на указанный тур в «Прайс-Экспресс».	Указывается ссылка на развернутый «Прайс-Экспресс», где в tourKey={0} - подставляется ключ тура автоматически.	<add key="recalculateTourUrl" value="http://ip-адрес сервера Мастер-Веб/PanelPE/?tourKey={0}"/>
2	Настройка кэширования данных.	true – включить кэширование данных; false или отсутствие настройки – отключение кэширования	<add key="useCacheService" value="true"/>

Если настройка кэширования включена, то экран акции не запустится, пока не загрузится полностью кэш.

Работа с модулем

После установки модуль «Акции» доступен по адресу: http://ip-адрес сервера Мастер-Веб/wsSpecials.

Авторизация

При запуске сервиса «Акции» необходимо пройти авторизацию в системе. Для авторизации нужно использовать логин/пароль, как при входе в ПК «Мастер-Тур».

Список акций

После прохождения авторизации откроется экран с фильтрами для поиска существующих акций.

• Страна – отображаются все страны, по которым есть созданные акции
• Город – отображаются все города, для отелей которых есть созданные акции
• Отель – отображаются все отели, для которых есть заведенные акции
• Партнер – отображаются все партнеры, по которым есть заведенные акции
• Пакеты – отображаются все пакеты, для которых есть заведенные акции
• Тип акции – PayStay (предоставление бесплатных ночей) и KickBack ((скидка в % на определенные даты)
• Состояние – Используется для расчета и Не используется для расчета
• Даты – выбор из 3 позиций: все даты, на период, на заезд

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

• Название акции – заводится пользователем при создании акции
• Тип акции – PayStay (предоставление бесплатных ночей) и KickBack ((скидка в % на определенные даты), одна акция может быть привязана только к одному типу
• Описание акции – отображается партнер, на которого действует акция и условия ее предоставления
• Даты действия – указывается диапазон действия дат (может быть либо на период, либо на заезд)
• Даты продажи – указываются даты продажи акции, если они заданы
• Состояние – Используется для расчета и Не используется для расчета
• Активация – указывается дата и время, когда акция перешла в состояние Используется для расчета. Если в момент заведения акции признак Используется для расчета ставится сразу, то дата активации равна дате создания акции, если признак ставится позднее в уже созданной акции, то дата активации равна дате сохранения данных изменений.

По умолчанию акции в списке сортируются по состоянию, далее по дате активации.

Добавление/редактирование акций

Для добавления новой акции необходимо нажать на кнопку «Добавить новую акцию» и в выпадающем списке выбрать тип акции PayStay (предоставление бесплатных ночей) и KickBack (скидка в % на определенные даты).
В экране добавления новой акции есть несколько вкладок:

• Условия акции
• Варианты размещения
• Список туров для перерасчета
• История

Удалять акции на текущем этапе нельзя.

Условия акции (PayStay или KickBack)

Вкладка Условия акции предназначена для внесения основных данных об акции, а именно:

• Название акции – текстовое поле, заполняется произвольным текстом.
• Даты – на период действия цены или на дату заезда по туру. Задается первая и последняя дата действия СПО, если необходимо задать несколько периодов, то это можно сделать нажатием на Добавить период. В случае, если для первого периода выбран период действия цены, то во всех последующих добавленных строках также будет период действия цен. Также параллельно с периодами дат можно задать даты продажи, в которые актуально данное СПО
• Правило для акции PayStay:
  • Ночей от – нижний порог продолжительности услуги
  • Ночей до – верхний порог продолжительности услуги
  • Действие – возможные варианты «=», «+», «-»
  • Значение – количество ночей в зависимости от действия
  • Тип бесплатной ночи – какая ночь будет являться бесплатной (возможные варианты «первая», «последняя», «мин. цена (брутто)», «макс. цена (брутто)», «средняя стоимость ночи»)

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

• Правило для акции KickBack:
  • Ночей от – нижний порог продолжительности услуги
  • Ночей до – верхний порог продолжительности услуги
  • Действие – возможные варианты «-%»
  • Значение – процент скидки

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

• Акцию можно использовать одновременно с – возможность выбора другого типа акции, с которой можно комбинировать текущую акцию. 0
• Использовать акцию для расчета – данный признак определяет состояние акции. В момент простановки признака и нажатия на Сохранить акция начинает действовать и влиять на расчет во всех экранах ПК «Мастер-Тур». В этот же момент проставляется дата активации для акции. Для применения акций в ПК «Мастер-Web» необходимо перерасчитать связанные туры.
  

При сохранении акции производится проверка на корректность заполнения данных: в колонках «ночи от» и «ночи до» значения не должны пересекаться, это актуально только в том случае, если задано более одного условия в рамках одной акции.

Например:

Если заданы следующие правила, то проверка должна пройти корректно, потому что нет одинаковой продолжительности в разных условиях:

Ночей от	Ночей до	Действие	Значение	Тип бесплатной ночи
7	13	-	1	мин. цена
14	20	-	2	мин. цена

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

Ночей от	Ночей до	Действие	Значение	Тип бесплатной ночи
7	13	-	1	мин. цена
11	15	-	2	первая
14	20	-	2	мин. цена

В этом случае пользователю будет выдано предупреждение:

Логика расчета для дат проживания

• Даты заведены на период: при расчете стоимости услуги акция будет применяться в случае, если все проживание по услуге попадает в ограничение по датам.
• Даты заведены на заезд: при расчете стоимости услуги акция будет применяться в случае, если рассчитывается стоимость проживания на указанные даты заезда в отель (анализируется именно дата заезда, т.е. дата начала действия услуги, т.к. заезд в отель может производиться и на 2-й и на 3-й день).
• Применение периодов продаж: периоды продаж также анализируются при расчетах, связанных с акцией. При расчете тура производится проверка, входит ли текущая дата (дата расчета) в указанные периоды продаж или нет. Если входит, то акция применяется, если нет, то акция не применяется.
  

Варианты размещения

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

• Партнер – отображаются все поставщики, по которым есть цены на отели на будущие даты
• Страна – отображаются все страны, для отелей которых есть цены на будущие даты по выбранному ранее поставщику
• Пакеты – отображаются все пакеты, для отелей которых есть цены на будущие даты по выбранному ранее поставщику и стране

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

После выбора всех указанных выше фильтров производится заполнение отелей, вариантов проживания и питаний.

На вкладке Отели по умолчанию отображаются все отели, на которые заведены цены в конструкторе туров.

• Для расчета тура только с определенными отелями необходимо выбрать их в верхней таблице и нажать на кнопку «Добавить».
• Отбор отелей по параметрам можно регулировать с помощью фильтра, который позволяет выбрать отели по категории, городу, курорту, партнеру или названию. Также для удобства отбора отелей можно воспользоваться кнопкой «Инвертировать», которая изменит установленные признаки отелей на противоположные. Для этого необходимо кликом по стрелочке, находящейся в правой части кнопки «Добавить», открыть меню и выбрать пункт «Инвертировать».
• Удаление выбранных отелей осуществляется нажатием на кнопку «Добавить» или выбором соответствующего пункта меню.
• Для удаление ранее выбранных отелей необходимо выбрать их в нижней таблице и нажать кнопку «Удалить».

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

Список туров для перерасчета

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

После внесения акции необходимо произвести расчет нового тура или же перерасчет существующего тура.

В момент расчета стоимости услуги производится анализ наличия акции. Акции анализируются не только при расчете тура с помощью PriceExpress, но также во всех экранах, где производится расчет стоимости услуги:

• Конструктор туров
• Оформление клиентов
• Путевка
• Все корзины (SimpleBasket, SimpleBasket2, Basket, AdvancedBasket)
• Web-сервисы бронирования
• Сервис бронирования TourML

История

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

Изменяемые параметры в акциях:

№	Описание	Значение
1	Название	Указывается пользователем при создании
2	Тип дат действия	На заезд/период
3	Даты действия	Указываются даты действия
4	Даты продаж	Указываются даты продажи
5	Условия	Указываются правила действия
6	Использование для расчета	Состояние
7	Партнер	Указывается партнеры из списка
8	Страна	Указывается страна из списка
9	Пакеты	Указываются пакеты из списка
10	Отели	Указываются отели
11	Виды проживания	Указываются виды проживания
12	Питание	Указываются виды питания
13	Одновременное использование	Добавление/исключение другой акции к имеющейся