Изменения

[[Category:Функции]][[Category:Интеграция]]<!-- -->Для интеграции Nemo {{NameSystemLink}} с другими системами имеются инструменты обмена данными.

В архиве собраны все необходимые файлы для установки легкой формы на вашем сайте.<br /> 

<span style="background-color:#fff0f5;"><span style="font-size:large;"><span style="color:#ff0000;">!</span></span> {{Attention|Здесь и далее замените в адресах ссылок DOMAIN на имя вашего домена!}}

*'''typeSearch''' может принимать значения OW или RT (в один конец или туда и обратно);<br> *'''arrDate''' - — через сколько дней вылет;<br> *'''depDate''' - — через сколько дней обратный вылет;<br> *'''outSearch''' - — текст запроса в автокомплит для предзаполнения поля "Вылет"; <br> *'''inSearch''' - — текст запроса в автокомплит для предзаполнения поля "Прилет"; <br>

<span style="background-color:#fff0f5;"><span style="font-size:large;"><span style="color:#ff0000;">!</span></span> {{Attention|Легкая форма работает на сайтах с кодировкой UTF-8.}}

В этом случае, если мини-форма поиска размещается на другом домене, то пользователь при переходе к результатам поиска остается на том же домене. Это позволяет видеть статистику поисковых запросов и созданных бронирований именно с партнерского домена.

1. # Создать компанию-партнер в разделе '''Администрирование''' - '''Пользователи Аккаунт менеджмент → Агенты и группыпользователи → Управление'''. 2. # В настройки этой компании-партнера в разделе '''Администрирование''' - '''Управление сайтом''' - '''→ Домены и протоколы''' указать '''{{Setting|Доменное имя сайта для загрузки настроек''' - }} — доменное имя сайта компании-партнера. Здесь может быть домен второго уровня. А на домене первого уровня - — на основном сайте компании-партнера можно разместить «Легкую форму» поиска. 3. # Также необходимо выполнить [[Привязка к доменному имени агентства|привязку сайта к доменному имени агентства]]. 4. # Стили основного сайта на сайт компании-партнера не распространяются. Их можно прописать отдельно в разделе '''Администрирование''' - '''Управление сайтом → Настройки внешнего вида'''.

'''=== Подпись запроса'''===

Подпись sig сверяется c <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">md5($booking_id.$secret)</syntaxhighlight>, где:* $booking_id — Id заказа в системе {{NameSystem}};* $secret — значение настройки {{Setting|Ключ безопасности для сервиса выставления оплаты и получения XML выгрузки}} в разделе '''Управление сайтом → Домены и протоколы'''.

$booking_id - Id заказа в системе Nemo, $secret - значение настройки в разделе '''«Администрирование»''' ⇨ '''«Настройки агентства»''' ⇨ '''''«Ключ безопасности для сервиса выставления оплаты и получения XML выгрузки»''''' '''=== Пример:'''===

<pre>http://CLIENT_DOMAIN/index.php?go=payment/bill&booking_id=263330&sig=a439a4492131f4b866ed1a17d018d3a6</pre> == FastSearch - — передача параметров в форму ==

В системе Nemo {{NameSystem}} имеется возможность перенаправлять пользователей на страницу с уже заполненными параметрами поиска или сразу напрямую на результаты поиска.

Для использования заполнения формы из URL следует включить опцию: '''Администрирование → Настройки системы → '''{{Setting|Включить FastSearch (передачу параметров поиска)}} в разделе '''Управление сайтом → Домены и протоколы'''.

После этого можно использовать ссылки на форму поиска вида:

'''Имена полей''' - — такие же как имена инпутов на поисковой форме.

== Интеграция со Сторонней системой - — Авторизация==

В Немо {{NameSystem}} существует возможность авторизоваться в системе менеджерам агентства и субагентам, прежде не работавшим в системе, при помощи интеграции со Сторонней системой (СС).

Настраивается данный функционал в разделе: «Администрирование» - «Реквизиты подключения»'''Для техподдержки → Устаревшие настройки → Реквизиты подключения''', где логин и пароль используется для доступа к системе.

