Импорт данных из УФС

Стандартный механизм импорта обменных файлов в Mid Office Manager предусматривает копирование этих файлов в специальные «обменные папки» Mid Office Manager, откуда приложение автоматически их загружает и обрабатывает. Но импорт обменных файлов УФС существенно отличается от стандартного механизма импорта в Mid Office Manager из других систем. Во-первых, обменные файлы УФС передаются по протоколу HTTP по заранее согласованному URL-адресу получателя, в качестве которого в данном случае выступает Mid Office Manager. Во-вторых УФС самостоятельно инициирует передачу обменных файлов по указанному адресу, не предоставляя возможность получения файлов «по запросу». То есть после выписки билетов, система УФС автоматически формирует обменный файл и отправляет его по указанному URL-адресу.

Здесь рассказывается, как настроить Mid Office Manager для автоматической загрузки обменных файлов из УФС.

Предварительные условия

Прежде чем настраивать Mid Office Manager для взаимодействия с УФС нужно заключить агентский договор с УФС и получить логин и пароль, которые нужны для доступа к электронной кассе агента на сайте УФС, где выполняется выписка билетов через УФС.

Далее предполагается, что у вас есть логин и пароль, позволяющие получить доступ к своей электронной кассе на сайте УФС.

Если для связи с УФС планируется использовать защищенный протокол (то есть URL-адрес начинается с https://), то вам потребуется действительный сертификат, которому доверяет УФС. В этом случае нужно будет приобрести сертификат, подписанный доверенным центром сертификации, таким как Verisign или Thawte, и использовать его для связи с УФС.

Если же вы решите для связи с УФС использовать обычный протокол, (то есть URL-адрес начинается с http://), то никаких сертификатов не нужно. Это более простой, но менее безопасный вариант.

Далее предполагается, что если используется защищенное соединение, то у вас есть доверенный сертификат для УФС и файл хранилища с этим сертификатом расположен в папке на машине, где установлен сервер Mid Office Manager. Если используется незащищенное соединение, то никаких дополнительных требований относительно сертификата выполнять не требуется.

Настройка партнерской электронной кассы УФС

На электронной кассе партнера УФС нужно задать основной URL-адрес, по которому УФС будет отправлять обменные файлы с выписанными билетами. На снимке экрана показан пример настройки основного URL-адреса (адрес выделен красной рамкой) в варианте с защищенным соединением.

В поле Интеграция с бэкофис должно быть значение по умолчанию — Новый протокол, иначе работоспособность импорта данных не гарантируется.

Конфигурирование Mid Office Manager

Поскольку обменные файлы из УФС поступают по протоколу HTTP на URL-адрес агентства, в Mid Office Manager нужно настроить службу, способную принимать такие файлы по этому механизму. Далее приводятся соответствующие инструкции по конфигурированию Mid Office Manager.

Чтобы настроить автоматический импорт обменных файлов УФС:

1. В подпапке ..\server\config\xtrip\server папки сервера Mid Office Manager откройте файл boot.properties в текстовом редакторе.
2. Найдите следующие строки:

   #com.gridnine.xtrip.server.tomcat.ufs.port = 8443
   #com.gridnine.xtrip.server.tomcat.ufs.protocol = org.apache.coyote.http11.Http11Protocol
   #com.gridnine.xtrip.server.tomcat.ufs.proxyName =
   #com.gridnine.xtrip.server.tomcat.ufs.proxyPort =
   #com.gridnine.xtrip.server.tomcat.ufs.secure = true
   #com.gridnine.xtrip.server.tomcat.ufs.scheme = https
   #com.gridnine.xtrip.server.tomcat.ufs.URIEncoding = utf-8
   #com.gridnine.xtrip.server.tomcat.ufs.SSLEnabled = true
   #com.gridnine.xtrip.server.tomcat.ufs.sslProtocol = TLS
   #com.gridnine.xtrip.server.tomcat.ufs.clientAuth = false
   #com.gridnine.xtrip.server.tomcat.ufs.keystoreFile = C://keystore.key
   #com.gridnine.xtrip.server.tomcat.ufs.keystorePass = 123456
   #com.gridnine.xtrip.server.tomcat.ufs.keyPass = 123456
   #com.gridnine.xtrip.server.tomcat.ufs.default = false 

3. Удалите знак комментария «решетка» (#) во всех строках.
4. Выполните одну из следующих операций:
   • Если используется защищенное соединение:
     1. В строке с параметром com.gridnine.xtrip.server.tomcat.ufs.keystoreFile и укажите путь к файлу хранилища с доверенным сертификатом, например если ваш файл называется certstore.key и его путь D:\certificates, то этот параметр надо задать так:

        com.gridnine.xtrip.server.tomcat.ufs.keystoreFile = D:\certificates\certstore.jks

     2. В параметре com.gridnine.xtrip.server.tomcat.ufs.keystorePass вместо 123456 задайте пароль хранилища сертификатов, например:

         com.gridnine.xtrip.server.tomcat.ufs.keystorePass = P@ssw0rd1

     3. В параметре com.gridnine.xtrip.server.tomcat.ufs.keyPass вместо 123456 задайте пароль шифрования закрытого ключа сертификата, например:

         com.gridnine.xtrip.server.tomcat.ufs.keyPass = P@ssw0rd2

   • Если используется незащищенное соединение, настройте параметры, как показано ниже:

     com.gridnine.xtrip.server.tomcat.ufs.port = 8443
     com.gridnine.xtrip.server.tomcat.ufs.protocol = org.apache.coyote.http11.Http11Protocol
     com.gridnine.xtrip.server.tomcat.ufs.proxyName =
     com.gridnine.xtrip.server.tomcat.ufs.proxyPort =
     com.gridnine.xtrip.server.tomcat.ufs.secure = false
     com.gridnine.xtrip.server.tomcat.ufs.scheme = http
     com.gridnine.xtrip.server.tomcat.ufs.URIEncoding = utf-8
     com.gridnine.xtrip.server.tomcat.ufs.default = false 

     В начале всех остальных строк добавьте знак комментария «решетка» (#).

5. При необходимости измените порт передачи обменных файлов, например чтобы изменить порт на 8888, в параметре com.gridnine.xtrip.server.tomcat.ufs.port изменить значение на 8888, например:

    com.gridnine.xtrip.server.tomcat.ufs.port = 8888

6. Если вы используете прокси-сервер, в параметрах com.gridnine.xtrip.server.tomcat.ufs.proxyName и com.gridnine.xtrip.server.tomcat.ufs.proxyPort задайте соответственно адрес и порт прокси-сервера.
7. Сохраните и закройте файл boot.properties.
8. Перезагрузите сервер Mid Office Manager.

Ссылки по теме

• Железнодорожные билеты