Megatec Integration Service:Настройка автоматического обмена

Версия статьи от 30-05-2018.

Введение

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

• Автоматическая загрузка справочников, цен, квот, наличия мест в уже созданную промежуточную базу - Megatec.MasterTour.AdapterPluginsServices.HotelPriceDataLoader.exe.
• Автоматический импорт цен в ПК «Мастер-Тур» - Megatec.MasterTour.AdapterPluginsServices.AutoImport.HotelPrice.exe.
• Автоматический импорт квот, наличия мест в ПК «Мастер-Тур» - Megatec.MasterTour.AdapterPluginsServices.AutoImport.HotelQuota.exe.
• Автоматическое бронирование в ПК «Мастер-Тур» - Megatec.MasterTour.AdapterPluginsServices.AutoImport.AgreementsReservation.exe.

Создание задачи

«Планировщик заданий находиться в «Панели управления» => «Администрирование». В окне «Планировщик заданий» в пункте меню «Действие» выбрать подпункт «Создать задачу». В окне «Создание задачи» введите название новой задачи и ее описание. Активируйте функцию «Выполнить с наивысшими правами».

Переключитесь на вкладку «Триггеры», нажмите кнопку «Создать» и назначьте дату, время и частоту выполнения задачи. Чтобы установить дату, когда выполнение задачи по расписанию будет прекращено, активируйте функцию «Срок действия» и укажите дату и время.

Перейдите на вкладку «Действия» и нажмите кнопку «Создать». В раскрывающемся списке «Действие» выберите «Запуск программы» и с помощью кнопки «Обзор» укажите местоположение исполняемого файла, который находиться в папке с ПК «Мастер-Тур». В поле «Рабочая папка» необходимо указать рабочую папку MIS.
В поле «добавить аргументы» необходимо указать необходимые параметры с аргументами через пробел. Параметры индивидуальны для используемого адаптера, список всех параметров расположен в разделе Схема совмещения параметров. Также данные параметры можно увидеть, если запустить программу без параметров.



Пример.
Программа или сценарий:D:\Master-Tour\MIS\Megatec.MasterTour.AdapterPluginsServices.HotelPriceDataLoader.exe
Рабочая папка:D:\Master-Tour\MIS\
Аргументы:"adapter:"Megatec.MasterTour.AdapterPlugins.Import.ProTour.HotelPrice.dll"" "dict" "base_prices_period:+5" "base_quotas_period:99" "hotel:EastHotel;SouthHOtel" "partner:EastPartner;SouthPartner" "direction:Egipet;Kipr"

Также можно задать дополнительные параметры выполнения задачи на вкладке «Параметры».

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

Корректировка задачи

Выделите задачу в списке, в правом меню «Действия» выберите «Свойства», отредактируйте нужные параметры и нажмите «OK». Чтобы удалить запланированное задание, откройте «Планировщик заданий», выделите задачу в списке, в правом меню «Действия» выберите «Удалить» и подтвердите свои намерения.

Схема совмещения параметров

TERMA

		Вспомогательные параметры
		"direction:" - Названия направлений через ';'. Например: "direction:Египет;Кипр" Если параметр не указан, то загрузка производится по всем направлениям
Методы	"dict" - Загрузить справочные данные	Совместим
	"update_dict" - Загрузить последние обновления по справочным данным	Совместим
	"prices" - Загрузить цены по всем SPO	Совместим
	"quotas_days" - Загрузить наличие мест по всем отелям. По умолчанию период равен 31 дню начиная с текущего "quotas_days:31"	Совместим

VERSA

		Вспомогательные параметры
		"direction:" - Названия направлений через ';'. Например: "direction:Египет;Кипр" Если параметр не указан, то загрузка производится по всем направлениям
Методы	"dict" - Загрузить справочные данные	Совместим
	"accomodations" - Загрузить справочник размещений	Совместим
	"categories" - Загрузить справочник категорий номеров	Совместим
	"cities" - Загрузить справочник городов	Совместим
	"countries" - Загрузить справочник стран	Совместим
	"currencies" - Загрузить справочник валют	Совместим
	"hotels" - Загрузить справочник отелей	Совместим
	"meals" - Загрузить справочник питаний	Совместим
	"resorts" - Загрузить справочник регионов	Совместим
	"rooms" - Загрузить справочник типов комнат	Совместим
	"prices_quotas" - Загрузить цены и квоты	Совместим