== Пример: Интеграция с Eagle Eye - — авторизация ==  '''Процесс авторизации:''' 1. Пользователь на странице авторизации в системе Немо вводит Логин и Пароль, которые отправляются в СС для авторизации.

'''Сценарий успешной Процесс авторизации:'''# Пользователь на странице авторизации в системе {{NameSystem}} вводит Логин и Пароль, которые отправляются в СС для авторизации.

1. '''Сценарий успешной авторизации:'''# Если авторизация пользователя в СС прошла успешно, то идёт проверка, есть ли в базе данных пользователей Немо {{NameSystem}} пользователь с таким ID.# Если такой пользователь существует в базе {{NameSystem}}, то данные о пользователе и агентстве обновляются, исходя из информации, содержащейся в ответе на авторизацию.Обновляется логин и пароль.# Логин пользователя {{NameSystem}} может быть обновлен на актуальный.# Если в {{NameSystem}} отсутствует пользователь с данным ID — то происходит добавление пользователя.

2'''Сценарий неуспешной авторизации:'''# Если авторизация в СС прошла не успешно, то система {{NameSystem}} проверяет, существует ли в СС ID для пользователя с запрашиваемым логином. # Если такой в СС пользователь существует с ID был сохранен, значит данный пользователь выключен в системе СС, пользователю будет отказано в авторизации.# Если в базе НемоСС пользователь с данным ID отсутствует, то данные о пользователе данного пользователя нет в системе СС и агентстве обновляются, исходя из информацииесли шаг 1 был успешным, содержащейся то он авторизуется в ответе на авторизацию.Обновляется логин и пароль{{NameSystem}} как при обычной авторизации {{NameSystem}}.

3. Логин пользователя Немо может быть обновлен на актуальный. 4. Если в Немо отсутствует пользователь с данным ID - то происходит добавление пользователя. '''Сценарий неуспешной авторизации''' 1. Если авторизация в СС прошла не успешно, то система Немо проверяет, существует ли в СС ID для пользователя с запрашиваемым логином. 2. Если в СС пользователь с ID был сохранен, значит данный пользователь выключен в системе СС, пользователю будет отказано в авторизации. 3. Если в СС пользователь с данным ID отсутствует, то данного пользователя нет в системе СС и, если шаг 1 был успешным, то он авторизуется в Немо как при обычной авторизации Немо. <span style="background-color:#fff0f5;"><span style="font-size:large;"><span style="color:#ff0000;">!</span></span> {{Attention|Если в системе пытается авторизоваться субагент агентства, которое ещё не создано в системе, то в регистрации ему будет отказано, т.к. родительское агентство отсутствует.}}

Назначение данного модуля — обеспечение взаимодействия между сторонней программой (например, «САМО-тур») и системой Nemo {{NameSystem}} в части синхронизации списка B2B-пользователей.

'''=== Авторизация'''===

 1. # Система пытается авторизовать пользователя через собственную службу авторизации.<br>2. # В случае неудачи, но присутствия в системе введенного логина, она должна попытаться авторизовать пользователя во внешней службе авторизации («САМО-тур»), при включенном компоненте взаимодействия с «САМО-тур».<br>3. # В случае неудачного опознавания пользователя выводится соответствующее сообщение и процедура может быть повторена путем повторного ввода логина и пароля.

*Компонент взаимодействия выключен.*Компонент взаимодействия включен и провалены обе попытки авторизации (внутренней и внешней).

Для сторонней авторизации пользователей в системе Nemo {{NameSystem}} сторонняя программа должна иметь веб-службу, основанную на WSDL определенного формата. Ссылка на веб-службу прописывается в настройках системы Nemo {{NameSystem}} на странице конфигурации интеграции с внешней системой.

Для импортированных пользователей в Nemo {{NameSystem}} имеется поле '''«Идентификатор внешней системы»''', который отвечает за сопоставление с ID пользователя в сторонней системе. Для менеджеров агентств оно равно номеру партнера (агента) во внешней системе, для пользователей — номеру пользователя в «САМО-туре».

