Стандартный механизм импорта обменных файлов в Mid Office Manager предусматривает копирование этих файлов в специальные «обменные папки» Mid Office Manager, откуда приложение автоматически их загружает и обрабатывает. Но импорт обменных файлов УФС существенно отличается от стандартного механизма импорта в Mid Office Manager из других систем. Во-первых, обменные файлы УФС передаются по протоколу HTTP по заранее согласованному URL-адресу получателя, в качестве которого в данном случае выступает Mid Office Manager. Во-вторых УФС самостоятельно инициирует передачу обменных файлов по указанному адресу, не предоставляя возможность получения файлов «по запросу». То есть после выписки билетов, система УФС автоматически формирует обменный файл и отправляет его по указанному URL-адресу.
В этой статье расскажем, как настроить Mid Office Manager для автоматической загрузки обменных файлов из УФС.
Предварительные условия
Прежде чем настраивать Mid Office Manager для взаимодействия с УФС нужно заключить агентский договор с УФС и получить логин и пароль, которые нужны для доступа к электронной кассе агента на сайте УФС, где выполняется выписка билетов через УФС.
Если для связи с УФС планируется использовать защищенный протокол (то есть URL-адрес начинается с https://), то вам потребуется действующий сертификат, которому доверяет УФС. В этом случае нужно будет приобрести сертификат, подписанный доверенным центром сертификации и использовать его для связи с УФС. Место хранения сертификата расположено в папке на машине, где установлен сервер Mid Office Manager.
Если же вы решите для связи с УФС использовать обычный протокол, (то есть URL-адрес начинается с http://), то никаких сертификатов не нужно. Это более простой, но менее безопасный вариант.
Настройка партнерской электронной кассы УФС
На электронной кассе партнера УФС нужно задать основной 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.