ProTour

		Вспомогательные параметры
		"direction:" - Названия направлений через ';'. Например: "direction:Египет;Кипр" Если параметр не указан, то загрузка производится по всем направлениям	"partner:" - Коды партнеров через ';'. Например: "partner:EastPartner;SouthPartn er" Если параметр не указан, то загрузка производится по всем партнерам	"hotel:" - Коды отелей через ';'. Например: "hotel:EastHotel;SouthHotel" Если параметр не указан, то загрузка производится по всем отелям	"quotas_start_id" - 'Код квоты с' для параметра 'Загрузить квоты и стопы за день'. По умолчанию "quotas_start_id:0"	"quotas_end_id" - 'Код квоты по' для параметра 'Загрузить квоты и стопы за день'. По умолчанию "quotas_end_id:999999"	"timezone" - Поправка часовых поясов для метода загрузки квот в интервале времени (quotasfordayV2). По умолчанию используется текущее время. Чтобы задать разниц у во времени на час вперед "timezone:Совместим1"
Методы	"dict" - Загрузить справочные данные	Совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим
	"base_prices_period" - Загрузить базовые цены. По умолчанию период равен 12 меся цам начиная с текущего дня "base_prices_period:12"	Совместим	Совместим	Совместим	Не совместим	Не совместим	Не совместим
	"new_prices_period" - Загрузить цены за период(новый метод GetPricesPeriod). По умолчанию период равен 12 месяцам начиная с текущего дня "new_prices_period:12"	Совместим	Совместим	Совместим	Не совместим	Не совместим	Не совместим
	"delete_prices_period" - Загрузить удаленные цены. По умолчанию период равен 31 дню, начиная с текущего дня "delete_prices_period:31"	Совместим	Совместим	Не совместим	Не совместим	Не совместим	Не совместим
	"update_prices_period" - Загрузить обновления цен. По умолчанию период равен 1 дню, начиная с текущего "update_prices_period:1"	Совместим	Совместим	Совместим	Не совместим	Не совместим	Не совместим
	"base_quotas_period" - Загрузить квоты и стопы. По умолчанию период равен 31 дню , начиная с текущего "base_quotas_period:31"	Совместим	Совместим	Совместим	Не совместим	Не совместим	Не совместим
	"quotasforday" - Загрузить квоты и стопы за один день. Например за вчерашний ден ь: "quotasforday:-1". По умолчанию сегодняшняя дата	Совместим	Совместим	Не совместим	Не совместим	Совместим	Совместим
	"quotasfordayV2" - Загрузить квоты за текущий день в интервале времени (в минутах). Например за последние 30 минут: "quotasfordayV2:-30"	Совместим	Совместим	Совместим	Не совместим	Не совместим	Совместим

Sejour

		Вспомогательные параметры
		"direction:" - Названия направлений через ';'. Например: "direction:Египет;Кипр" Если параметр не указан, то загрузка производится по всем направлениям	"priceNights:" - Количество ночей. Указывается при загрузке цен и/или квот. Если параметр не указан, то загрузка цен будет производиться для цен с параметром "priceNights:180", а для квот "priceNights:1"
Методы	"dict" - Загрузить все справочные данные	Совместим	Не совместим
	"hotels" - Загрузить справочник отелей и городов.	Совместим	Не совместим
	"rates" - Загрузить справочник валют.	Совместим	Не совместим
	"roomtypes" - Загрузить справочник типов номеров.	Совместим	Не совместим
	"rooms" - Загрузить справочник категорий номеров и размещений.	Совместим	Не совместим
	"pansions" - Загрузить справочник питаний.	Совместим	Не совместим
	"transfers" - Загрузить справочник транспортов (трансферов).	Совместим	Не совместим
	"spos" - Загрузить справочник Spo.	Совместим	Не совместим
	"prices" - Загрузить цены. Цены загружаются от текущего дня	Совместим	Совместим
	"changedPrices" - Загрузить измененные цены. Цены загружаются от текущего дня	Совместим	Совместим
	"pricesGeneralXml" - Загрузить цены методом GetGeneralExportXml. Цены загружаются от текущего дня	Совместим	Совместим
	"changedPricesGeneralXml" – Загрузить измененные цены методом GetGeneralExportXml. Цены загружаются от текущего дня	Совместим	Совместим
	"quotas" – Загрузить квоты. Квоты загружаются от текущего дня	Совместим	Совместим
	"stops" – Загрузить StopSales. StopSales загружаются от текущего дня	Совместим	Совместим
	"pricesBatchSize" – Максимальный размер пачки для загрузки цен. Необходим для уменьшения нагрузки при скачивании цен в промежуточную бд. По умолчанию не ограничен.	Совместим	Совместим

