Megatec Integration Service:Настройка автоматического обмена — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(TravelLine)
Строка 424: Строка 424:
 
|type
 
|type
 
|По умолчанию импортируются всё. Для задания другого значения используется данный аргумент. 0 - всё, 1 - квоты, 2 - стопы
 
|По умолчанию импортируются всё. Для задания другого значения используется данный аргумент. 0 - всё, 1 - квоты, 2 - стопы
 +
|-
 +
|ignore_tour_stops
 +
|Данный аргумент предназначен для отключения автоимпорта стопов на тариф
 
|}
 
|}
 
'''Пример:'''  <br />
 
'''Пример:'''  <br />

Версия 14:16, 3 июля 2018

Версия статьи от 3-07-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.

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

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

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


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


Пример.
Программа или сценарий: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"
планировщик заданий Windows

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

После завершения всех этих действий, нажмите «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 квот. Для отмены разбиения на пачки используется данный аргумент с нулевым значением
type По умолчанию импортируются всё. Для задания другого значения используется данный аргумент. 0 - всё, 1 - квоты, 2 - стопы
ignore_tour_stops Данный аргумент предназначен для отключения автоимпорта стопов на тариф

Пример:
Параметры: 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 Если в адаптере предусмотрена автосинхронизация, то для её отключения используется данный аргумент
type По умолчанию импортируются всё. Для задания другого значения используется данный аргумент. 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>