'''=== Пример запросов и ответов на авторизацию:'''===

*login (строка) - — введенный пользователем логин*pass (строка) - — введенный пользователем пароль

*session_id (строка) - — пустое значение*user_id (строка) - — идентификатор менеджера в системе «САМО-тур»*login (строка) - — логин пользователя (для контроля)*status (строка) - — может иметь значения:** oadm - — администратор** omgr - — менеджер** ousr - — пользователь (возвращается всегда это значение)

'''=== Импорт\синхронизация учетных записей'''===

Со стороны внешней системы должно быть приложение, отправляющее в формате XML данные по учетным записям B2B-клиентов (агентств и пользователей). Со стороны Nemo {{NameSystem}} имеется скрипт, который принимает XML в формате, приведенном в описании документов, передаваемых в Nemo {{NameSystem}} с ключом авторизации, определенным в Nemo {{NameSystem}} в административной части модуля.

В административной части модуля в Nemo {{NameSystem}} задается ключ авторизации для защиты от несанкционированного доступа. Значение не должно быть пустым.

<partners> - — список изменений по партнерам

<th>Поле во внешней системе </th><th> Путь к элементу xml </th><th> Тип данных </th><th> Сопоставляемое поле в Nemo {{NameSystem}} </th><th> Примечание </th>

<td>Номер группы в самотуре</td><td>/changes/partners/item/group</td><td>Целое число, либо пусто</td><td>На основании таблицы сопоставлений (см. ниже) определяется, к какой группе агентство принадлежит в Nemo {{NameSystem}} </td><td></td>

Для каждого возвращенного агентства Nemo {{NameSystem}} проверяет наличие его в своей базе. Если [[агентство]] не найдено, то создается новое. Для него создается менеджер (админ) с логином ABCD-1234, где ABCD – буквенный идентификатор партнера во внешней системе, 1234 — id партнера во внешней системе. Пароль — генерируется случайный и криптостойкий.

Если агентство найдено, то в случае необходимости производится обновление всех полей на основании данных из внешней системы. Если изменился код агентства (буквенный), то Nemo {{NameSystem}} переименовывает менеджера в соответствии с новым кодом. При импорте информации о пользователях агентств в Nemo {{NameSystem}} будут посылаться следующие поля:

<th>Поле во внешней системе</th><th>Путь к элементу xml</th><th>Тип данных</th><th>Сопоставляемое поле в Nemo{{NameSystem}}</th><th>Примечание</th>

<td>Администратор</td><td>/changes/accounts/item[@admin]</td><td>0 - — нет, 1 - — да</td><td>Эксперт по бронированию </td><td></td>

Для каждого возвращенного пользователя Nemo {{NameSystem}} проверяет наличие его в своей базе. Если пользователь не найден, то создается новый. Пароль генерируется случайный и криптостойкий.

Если пользователь найден, то в случае необходимости производится обновление всех полей на основании данных из внешней системы. При запросе на удаление пользователя, в Nemo {{NameSystem}} указанный логин удаляться не будет в целях сохранения целостности старых данных, а просто помечается как удаленный, и логин переименовывается и становится вида [логин_пользователя]_X_[числовой идентификатор_пользователя в Само].

'''=== Таблица сопоставлений групп'''===

В административной части Nemo {{NameSystem}} надо создать отдельную страницу, на которой можно сопоставить имеющиеся группы в Nemo {{NameSystem}} номерам групп в САМО-тур (поле group в XML). Выводится список существующих групп для текущего (корневого) агентства.

*[[Пользователь]]<br>*[[Авторизованный пользователь]]<br>*[[Авторизация пользователей из внешних систем]]<br>*[[Пароль]]<br>*[[Агентство]]<br>*[[Веб-сайт]]<br>*[[Passenger Name Record (PNR)]]<br>*[[Бронирование]]<br>*[[Войдирование]] [[Category:Функции]]<br/>[[Category:Интеграция]]