Eurotours

		Вспомогательные параметры
		"direction:" - Названия направлений через ';'. Например: "direction:Египет;Кипр" Если параметр не указан, то загрузка производится по всем направлениям	"arrivalDate:" - Дата c (иcпользуется для загрузки справочников отелей, питаний и валют). Например: "arrivalDate:01.01.2014". По умолчанию используется сегодняш ний день	"duration:" - Продолжительность (иcпользуется для загрузки справочников отелей, питаний и валют). Например: "duration:7". По умолчанию используется значение 7	"location:" - Код города (LocationCode) через ';' или ',' (иcпользуется для загр узки справочников отелей, питаний и валют). Например: "location:Innsbruck". По у молчанию данные загружаются по всем городам	"priceDate:" - Дата c (иcпользуется для загрузки цен). Например: "priceDate:01.0 1.2014". По умолчанию используется сегодняшний день	"serviceType:" - Комната или апартаменты (иcпользуется для загрузки цен). По умо лчанию используется значение ZIMMER(=room). Если цена не за комнату, то использу йте "serviceType:APPART".	"hotel:" - Код отеля (ObjectCode) через ';' или ',' (иcпользуется для загрузки ц ен). Например: "hotel:CONGRESS INNS". По умолчанию отель:CONGRESS INNS
Методы	"dict" - Загрузить все справочные данные	Совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим
	"cities" - Загрузить справочник городов.	Совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим
	"countries" - Загрузить справочник стран.	Совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим
	"hotelCategories" - Загрузить справочник звездности отелей.	Совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим
	"languages" - Загрузить справочник языков.	Совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим
	"rooms" - Загрузить справочник номеров.	Совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим
	"searchObjects" - Загрузить справочников отелей, питаний и валют.	Совместим	Совместим	Совместим	Совместим	Не совместим	Не совместим	Не совместим
	"prices" - Загрузить цены.	Совместим	Не совместим	Не совместим	Не совместим	Совместим	Совместим	Совместим
	"quotas" - Загрузить наличия мест.	Совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим	Не совместим

TravelLine

Автоматическая загрузка данных в промежуточную базу - Megatec.MasterTour.AdapterPluginsServices.HotelPriceDataLoader.exe

Метод	Описание
dictionary	Загрузить все справочные данные
price_all	Загрузить все цены. После запуска запроса на закачку всех цен, через 20 минут необходимо запустить автозагрузку с аргументом "price"
quota_all	Загрузить все квоты. После запуска запроса на закачку всех квот, через 20 минут необходимо запустить автозагрузку с аргументом "quota"
stop_all	Загрузить все стопы. После запуска запроса на закачку всех стопов, через 20 минут необходимо запустить автозагрузку с аргументом "stop"
hotels	Отели, для которых будет производиться загрузка данных (коды отелей через запятую)
price	Загрузить изменения по ценам
quota	Загрузить изменения по квотам
stop	Загрузить изменения по стопам

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

Пример:
Параметры: D:\MasterTour\MIS\Megatec.MasterTour.AdapterPluginsServices.HotelPriceDataLoader.exe
Аргументы: "adapter:"Megatec.MasterTour.AdapterPlugins.Import.TravelLine.dll"" "dictionary" "hotels:2079,2080,2234" "price"

Автоматический импорт квот за отели в ПК «Мастер-Тур» - Megatec.MasterTour.AdapterPluginsServices.AutoImport.HotelQuota.exe

Метод	Описание
autosynch_off	Если в адаптере предусмотрена автосинхронизация, то для её отключения используется данный аргумент
max_quota_count	По умолчанию автоимпорт производится пачками по 30 000 квот. Для отмены разбиения на пачки используется данный аргумент с нулевым значением

Пример:
Параметры: D:\MasterTour\MIS\Megatec.MasterTour.AdapterPluginsServices.AutoImport.HotelQuota.exe
Аргументы: "adapter:"Megatec.MasterTour.AdapterPlugins.Import.TravelLine.dll"" "max_quota_count:10000"

Автоматический импорт цен за отели в ПК «Мастер-Тур» - Megatec.MasterTour.AdapterPluginsServices.AutoImport.HotelPrice.exe

Метод	Описание
autosynch_off	Если в адаптере предусмотрена автосинхронизация, то для её отключения используется данный аргумент
max_quota_count	По умолчанию автоимпорт производится пачками по 30 000 цен. Для отмены разбиения на пачки используется данный аргумент с нулевым значением

Пример:
Параметры: D:\MasterTour\MIS\Megatec.MasterTour.AdapterPluginsServices.AutoImport.HotelPrice.exe
Аргументы: "adapter:"Megatec.MasterTour.AdapterPlugins.Import.TravelLine.dll"" "max_price_count:10000"

