Мастер-Тур(15):Программа туров. Внешние системы. Авиа GDS — различия между версиями
[досмотренная версия] | [досмотренная версия] |
Rogozhin (обсуждение | вклад) |
Biryukov (обсуждение | вклад) |
||
Строка 12: | Строка 12: | ||
==Работа в экране «Внешние системы»== | ==Работа в экране «Внешние системы»== | ||
Страница '''Внешние системы''' представлена двумя вкладками: | Страница '''Внешние системы''' представлена двумя вкладками: | ||
− | * ''' | + | * '''Внешние поставщики''' – где происходит создание и редактирование пользователей системы; |
− | * '''Синхронизация''' | + | * '''Синхронизация''' – где осуществляется работа по сопоставлению данных из внешней системы. |
− | === | + | ===Внешние поставщики=== |
− | На вкладке | + | На вкладке Внешние поставщики представлен список поставщиков. Для каждого поставщика указан: |
* Название | * Название | ||
* Адаптер | * Адаптер | ||
* Адрес API | * Адрес API | ||
− | * | + | * Срок действия лицензии |
− | [[Файл: | + | [[Файл:mb_347.png|Внешние поставщики]]<br/> |
Любого поставщика можно отредактировать, выбрав по названию. Также можно добавить нового, нажав кнопку '''Добавить'''. | Любого поставщика можно отредактировать, выбрав по названию. Также можно добавить нового, нажав кнопку '''Добавить'''. | ||
− | [[Файл: | + | [[Файл:mb_346.png|Новый поставщик]]<br/> |
Список полей для заполнения ( * – обязательное): | Список полей для заполнения ( * – обязательное): | ||
− | * | + | * Адаптер * – выбирается из списка |
− | * | + | * Название * – название поставщика |
− | * API адрес * – должен быть представлен в виде http(s)://domain(.ru)(:9999)(/something) | + | * API адрес * – должен быть представлен в виде http(s)://domain(.ru)(:9999)(/something) |
− | + | * Авторизационный токен * – ключ доступа к серверу, по которому будет происходить подключение к внешнему поставщику | |
− | + | * ID клиента * – id поставщика во внешней системе (предоставляется вместе с авторизационным токеном) | |
− | * Авторизационный токен * – ключ доступа к серверу, по которому будет происходить подключение к | + | * ID агентства – id агентства во внешней системе (предоставляется вместе с авторизационным токеном) |
− | * ID клиента * – id поставщика | + | Подключение к API адресу внешнего поставщика можно проверить по нажатию на кнопку '''Проверить подключение'''. Система производит пробное подключение к API и проверяет его доступность. |
− | * ID агентства – id агентства | ||
− | |||
− | Подключение к API адресу | ||
При сохранении внешнего поставщика в БД автоматически создается ценовой пакет и поставщик с названием, | При сохранении внешнего поставщика в БД автоматически создается ценовой пакет и поставщик с названием, | ||
− | которое было введено при создании поставщика, в скобках указывается | + | которое было введено при создании поставщика, в скобках указывается (внешняя система). Это необходимо для того, |
− | чтобы | + | чтобы была возможность внести стоимость услуги, по которой будет работать поиск (при условии, что разрешается |
только бронирование услуги из внешней системы). | только бронирование услуги из внешней системы). | ||
− | В случае, если внешний поставщик внесен для услуги | + | В случае, если внешний поставщик внесен для услуги ''Авиаперелет'', то поставщику автоматически ставится признак ''Авиаперевозчик''. |
===Синхронизация=== | ===Синхронизация=== | ||
Строка 55: | Строка 52: | ||
Синхронизация служит для сопоставления справочных данных из внешней системы со справочными данными, указанными в '''ПК Мастер-Тур'''. Для того, чтобы начать работу, нужно выбрать необходимые данные: | Синхронизация служит для сопоставления справочных данных из внешней системы со справочными данными, указанными в '''ПК Мастер-Тур'''. Для того, чтобы начать работу, нужно выбрать необходимые данные: | ||
− | * В списке '''Поставщик''' выбираем интересующего поставщика (в списке отображаются названия поставщиков, созданные на вкладке | + | * В списке '''Поставщик''' выбираем интересующего поставщика (в списке отображаются названия поставщиков, созданные на вкладке внешние поставщики) |
− | * В списке '''Справочник''' выбираем необходимый справочник | + | * В списке '''Справочник''' выбираем необходимый справочник |
[[Файл:jk_171.png|Новый поставщик]]<br/> | [[Файл:jk_171.png|Новый поставщик]]<br/> | ||
Слева отображаются справочные данные внешней системы. Справа отображаются справочные данные из '''ПК Мастер-Тур'''.<br/> | Слева отображаются справочные данные внешней системы. Справа отображаются справочные данные из '''ПК Мастер-Тур'''.<br/> | ||
− | Данные, которые сопоставлены - подсвечены черным цветом. Не сопоставленные данные подсвечены красным цветом. Существует возможность фильтрации справочных данных по статусу ( | + | Данные, которые сопоставлены - подсвечены черным цветом. Не сопоставленные данные подсвечены красным цветом. Существует возможность фильтрации справочных данных по статусу (''Сопоставлен'' или ''Не сопоставлен'') и поиска по названию.<br/> |
В блоке '''Сопоставленные данные''' отображаются сопоставленные данные по выбранным элементам в левой или/и правой частях. Отображаемые данные сортируются по алфавиту. Данные можно сопоставлять и удалять сопоставление: | В блоке '''Сопоставленные данные''' отображаются сопоставленные данные по выбранным элементам в левой или/и правой частях. Отображаемые данные сортируются по алфавиту. Данные можно сопоставлять и удалять сопоставление: | ||
− | * Если нужно удалить сопоставление, можно воспользоваться кнопкой '''Удалить''' после нажатия данные станут не сопоставленными и подсвечены красным цветом | + | * Если нужно удалить сопоставление, можно воспользоваться кнопкой '''Удалить''' после нажатия данные станут не сопоставленными и подсвечены красным цветом |
* Если нужно данные сопоставить, то есть два варианта: | * Если нужно данные сопоставить, то есть два варианта: | ||
− | ** Точечное сопоставление - т.е. нужно выбрать не сопоставленное значение (подсвеченное красным цветом) в левой части и аналогичное ему значение в правой части (или то значение, которое должно быть сопоставлено). После того как значения выбраны, станет активной кнопка '''Сопоставить'''. Нажимаем кнопку, данные станут сопоставленными и подсвечены черным цветом | + | ** Точечное сопоставление - т.е. нужно выбрать не сопоставленное значение (подсвеченное красным цветом) в левой части и аналогичное ему значение в правой части (или то значение, которое должно быть сопоставлено). После того как значения выбраны, станет активной кнопка '''Сопоставить'''. Нажимаем кнопку, данные станут сопоставленными и подсвечены черным цветом |
** Автоматическое сопоставление - при нажатии кнопки Автоматическое сопоставление запускается процесс автоматического сопоставления справочников. Для авиаперелетов сопоставляются только следующие справочники: | ** Автоматическое сопоставление - при нажатии кнопки Автоматическое сопоставление запускается процесс автоматического сопоставления справочников. Для авиаперелетов сопоставляются только следующие справочники: | ||
− | *** Страна (по названию) | + | *** Страна (по названию) |
− | *** Город (по названию и стране) | + | *** Город (по названию и стране) |
− | *** Авиакомпания (по коду) | + | *** Авиакомпания (по коду) |
− | *** Тип самолета (по коду) | + | *** Тип самолета (по коду) |
− | *** Аэропорт (по стране и городу) | + | *** Аэропорт (по стране и городу) |
==Работа в системе== | ==Работа в системе== | ||
− | После того, как создан | + | После того, как создан внешний поставщик и данные из внешней системы синхронизированы с данными '''ПК "Мастер-Тур"''', нужно создать тур, в который будут добавлены услуги от внешнего поставщика. Рассмотрим на примере создания тура, в котором содержатся три услуги – Авиаперелет ''туда'' (этот авиаперелет будет подбираться из внешней системы), Отель/круиз, Авиаперелет ''обратно'':<br /> |
===Создание услуг и внесение цены=== | ===Создание услуг и внесение цены=== | ||
'''1.''' Создаем услугу '''Авиаперелет''' от внешнего поставщика: | '''1.''' Создаем услугу '''Авиаперелет''' от внешнего поставщика: | ||
− | * Во вкладке [[Мастер-Тур(15):Программа туров. Внешние системы. Авиа GDS# | + | * Во вкладке [[Мастер-Тур(15):Программа туров. Внешние системы. Авиа GDS#Внешние поставщики|Внешние поставщики]] создаем внешнего поставщика, например ''Nemo4'' и у нас автоматически создается ценовой пакет, который называется ''Nemo4(внешняя система)'', поэтому в экране '''Выбор ценового пакета''' нужно выбрать именно этот ценовой пакет (т.е. услугу, подбираемую у внешнего поставщика, обязательно нужно заводить в ценовом пакете, созданном при создании внешнего поставщика). |
* Затем выбираем тип услуги '''Авиаперелет'''. Страну/город вылета и страну/город прилета выбираем те, которые нас интересуют для подбора перелета. Причем перелет может быть как обычным, так и многоплечевым. При подборе перелета в поиске анализируются точка отправления и точка прибытия. Для нашего примера выберем следующие страны: ''Россия/Москва - Австрия/Вена'' (т.к. нас интересуют такие перелеты, которые будут отправляться из ''Москвы'' и прибывать в ''Вену''). | * Затем выбираем тип услуги '''Авиаперелет'''. Страну/город вылета и страну/город прилета выбираем те, которые нас интересуют для подбора перелета. Причем перелет может быть как обычным, так и многоплечевым. При подборе перелета в поиске анализируются точка отправления и точка прибытия. Для нашего примера выберем следующие страны: ''Россия/Москва - Австрия/Вена'' (т.к. нас интересуют такие перелеты, которые будут отправляться из ''Москвы'' и прибывать в ''Вену''). | ||
− | * Создаем расписание | + | * Создаем расписание – можно указывать любую авиакомпанию, рейс, аэропорт вылета/прилета, тип самолета и т.д. Внимание нужно обратить на время вылета и прилета, т.е. если перелет осуществляется в рамках одного дня, то внешние перелеты будут подбираться не выходя за границы дня (например, если в расписании указать время вылета ''08:00'', прилета ''10:00'', то в поиске будут подбираться рейсы, осуществляющиеся с ''00:00'' по '' 23:59'' часов).<br /> |
− | * Выбираем тариф | + | * Выбираем тариф – ''Экономический класс'' (можно выбрать любой, т.к. на подбор перелетов от внешнего поставщика он никак не влияет). |
− | * Выбираем поставщика | + | * Выбираем поставщика – выбираем именного внешнего поставщика. Он также появляется в '''БД "Партнеры"''' автоматически, при создании внешнего поставщика во вкладке [[Мастер-Тур(15):Программа туров. Внешние системы. Авиа GDS#Внешние поставщики|Внешние поставщики]]. В нашем случае это поставщик ''Nemo4(внешняя система)''.<br /> |
* Затем заводим цену стандартным способом в экране [[Мастер-Тур(15):Внесение цен на услуги#Внесение цен на услуги|'''Цены на услугу''']].<br /> | * Затем заводим цену стандартным способом в экране [[Мастер-Тур(15):Внесение цен на услуги#Внесение цен на услуги|'''Цены на услугу''']].<br /> | ||
Строка 90: | Строка 87: | ||
'''2.''' Создаем услугу '''Отель/круиз''' стандартным способом в экране [[Мастер-Тур(15):Внесение цен на услуги#Внесение цен на услугу Отель/круиз|'''Цены на услугу''']] (можно использовать любой ценовой пакет и поставщика).<br /> | '''2.''' Создаем услугу '''Отель/круиз''' стандартным способом в экране [[Мастер-Тур(15):Внесение цен на услуги#Внесение цен на услугу Отель/круиз|'''Цены на услугу''']] (можно использовать любой ценовой пакет и поставщика).<br /> | ||
− | '''3.''' Создаем услугу '''Авиаперелет''' | + | '''3.''' Создаем услугу '''Авиаперелет''' и вносим цену стандартным способом (можно использовать любой ценовой пакет и поставщика). <br /> |
===Создание тура и внесение услуг в его состав=== | ===Создание тура и внесение услуг в его состав=== | ||
Строка 96: | Строка 93: | ||
'''4.''' [[Мастер-Тур(15):Программа туров. Создание нового тура#Создание нового тура|Создаем тур стандартным способом]] и вносим в него созданные услуги (из примера, услуги, созданные в п.1, 2, 3).<br /> | '''4.''' [[Мастер-Тур(15):Программа туров. Создание нового тура#Создание нового тура|Создаем тур стандартным способом]] и вносим в него созданные услуги (из примера, услуги, созданные в п.1, 2, 3).<br /> | ||
− | [[Файл:jk_208.png|Пример тура с услугой от | + | [[Файл:jk_208.png|Пример тура с услугой от внешнего поставщика]] |
− | '''5.''' В итоге получаем тур для поиска, в котором '''Авиаперелет''' "туда" будет подбираться от | + | '''5.''' В итоге получаем тур для поиска, в котором '''Авиаперелет''' "туда" будет подбираться от внешнего поставщика (т.е. в подобранном перелете страна/город отправления и конечная страна/город прибытия будут соответствовать стране/городу отправления и конечной стране/городу прибытия, заведенным в услуге '''Авиаперелет''' от внешнего поставщика. Все остальные параметры услуги могут отличаться).<br /> |
[[Файл: mb_030.png|left|Предупреждение]] <BR> | [[Файл: mb_030.png|left|Предупреждение]] <BR> | ||
Строка 116: | Строка 113: | ||
[[Файл:ep_228.png|Пример тура в поиске]] | [[Файл:ep_228.png|Пример тура в поиске]] | ||
− | При добавлении услуг в состав тура, ценовой пакет (с пометкой | + | При добавлении услуг в состав тура, ценовой пакет (с пометкой ''внешняя система'') и внешний поставщик для выбора появятся только если есть заведенная цена. |
===Добавление услуги Авиаперелет в уже созданный тур=== | ===Добавление услуги Авиаперелет в уже созданный тур=== |
Версия 13:36, 31 октября 2019
Версия статьи от 31-10-2019.
Поддерживаемые версии ПК «Мастер-Тур»: |
Содержание
Введение
На страницу Внешние системы можно попасть из меню турпрограмм (ссылка на страницу http://ip-адрес сервера/TourPrograms/ExternalSystems
). Также на страницу Внешние системы можно попасть с любой страницы, перейдя в Меню → Внешние системы.
Работа в экране «Внешние системы»
Страница Внешние системы представлена двумя вкладками:
- Внешние поставщики – где происходит создание и редактирование пользователей системы;
- Синхронизация – где осуществляется работа по сопоставлению данных из внешней системы.
Внешние поставщики
На вкладке Внешние поставщики представлен список поставщиков. Для каждого поставщика указан:
- Название
- Адаптер
- Адрес API
- Срок действия лицензии
Любого поставщика можно отредактировать, выбрав по названию. Также можно добавить нового, нажав кнопку Добавить.
Список полей для заполнения ( * – обязательное):
- Адаптер * – выбирается из списка
- Название * – название поставщика
- API адрес * – должен быть представлен в виде http(s)://domain(.ru)(:9999)(/something)
- Авторизационный токен * – ключ доступа к серверу, по которому будет происходить подключение к внешнему поставщику
- ID клиента * – id поставщика во внешней системе (предоставляется вместе с авторизационным токеном)
- ID агентства – id агентства во внешней системе (предоставляется вместе с авторизационным токеном)
Подключение к API адресу внешнего поставщика можно проверить по нажатию на кнопку Проверить подключение. Система производит пробное подключение к API и проверяет его доступность.
При сохранении внешнего поставщика в БД автоматически создается ценовой пакет и поставщик с названием, которое было введено при создании поставщика, в скобках указывается (внешняя система). Это необходимо для того, чтобы была возможность внести стоимость услуги, по которой будет работать поиск (при условии, что разрешается только бронирование услуги из внешней системы).
В случае, если внешний поставщик внесен для услуги Авиаперелет, то поставщику автоматически ставится признак Авиаперевозчик.
Синхронизация
Для работы с внешними системами в папку \\TourPrograms\bin нужно добавить файл nemo_guide_etalon.s3db. Также файл nemo_guide_etalon.s3db нужно добавить в папку \\TourSearchOwin.
Синхронизация служит для сопоставления справочных данных из внешней системы со справочными данными, указанными в ПК Мастер-Тур. Для того, чтобы начать работу, нужно выбрать необходимые данные:
- В списке Поставщик выбираем интересующего поставщика (в списке отображаются названия поставщиков, созданные на вкладке внешние поставщики)
- В списке Справочник выбираем необходимый справочник
Слева отображаются справочные данные внешней системы. Справа отображаются справочные данные из ПК Мастер-Тур.
Данные, которые сопоставлены - подсвечены черным цветом. Не сопоставленные данные подсвечены красным цветом. Существует возможность фильтрации справочных данных по статусу (Сопоставлен или Не сопоставлен) и поиска по названию.
В блоке Сопоставленные данные отображаются сопоставленные данные по выбранным элементам в левой или/и правой частях. Отображаемые данные сортируются по алфавиту. Данные можно сопоставлять и удалять сопоставление:
- Если нужно удалить сопоставление, можно воспользоваться кнопкой Удалить после нажатия данные станут не сопоставленными и подсвечены красным цветом
- Если нужно данные сопоставить, то есть два варианта:
- Точечное сопоставление - т.е. нужно выбрать не сопоставленное значение (подсвеченное красным цветом) в левой части и аналогичное ему значение в правой части (или то значение, которое должно быть сопоставлено). После того как значения выбраны, станет активной кнопка Сопоставить. Нажимаем кнопку, данные станут сопоставленными и подсвечены черным цветом
- Автоматическое сопоставление - при нажатии кнопки Автоматическое сопоставление запускается процесс автоматического сопоставления справочников. Для авиаперелетов сопоставляются только следующие справочники:
- Страна (по названию)
- Город (по названию и стране)
- Авиакомпания (по коду)
- Тип самолета (по коду)
- Аэропорт (по стране и городу)
Работа в системе
После того, как создан внешний поставщик и данные из внешней системы синхронизированы с данными ПК "Мастер-Тур", нужно создать тур, в который будут добавлены услуги от внешнего поставщика. Рассмотрим на примере создания тура, в котором содержатся три услуги – Авиаперелет туда (этот авиаперелет будет подбираться из внешней системы), Отель/круиз, Авиаперелет обратно:
Создание услуг и внесение цены
1. Создаем услугу Авиаперелет от внешнего поставщика:
- Во вкладке Внешние поставщики создаем внешнего поставщика, например Nemo4 и у нас автоматически создается ценовой пакет, который называется Nemo4(внешняя система), поэтому в экране Выбор ценового пакета нужно выбрать именно этот ценовой пакет (т.е. услугу, подбираемую у внешнего поставщика, обязательно нужно заводить в ценовом пакете, созданном при создании внешнего поставщика).
- Затем выбираем тип услуги Авиаперелет. Страну/город вылета и страну/город прилета выбираем те, которые нас интересуют для подбора перелета. Причем перелет может быть как обычным, так и многоплечевым. При подборе перелета в поиске анализируются точка отправления и точка прибытия. Для нашего примера выберем следующие страны: Россия/Москва - Австрия/Вена (т.к. нас интересуют такие перелеты, которые будут отправляться из Москвы и прибывать в Вену).
- Создаем расписание – можно указывать любую авиакомпанию, рейс, аэропорт вылета/прилета, тип самолета и т.д. Внимание нужно обратить на время вылета и прилета, т.е. если перелет осуществляется в рамках одного дня, то внешние перелеты будут подбираться не выходя за границы дня (например, если в расписании указать время вылета 08:00, прилета 10:00, то в поиске будут подбираться рейсы, осуществляющиеся с 00:00 по 23:59 часов).
- Выбираем тариф – Экономический класс (можно выбрать любой, т.к. на подбор перелетов от внешнего поставщика он никак не влияет).
- Выбираем поставщика – выбираем именного внешнего поставщика. Он также появляется в БД "Партнеры" автоматически, при создании внешнего поставщика во вкладке Внешние поставщики. В нашем случае это поставщик Nemo4(внешняя система).
- Затем заводим цену стандартным способом в экране Цены на услугу.
2. Создаем услугу Отель/круиз стандартным способом в экране Цены на услугу (можно использовать любой ценовой пакет и поставщика).
3. Создаем услугу Авиаперелет и вносим цену стандартным способом (можно использовать любой ценовой пакет и поставщика).
Создание тура и внесение услуг в его состав
4. Создаем тур стандартным способом и вносим в него созданные услуги (из примера, услуги, созданные в п.1, 2, 3).
5. В итоге получаем тур для поиска, в котором Авиаперелет "туда" будет подбираться от внешнего поставщика (т.е. в подобранном перелете страна/город отправления и конечная страна/город прибытия будут соответствовать стране/городу отправления и конечной стране/городу прибытия, заведенным в услуге Авиаперелет от внешнего поставщика. Все остальные параметры услуги могут отличаться).
Обратите внимание, что при тестировании функционала нельзя вводить фейковые данные как в тестовых, так и в реальных бронях. За это авиакомпании и GDS назначают штрафы. Обратите внимание, что штрафы назначаются даже если бронирование с фейковыми данными делается на тестовом доступе. Фейковыми данными являются ФИО следующих типов: «test test» «А А» (из одной или двух букв) «1 1» (ФИО цифрами, или в ФИО будет цифра) «АААА1 АААА1» «ААА ВВВ»
При добавлении услуг в состав тура, ценовой пакет (с пометкой внешняя система) и внешний поставщик для выбора появятся только если есть заведенная цена.
Добавление услуги Авиаперелет в уже созданный тур
Возможен вариант добавление услуги Авиаперелет, заведенной от внешнего поставщика, в тур, где уже есть обычная услуга Авиаперелет. В таком случае перелет от внешнего поставщика нужно добавить в новую группу перелетов.
Настройка логирования
Для получения данных о работе внешнего поставщика используется логирование, настройки которого осуществляются в файле Megatec.TourSearchOwin.exe.config папки TourSearchOwin. Путь к папке лог-файлов прописывается в секции Loggers path. Включение логирования осуществляется в секции Logger level. Возможные значения: ALL или OFF.
№ | Название | Описание | Настройка |
---|---|---|---|
1 | Логирование | Разные настройки логирования отвечают за получение разной информации:
|
<Loggers path="Logs\">
<Logger level="ALL" name="GetFlightsRequestResponseLogger"/>
<Logger level="ALL" name="ActualizeFlightsRequestResponseLogger"/>
<Logger level="ALL" name="CreateFlightsReservationRequestResponseLogger"/>
<Logger level="ALL" name="GetFlightsDetailsLogger"/>
</Loggers>
|