Corteos — различия между версиями
(→Общая настройка) |
(→Автоматическая загрузка профилей из МОМ в Corteos) |
||
(не показаны 14 промежуточных версий 1 участника) | |||
Строка 39: | Строка 39: | ||
|} | |} | ||
<br/> | <br/> | ||
− | |||
=== Настройка профиля корпоративного клиента=== | === Настройка профиля корпоративного клиента=== | ||
Строка 45: | Строка 44: | ||
Для синхронизации данных необходимо заполнить вкладку с данными организации-клиента. Т.е. нужно открыть профиль корпоративного клиента и перейти в панель "Синхронизация в Corteos" | Для синхронизации данных необходимо заполнить вкладку с данными организации-клиента. Т.е. нужно открыть профиль корпоративного клиента и перейти в панель "Синхронизация в Corteos" | ||
</p> | </p> | ||
− | [[Image: Corteos_settings_in_profile.png|center| | + | [[Image: Corteos_settings_in_profile.png|center|580px]] |
− | + | ||
− | + | ||
− | Значение поля «Номер клиентского договора» находится в Corteos на списке договоров: | + | Значение поля '''«Id в Corteos»''' находится в Corteos на списке организаций: |
+ | [[Image: Corteos_id2.png|center|780px]] | ||
+ | |||
+ | Значение поля '''«Номер клиентского договора»''' находится в Corteos на списке договоров: | ||
[[Image: Corteos_contract_id.png|center|780px]] | [[Image: Corteos_contract_id.png|center|780px]] | ||
− | Значение поля «Номер группы компаний» находится в Corteos в договоре в поле «Идентификатор группы компаний клиента для API»: | + | Значение поля '''«Номер группы компаний»''' находится в Corteos в договоре в поле «Идентификатор группы компаний клиента для API»: |
[[Image: Corteos_compane_number.png|center|780px]] | [[Image: Corteos_compane_number.png|center|780px]] | ||
<p style="text-align:justify;"> | <p style="text-align:justify;"> | ||
− | Раздел «Синхронизация путешественников» включает синхронизацию UDIDs (структурных кодов) в 2 и/или 3 версию Corteos. | + | Раздел '''«Синхронизация путешественников»''' включает синхронизацию UDIDs (структурных кодов) в 2 и/или 3 версию Corteos. |
− | Раздел «Загрузка заказов» влияет на то, из какой версии Corteos будут грузиться заказы в МОМ (только для кнопки «Создать/Заказ Corteos»). | + | Раздел '''«Загрузка заказов»''' влияет на то, из какой версии Corteos будут грузиться заказы в МОМ (только для кнопки «Создать/Заказ Corteos»). |
</p> | </p> | ||
+ | |||
+ | ==Синхронизация профилей путешественников== | ||
+ | ===Первоначальная однократная загрузка профилей из Corteos в МОМ=== | ||
+ | <p style="text-align:justify;"> | ||
+ | Загрузка профилей осуществляется с помощью задачи "Загрузка путешественников из Corteos". Эта задача хорошо подходит для связи профилей в самом начале интеграции Corteos и МОМ, т.е. у агентства уже есть структура профилей в Corteos, а в МОМ пока профилей путешественников нет. В таком случае агентству необходимо создать профили организаций и внести в них настройки синхронизации с Corteos, а потом воспользоваться данной задачей. | ||
+ | <br/> | ||
+ | <br/> | ||
+ | При её запуске можно указать, для каких именно организаций выгружать путешественников (по умолчанию выгружаются для всех имеющихся в МОМ организаций с настройками синхронизации с Corteos) и режим работы задачи (всех ли путешественников выгружать). | ||
+ | <br/> | ||
+ | <br/> | ||
+ | Задача выгружает все профили для выбранных (или всех) организаций. В случае, если профиль был синхронизирован с Corteos ранее, не делается ничего. В случае, если похожий профиль найден в МОМ, она его обновляет. В случае, если профиль не найден в МОМ - создается новый с нуля. | ||
+ | <br/> | ||
+ | <br/> | ||
+ | Подробные результаты работы задачи сохраняются в текстовом файле в папке logs\corteos. | ||
+ | <br/> | ||
+ | <br/> | ||
+ | Для запуска задачи нужно зайти в "Меню", нажать кнопку "Задачи" и на списке с помощью кнопки "+" добавить задачу "Загрузка путешественников из Corteos". В открывшемся диалоговом окне указать параметры запускаемой задачи. | ||
+ | </p> | ||
+ | [[Image: Corteos_synch_task.png|center|780px]] | ||
+ | <p style="text-align:justify;"> | ||
+ | Если оставить пустым поле '''"Дата и время запуска"''', то задача начнет выполняться немедленно по сохранении. | ||
+ | <br/> | ||
+ | Поле '''"Нода"''' стоит оставить пустым, если МОМ работает на одном сервере. | ||
+ | В секции "Параметры задачи" как было упомянуто выше, можно добавить два параметра" | ||
+ | <br/> | ||
+ | '''"Только работников следующих организаций"''' - где можно указать, сотрудники каких конкретно организаций должны быть синхронизированы. Для выбора доступны только те компании, в профили которых внесены настройки синхронизации. | ||
+ | <br/> | ||
+ | '''"Режим работы задачи"''' - определяет, как именно профили путешественников будут синхронизированы. | ||
+ | <br/> | ||
+ | <br/> | ||
+ | ''"Все профили"'' - будут обновлены все профили, будут ли они новыми для МОМ, профилями, где есть ключевые различия с данными Corteos или полностью совпадающими. Сравнение профилей идет по полям ФИО на русском и английском, дате рождения, гражданству и номерам паспортов. | ||
+ | <br/> | ||
+ | ''"Только новые и профили без отличий"'' - будут добавлены новые профили и в профили, где все данные совпадают с Corteos будут прописаны ID профилей в Corteos и не основные поля. | ||
+ | <br/> | ||
+ | ''"Только новые профили"'' - будут добавлены только новые профили. | ||
+ | <br/> | ||
+ | ''"Только результаты"'' - обновление профилей проводиться не будет, будет заполнен лог, какие действия были бы выполнены при выборе варианта "Все профили". | ||
+ | </p> | ||
+ | |||
+ | ===Автоматическая загрузка профилей из Corteos в МОМ=== | ||
+ | <p style="text-align:justify;"> | ||
+ | Для получения всех изменений, произведенных на стороне Corteos, нужно настроить функцию callback от Corteos 3. | ||
+ | Если настроить отправку callback по статике (а в терминологии Corteos к статике относятся в том числе профили) в настройках Corteos (см. скриншот), и указать там url http://ваш ip: ваш port/corteos/corteos, где "ip:port" - адрес сервера МОМ, то при изменении персон в Corteos будет отправляться post запрос в MOM, который будет обновлять соответствующий профиль путешественника. В поле body настройки должно быть указано следующее: | ||
+ | </p> | ||
+ | <pre> | ||
+ | <Change> | ||
+ | <Before> | ||
+ | @Before | ||
+ | </Before> | ||
+ | <After> | ||
+ | @After | ||
+ | </After> | ||
+ | </Change> | ||
+ | </pre> | ||
+ | |||
+ | [[Image: Corteos_calback.png|center|780px]] | ||
+ | |||
+ | ===Автоматическая загрузка профилей из МОМ в Corteos=== | ||
+ | <p style="text-align:justify;"> | ||
+ | Автоматическая загрузка профилей предназначена для синхронизации данных при постоянной работе с ними в МОМ, чтобы все изменения на стороне МОМ автоматически попадали в Corteos. | ||
+ | <br/> | ||
+ | Включается такая синхронизация с помощью задач планировщика "Автоматическая синхронизация профилей в Corteos". Для включения нужно зайти в '''"Меню"''', нажать кнопку '''"Параметры"''', развернуть панель '''"Задачи планировщика"''', выбрать в списке (или добавить, если в списке она отсутствует) задачу '''"Автоматическая синхронизация профилей в Corteos"''' и в поле '''"Активна"''' выбрать значение '''"Да"''': | ||
+ | </p> | ||
+ | [[Image: Corteos_auto_task.png|center|780px]] | ||
+ | |||
+ | ===Ручная загрузка профилей из МОМ в Corteos и обратно=== | ||
+ | <p style="text-align:justify;"> | ||
+ | Cинхронизация путешественников выполняется с помощью кнопок "Синхронизировать в Corteos" для профилей, которые создавались в МОМ и в Corteos их пока нет и "Обновить из Corteos". Обе кнопки доступны как в профиле путешественника, так и на списке путешественников. | ||
+ | <br/> | ||
+ | <br/> | ||
+ | Также для загрузки нового путешественника из Corteos в МОМ в ручном режиме можно воспользоваться кнопкой "Путешественник Corteos", для чего нажать кнопку "Создать" и зайти в раздел "Профили". В появившемся диалоговом окне нужно указать организацию, чей это сотрудник, а также ID профиля в Corteos: | ||
+ | </p> | ||
+ | [[Image: Corteos_pax.png|center|580px]] | ||
+ | {{warn|При синхронизации UDIDs в путешественниках и продуктах имя структурного кода в Corteos будет сравниваться с именем категории udid в организации в МОМ.}} | ||
+ | |||
+ | |||
+ | ==Синхронизация заказов== | ||
+ | ===Автоматическое обновление заказов из Corteos в МОМ (Corteos 3)=== | ||
+ | <p style="text-align:justify;"> | ||
+ | Чтобы при смене статуса заказа в Corteus 3 данные автоматически передавались в МОМ, необходимо сделать дополнительные настройки на стороне Corteos. | ||
+ | <br/> | ||
+ | Для этого в Corteos нужно включить Callback по заказам и указать адрес | ||
+ | </p> | ||
+ | <pre>http://ip:port/corteos/corteos</pre> | ||
+ | где '''ip:port''' - адрес сервера МОМ. В поле '''"Body"''' нужно указать следующее: | ||
+ | |||
+ | <pre> | ||
+ | <Order> | ||
+ | <id_ComplexReserve>@id_ComplexReserve</id_ComplexReserve> | ||
+ | <id_Reserve>@id_Reserve</id_Reserve> | ||
+ | <EventType>@EventType</EventType> | ||
+ | <ReserveState>@ReserveState</ReserveState> | ||
+ | <ComplexState>@ComplexState</ComplexState> | ||
+ | <EventDescription>@EventDescription</EventDescription> | ||
+ | <CallbackId>@CallbackId</CallbackId> | ||
+ | </Order> | ||
+ | </pre> | ||
+ | |||
+ | Пример настройки: | ||
+ | [[Image: Corteus_order_callback.png|center|380px]] | ||
+ | |||
+ | ===Автоматическое обновление заказов из Corteos в МОМ (Corteos 2)=== | ||
+ | <p style="text-align:justify;"> | ||
+ | Аналогично настройкам для 3 версии Corteos, можно настроить получение данных в МОМ из Corteos 2 при смене статуса заказа. | ||
+ | <br/> | ||
+ | Для этого в Corteos 2 нужно включить Callback по заказам и указать адрес | ||
+ | </p> | ||
+ | <pre>http://ip:port/corteos/corteos</pre> | ||
+ | где '''"ip:port"''' - адрес сервера МОМ. В поле '''"Body"''' нужно указать следующее: | ||
+ | <pre> | ||
+ | <OrderV2> | ||
+ | <id_ComplexReserve>@id_ComplexReserve</id_ComplexReserve> | ||
+ | <id_Reserve>@id_Reserve</id_Reserve> | ||
+ | <EventType>@EventType</EventType> | ||
+ | <EventDescription>@EventDescription</EventDescription> | ||
+ | </OrderV2> | ||
+ | </pre> | ||
+ | |||
+ | Пример настройки: | ||
+ | [[Image: Corteus_order_callback_2ver.png|center|780px]] | ||
+ | |||
+ | ===Ручное обновление заказов из Corteos в МОМ=== | ||
+ | Обновить данные в МОМ из командировок Corteos можно вручную, для чего нужно нажать кнопку "Создать", выбрать раздел "Заказы и услуги" и воспользоваться кнопкой "Заказ Corteos", где в диалоговом окне указать номер командировки. | ||
+ | |||
+ | [[Image: Corteus_order.png|center|380px]] | ||
+ | |||
+ | ===«Привязка» бронирования к заказу в Corteos 2=== | ||
+ | |||
+ | Если бронирование было создано в Corteos 2 только для согласования, а выписывалась билеты в GDS c другим номером бронирования (PNR), то можно привязать это бронирование к заказу в Corteos кнопкой "Привязать продукты к Corteos" справа на зеленой панели. | ||
+ | В диалоговом окне для этого нужно выбрать продукты для привязки к заказу Corteos и ввести номер заказа (''не командировки''): | ||
+ | [[Image: Corteos_order_connection.png|center|380px]] |
Текущая версия на 14:32, 25 июня 2021
Содержание |
[править] Введение
Для поддержания актуальности профилей путешественников как на стороне Mid Office Manager, так и на стороне Corteos, а также получения данных всех продаж в МОМ реализован функционал синхронизации данных между этими двумя системами.
Поскольку сейчас актуальны две версии Corteos – вторая и третья, и может быть, что часть клиентов агентства работает еще на второй версии, а часть уже переведена на третью, ниже будут отдельно указаны настройки для каждой из версий и помимо общей настройки, частично эти настройки (как раз касающиеся версии Corteos) будут указаны именно в профиле клиента.
[править] Настройки подключения
[править] Общая настройка
Функционал синхронизации с Corteos настраивается в системном свойстве «Настройки Corteos»:
Для внесения изменений в системном свойстве нужно нажать кнопку «Меню», выбрать раздел «параметры» и развернуть панель «Системные свойства». Если в списке системных свойств данное свойство отсутствует, добавьте его с помощью кнопки «+».
Описание полей системного свойства:
Наименование поля | Описание |
---|---|
Название | Название самого системного свойства |
Синхронизация включена | Общая активация синхронизации с Corteos. Включение синхронизации в этой настройке также влияет на отображение связанных с Corteos кнопок, элементов в редакторе профилей и справочников. |
Логин | Параметр учетных данных для подключения к Corteos |
Пароль | Параметр учетных данных для подключения к Corteos |
Адрес сервера | Адрес для подключения к актуальной (третьей) версии Corteos |
Адрес сервера (Corteos 2) | Адрес ко второй версии Corteos для загрузки заказов, если кто-то из клиентов не перешёл на новую версию |
Настройки GDS | Секция предназначена для настройки параметров, которые будут выставлены в загруженных из Corteos продуктах, т.е. в зависимости от системы бронирования будут прописываться в заказ МОМ параметры валидатора |
Настройки отельных поставщиков | Секция предназначена для настройки параметров, которые будут выставлены в загруженных из Corteos продуктах |
[править] Настройка профиля корпоративного клиента
Для синхронизации данных необходимо заполнить вкладку с данными организации-клиента. Т.е. нужно открыть профиль корпоративного клиента и перейти в панель "Синхронизация в Corteos"
Значение поля «Id в Corteos» находится в Corteos на списке организаций:
Значение поля «Номер клиентского договора» находится в Corteos на списке договоров:
Значение поля «Номер группы компаний» находится в Corteos в договоре в поле «Идентификатор группы компаний клиента для API»:
Раздел «Синхронизация путешественников» включает синхронизацию UDIDs (структурных кодов) в 2 и/или 3 версию Corteos. Раздел «Загрузка заказов» влияет на то, из какой версии Corteos будут грузиться заказы в МОМ (только для кнопки «Создать/Заказ Corteos»).
[править] Синхронизация профилей путешественников
[править] Первоначальная однократная загрузка профилей из Corteos в МОМ
Загрузка профилей осуществляется с помощью задачи "Загрузка путешественников из Corteos". Эта задача хорошо подходит для связи профилей в самом начале интеграции Corteos и МОМ, т.е. у агентства уже есть структура профилей в Corteos, а в МОМ пока профилей путешественников нет. В таком случае агентству необходимо создать профили организаций и внести в них настройки синхронизации с Corteos, а потом воспользоваться данной задачей.
При её запуске можно указать, для каких именно организаций выгружать путешественников (по умолчанию выгружаются для всех имеющихся в МОМ организаций с настройками синхронизации с Corteos) и режим работы задачи (всех ли путешественников выгружать).
Задача выгружает все профили для выбранных (или всех) организаций. В случае, если профиль был синхронизирован с Corteos ранее, не делается ничего. В случае, если похожий профиль найден в МОМ, она его обновляет. В случае, если профиль не найден в МОМ - создается новый с нуля.
Подробные результаты работы задачи сохраняются в текстовом файле в папке logs\corteos.
Для запуска задачи нужно зайти в "Меню", нажать кнопку "Задачи" и на списке с помощью кнопки "+" добавить задачу "Загрузка путешественников из Corteos". В открывшемся диалоговом окне указать параметры запускаемой задачи.
Если оставить пустым поле "Дата и время запуска", то задача начнет выполняться немедленно по сохранении.
Поле "Нода" стоит оставить пустым, если МОМ работает на одном сервере.
В секции "Параметры задачи" как было упомянуто выше, можно добавить два параметра"
"Только работников следующих организаций" - где можно указать, сотрудники каких конкретно организаций должны быть синхронизированы. Для выбора доступны только те компании, в профили которых внесены настройки синхронизации.
"Режим работы задачи" - определяет, как именно профили путешественников будут синхронизированы.
"Все профили" - будут обновлены все профили, будут ли они новыми для МОМ, профилями, где есть ключевые различия с данными Corteos или полностью совпадающими. Сравнение профилей идет по полям ФИО на русском и английском, дате рождения, гражданству и номерам паспортов.
"Только новые и профили без отличий" - будут добавлены новые профили и в профили, где все данные совпадают с Corteos будут прописаны ID профилей в Corteos и не основные поля.
"Только новые профили" - будут добавлены только новые профили.
"Только результаты" - обновление профилей проводиться не будет, будет заполнен лог, какие действия были бы выполнены при выборе варианта "Все профили".
[править] Автоматическая загрузка профилей из Corteos в МОМ
Для получения всех изменений, произведенных на стороне Corteos, нужно настроить функцию callback от Corteos 3. Если настроить отправку callback по статике (а в терминологии Corteos к статике относятся в том числе профили) в настройках Corteos (см. скриншот), и указать там url http://ваш ip: ваш port/corteos/corteos, где "ip:port" - адрес сервера МОМ, то при изменении персон в Corteos будет отправляться post запрос в MOM, который будет обновлять соответствующий профиль путешественника. В поле body настройки должно быть указано следующее:
<Change> <Before> @Before </Before> <After> @After </After> </Change>
[править] Автоматическая загрузка профилей из МОМ в Corteos
Автоматическая загрузка профилей предназначена для синхронизации данных при постоянной работе с ними в МОМ, чтобы все изменения на стороне МОМ автоматически попадали в Corteos.
Включается такая синхронизация с помощью задач планировщика "Автоматическая синхронизация профилей в Corteos". Для включения нужно зайти в "Меню", нажать кнопку "Параметры", развернуть панель "Задачи планировщика", выбрать в списке (или добавить, если в списке она отсутствует) задачу "Автоматическая синхронизация профилей в Corteos" и в поле "Активна" выбрать значение "Да":
[править] Ручная загрузка профилей из МОМ в Corteos и обратно
Cинхронизация путешественников выполняется с помощью кнопок "Синхронизировать в Corteos" для профилей, которые создавались в МОМ и в Corteos их пока нет и "Обновить из Corteos". Обе кнопки доступны как в профиле путешественника, так и на списке путешественников.
Также для загрузки нового путешественника из Corteos в МОМ в ручном режиме можно воспользоваться кнопкой "Путешественник Corteos", для чего нажать кнопку "Создать" и зайти в раздел "Профили". В появившемся диалоговом окне нужно указать организацию, чей это сотрудник, а также ID профиля в Corteos:
При синхронизации UDIDs в путешественниках и продуктах имя структурного кода в Corteos будет сравниваться с именем категории udid в организации в МОМ. |
[править] Синхронизация заказов
[править] Автоматическое обновление заказов из Corteos в МОМ (Corteos 3)
Чтобы при смене статуса заказа в Corteus 3 данные автоматически передавались в МОМ, необходимо сделать дополнительные настройки на стороне Corteos.
Для этого в Corteos нужно включить Callback по заказам и указать адрес
http://ip:port/corteos/corteos
где ip:port - адрес сервера МОМ. В поле "Body" нужно указать следующее:
<Order> <id_ComplexReserve>@id_ComplexReserve</id_ComplexReserve> <id_Reserve>@id_Reserve</id_Reserve> <EventType>@EventType</EventType> <ReserveState>@ReserveState</ReserveState> <ComplexState>@ComplexState</ComplexState> <EventDescription>@EventDescription</EventDescription> <CallbackId>@CallbackId</CallbackId> </Order>
Пример настройки:
[править] Автоматическое обновление заказов из Corteos в МОМ (Corteos 2)
Аналогично настройкам для 3 версии Corteos, можно настроить получение данных в МОМ из Corteos 2 при смене статуса заказа.
Для этого в Corteos 2 нужно включить Callback по заказам и указать адрес
http://ip:port/corteos/corteos
где "ip:port" - адрес сервера МОМ. В поле "Body" нужно указать следующее:
<OrderV2> <id_ComplexReserve>@id_ComplexReserve</id_ComplexReserve> <id_Reserve>@id_Reserve</id_Reserve> <EventType>@EventType</EventType> <EventDescription>@EventDescription</EventDescription> </OrderV2>
Пример настройки:
[править] Ручное обновление заказов из Corteos в МОМ
Обновить данные в МОМ из командировок Corteos можно вручную, для чего нужно нажать кнопку "Создать", выбрать раздел "Заказы и услуги" и воспользоваться кнопкой "Заказ Corteos", где в диалоговом окне указать номер командировки.
[править] «Привязка» бронирования к заказу в Corteos 2
Если бронирование было создано в Corteos 2 только для согласования, а выписывалась билеты в GDS c другим номером бронирования (PNR), то можно привязать это бронирование к заказу в Corteos кнопкой "Привязать продукты к Corteos" справа на зеленой панели. В диалоговом окне для этого нужно выбрать продукты для привязки к заказу Corteos и ввести номер заказа (не командировки):