Автоматическое бронирование в ПК «Мастер-Тур» - Megatec.MasterTour.AdapterPluginsServices.AutoImport.AgreementsReservation.exe

Метод	Описание
directions	По умолчанию автоматическое бронирование происходит по всем направлениям. Для бронирования конкретных направлений указываются необходимые названия направлений
threads	Количество одновременно обрабатываемых путевок. Значение параметра по умолчанию 10
alt	Если данный аргумент задан, то каждая операция бронирования применяется ко всем путевкам по очередности, иначе к каждой путевке применяются все операции бронирования далее обрабатывается следующая путевка

Пример:
Параметры: D:\MasterTour\MIS\Megatec.MasterTour.AdapterPluginsServices.AutoImport.AgreementsReservation.exe
Аргументы: "adapter:"Megatec.MasterTour.AdapterPlugins.Import.TravelLine.dll"" "direction:Egipet;Kipr" "threads:5"

TourMLImport

Автоматическая загрузка квот за отели и за перелёты в промежуточную базу - Megatec.MasterTour.AdapterPluginsServices.HotelPriceDataLoader.exe

Метод	Описание
quota_update	Обновить квоты и справочники
quota_reload	Перезагрузить квоты и справочники
quota_checkInDate	Дата, с которой необходимо получение квот

Пример:
Параметры: D:\MasterTour\MIS\Megatec.MasterTour.AdapterPluginsServices.HotelPriceDataLoader.exe
Аргументы: "adapter:"Megatec.MasterTour.AdapterPlugins.Import.TourMLImport.dll"" "quota_reload" "quota_checkInDate:01.02.2018"

Автоматический импорт квот за перелеты в ПК «Мастер-Тур» - Megatec.MasterTour.AdapterPluginsServices.AutoImport.FlightQuota.exe

Метод	Описание
max_quota_count	По умолчанию автоимпорт производится пачками по 30 000 квот. Для отмены разбиения на пачки используется данный аргумент
type	По умолчанию импортируются всё. Для задания другого значения используется данный аргумент. 0 - всё, 1 - квоты, 2 - стопы

Пример:
Параметры: D:\MasterTour\MIS\Megatec.MasterTour.AdapterPluginsServices.AutoImport.FlightQuota.exe
Аргументы: "adapter:"Megatec.MasterTour.AdapterPlugins.Import.TourMLImport.dll"" "max_quota_count:0" "type:1"

Автоматический импорт квот за отели в ПК «Мастер-Тур» - Megatec.MasterTour.AdapterPluginsServices.AutoImport.HotelQuota.exe

Метод	Описание
autosynch_off	Если в адаптере предусмотрена автосинхронизация, то для её отключения используется данный аргумент
max_quota_count	По умолчанию автоимпорт производится пачками по 30 000 квот. Для отмены разбиения на пачки используется данный аргумент
type	По умолчанию импортируются всё. Для задания другого значения используется данный аргумент. 0 - всё, 1 - квоты, 2 - стопы

Пример:
Параметры: D:\MasterTour\MIS\Megatec.MasterTour.AdapterPluginsServices.AutoImport.HotelQuota.exe
Аргументы: "adapter:"Megatec.MasterTour.AdapterPlugins.Import.TourMLImport.dll"" "autosynch_off" "type:1"

Автоматическое бронирование в ПК «Мастер-Тур» - Megatec.MasterTour.AdapterPluginsServices.AutoImport.AgreementsReservation.exe

Метод	Описание
directions	По умолчанию автоматическое бронирование происходит по всем направлениям. Для бронирования конкретных направлений указываются необходимые названия направлений
threads	Количество одновременно обрабатываемых путевок. Значение аргумента по умолчанию 10

Пример:
Параметры: D:\MasterTour\MIS\Megatec.MasterTour.AdapterPluginsServices.AutoImport.AgreementsReservation.exe
Аргументы: "adapter:"Megatec.MasterTour.AdapterPlugins.Import.TourMLImport.dll"" "direction:Egipet;Kipr" "threads:5"

SAMO

Автоматическая загрузка данных в промежуточную базу - Megatec.MasterTour.AdapterPluginsServices.HotelPriceDataLoader.exe

Метод	Описание
dictionary	Загрузить все справочные данные
price	Загрузить изменения по ценам
quota	Загрузить изменения по квотам и стопам

Пример:
Параметры: D:\MasterTour\MIS\Megatec.MasterTour.AdapterPluginsServices.HotelPriceDataLoader.exe
Аргументы: "adapter:"Megatec.MasterTour.AdapterPlugins.Import.Samo.dll"" "dictionary" "price"

Автоматический импорт квот за отели в ПК «Мастер-Тур» - Megatec.MasterTour.AdapterPluginsServices.AutoImport.HotelQuota.exe

Метод	Описание
max_quota_count	По умолчанию автоимпорт производится пачками по 30 000 квот. Для отмены разбиения на пачки используется данный аргумент с нулевым значением
autosynch_off	Если в адаптере предусмотрена автосинхронизация, то для её отключения используется данный аргумент
itemsType	По умолчанию импортируются всё. Для задания другого значения используется данный аргумент. 0 - всё, 1 - квоты, 2 - стопы

Пример:
Параметры: D:\MasterTour\MIS\Megatec.MasterTour.AdapterPluginsServices.AutoImport.HotelQuota.exe
Аргументы: "adapter:"Megatec.MasterTour.AdapterPlugins.Import.Samo.dll""

Автоматический импорт цен за отели в ПК «Мастер-Тур» - Megatec.MasterTour.AdapterPluginsServices.AutoImport.HotelPrice.exe

Метод	Описание
max_quota_count	По умолчанию автоимпорт производится пачками по 30 000 цен. Для отмены разбиения на пачки используется данный аргумент с нулевым значением
autosynch_off	Если в адаптере предусмотрена автосинхронизация, то для её отключения используется данный аргумент

Пример:
Параметры: D:\MasterTour\MIS\Megatec.MasterTour.AdapterPluginsServices.AutoImport.HotelPrice.exe
Аргументы: "adapter:"Megatec.MasterTour.AdapterPlugins.Import.Samo.dll""

Автоматическое бронирование в ПК «Мастер-Тур» - Megatec.MasterTour.AdapterPluginsServices.AutoImport.AgreementsReservation.exe

Метод	Описание
directions	По умолчанию автоматическое бронирование происходит по всем направлениям. Для бронирования конкретных направлений указываются необходимые названия направлений
threads	Количество одновременно обрабатываемых путевок. Значение параметра по умолчанию 10

Пример:
Параметры: D:\MasterTour\MIS\Megatec.MasterTour.AdapterPluginsServices.AutoImport.AgreementsReservation.exe
Аргументы: "adapter:"Megatec.MasterTour.AdapterPlugins.Import.Samo.dll"" "direction:Egipet;Kipr" "threads:5"

Автоматический режим плагина импорта цен за новогодние ужины ProTour

Введение

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

Установка модуля

В ПК «Мастер-Тур» версии 2009.2.20 и выше автозагрузчик устанавливается копированием следующих файлов в папку с «Мастер-Тур» и прописыванием в конфигурационный файл адрес сервиса - ImportService из файла Master32.exe.config:
Megatec.MasterTour.AdapterServices.AutoImport.ProTour.GalaDinners.exe
Megatec.MasterTour.AdapterServices.AutoImport.ProTour.GalaDinners.exe.config

Настройка конфигурационного файла

Прежде чем запускать автоматическую загрузку надо настроить раздел appSettings файла:
Megatec.MasterTour.AdapterServices.AutoImport.ProTour.GalaDinners.exe.config

Список обозначений

• Логин – Логин для направления
• Пароль –Пароль для направления.
• Ссылка – Ссылка на веб сервис из которого будет производиться загрузка
• Partner – Код партнера из внешнего сервиса.
• PartnerMT – Код партнера из «Мастер-Тур».
• CodeSpecialPacket – Код пакета для обязательных ужинов из «Мастер-Тур».
• CodeNotSpecialPacket – Код пакета для необязательных ужинов из «Мастер-Тур».
• ServerMT – Название сервера, на котором находиться база данных ПК «Мастер-Тур».
• DatebaseMT – Название базы данных ПК «Мастер-Тур».
• idDB – Логин пользователя для базы данных.
• PasswordDB – Пароль пользователя для базы данных.

<appSettings>
    <add key="Login" value="Логин"/>
    <add key="Password" value="Пароль"/>
    <add key="Url" value="Ссылка"/>
    <add key="PartnerCode" value="Partner"/>
    <add key="PartnerKey" value="PartnerMT"/>
    <add key="SpecialPacketKey" value="CodeSpecialPacket"/>
    <add key="NotSpecialPacketKey" value="CodeNotSpecialPacket"/>
    <add key="connectionString" value="Data Source=ServerMT; Initial Catalog=DatebaseMT; User Id= idDB; Password=PasswordDB;Application Name=Anton" />
</appSettings>