From 954ccaccfd76335946f76aa9ede62f26a7b547b2 Mon Sep 17 00:00:00 2001 From: dievdo Date: Wed, 15 May 2019 16:53:53 +0300 Subject: [PATCH] Add information about a new TshTrans project --- .gitignore | 2 + README.md | 117 +- SVKTrans.hta => SVKTrans/SVKTrans.hta | 3182 ++++++++--------- SVKTrans.ini => SVKTrans/SVKTrans.ini | 264 +- SVKTrans.ini.702 => SVKTrans/SVKTrans.ini.702 | 52 +- Socket.dll => SVKTrans/Socket.dll | Bin XBuffer.dll => SVKTrans/XBuffer.dll | Bin restrictions.dat => SVKTrans/restrictions.dat | 28 +- appveyor.yml | 10 +- docs/{ => assets}/images/screen.png | Bin docs/{ => assets}/images/svktrans.png | Bin docs/index.md | 118 +- 12 files changed, 1951 insertions(+), 1822 deletions(-) create mode 100644 .gitignore rename SVKTrans.hta => SVKTrans/SVKTrans.hta (98%) rename SVKTrans.ini => SVKTrans/SVKTrans.ini (98%) rename SVKTrans.ini.702 => SVKTrans/SVKTrans.ini.702 (78%) rename Socket.dll => SVKTrans/Socket.dll (100%) rename XBuffer.dll => SVKTrans/XBuffer.dll (100%) rename restrictions.dat => SVKTrans/restrictions.dat (98%) rename docs/{ => assets}/images/screen.png (100%) rename docs/{ => assets}/images/svktrans.png (100%) diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..a18235f --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +# Something with secrets +*secret*.* diff --git a/README.md b/README.md index 774b97c..8718de8 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,23 @@ -# ![svktrans.png](docs/images/svktrans.png) [SVK Transport](http://diev.github.io/SVK-Transport-hta) +# ![icon] [SVK Transport] -[![Build status](https://ci.appveyor.com/api/projects/status/1mvedcg27p6n7aj0?svg=true)](https://ci.appveyor.com/project/diev/svk-transport-hta) -[![GitHub Release](https://img.shields.io/github/release/diev/SVK-Transport-hta.svg)](https://github.com/diev/SVK-Transport-hta/releases/latest) +[![Build status]][appveyor] +[![GitHub Release]][releases] Прием и отправка платежной XML информации, бинарных информационных и файлов статистики по HTTP протоколу в систему СВК Банка России. -![Рабочее окно приложения](docs/images/screen.png) +![Рабочее окно приложения] + +* [Важные изменения, влияющее на совместимость] +* [Основные возможности программы] +* [Замечания к использованию] +* [Дополнительная информация на сайте Банка России] +* [История версий] +* [Идеи и пожелания, ошибки] +* [3rd party software] +* [Лицензионное соглашение] + +----- Данное HTA-приложение осуществляет прием и отправку платежной XML информации, бинарных информационных и файлов статистики по HTTP протоколу. @@ -14,11 +25,15 @@ Файловый адаптер СВК и др.) выглядит крошечной и шустрой утилитой, тем не менее обладающей достаточно развитым функционалом. +*Примечание: +С момента запуска Единого централизованного платежного шлюза (транспортный +шлюз - ТШ, ТШ КБР) функции платежного обмена с Банком России отделились.* + Смотрите также проекты: -* [PTK-PSD Browser](http://diev.github.io/PTK-PSD-Browser-hta) - -для просмотра информационных посылок ПТК ПСД Банка России и -* [UFEBS Viewer](http://diev.github.io/UFEBS-Viewer-hta) - -для просмотра файлов УФЭБС. + +* [TSH Transport] - отдельный транспортный агент для работы с ТШ Банка России; +* [PTK-PSD Browser] - для просмотра информационных посылок ПТК ПСД Банка России; +* [UFEBS Viewer] - для просмотра файлов УФЭБС. ## Важные изменения, влияющее на совместимость @@ -41,16 +56,14 @@ web-аутентификацией. ## Замечания к использованию -* Распаковать дистрибутивный `zip` из -[Releases](https://github.com/diev/SVK-Transport/releases) в отдельную папку. +* Распаковать дистрибутивный `zip` из [Releases] в отдельную папку. * Программа из соображений защиты IE работает только с локального диска! * До первого запуска программы внимательно изучите и отредактируйте исходный `SVKTrans.ini` или возьмите за основу `SVKTrans.ini.702` для Северо-Западного ГУ ЦБ. * Для отправки информационных сообщений требуется MSXML версии 4.0 или выше. Программа при старте проверяет его наличие, выдавая предупреждение при его -отсутствии. Загрузить MSXML 6.1 можно с сайта -[Microsoft](http://www.microsoft.com/downloads/details.aspx?FamilyID=d21c292c-368b-4ce1-9dab-3e9827b70604&displayLang=ru). +отсутствии. Загрузить MSXML 6.1 можно с сайта [Microsoft]. * Запускать следует `SVKTrans.hta`, снимать зависший - `mshta.exe` (В Windows 10 - *Microsoft(R) HTML приложение (32 бита)*). * В Windows 7+ (проверено и в Windows 10) встроенная регистрация прилагаемых @@ -59,54 +72,94 @@ DLL может выдать ошибку с кодом 0x80004005. Это сра мыши кликнуть на "Командная строка" -> "Запуск от имени администратора" (runas в этом не поможет!) и проделать регистрацию вручную: -``` cd \SVKTrans regsvr32 socket.dll regsvr32 xbuffer.dll -``` ## Дополнительная информация на сайте Банка России -* [Информация о новых версиях программного -обеспечения](http://www.cbr.ru/mcirabis/?PrtId=itest) (СВК, УТА). +* [Информация о новых версиях программного обеспечения]. ## История версий -Проект импортирован на GitHub с версии 2.9.11 с его страницы на -[Bitbucket](https://bitbucket.org/html-applications/svk-transport). +Проект импортирован на GitHub с версии 2.9.11 с его страницы на [Bitbucket]. + +Нумерация версий ведется по принципам [семантического версионирования] +со следующими особенностями (для примера - пусть будет версия *1.2.3*): -Нумерация версий ведется по принципам -[семантического версионирования](http://semver.org/lang/ru/) со следующими -особенностями (для примера - пусть будет версия *2.9.11*): -* Старшая цифра (*2*) меняется, когда сильно +* Старшая цифра (*1*) меняется, когда сильно меняется внешний вид (требуется новое обучение пользователей) или внутренний функционал программы (требуется обратить внимание администраторов и сделать вдумчивые перенастройки); -* Средняя цифра (*9*) - когда что-то добавляется во внешний вид +* Средняя цифра (*2*) - когда что-то добавляется во внешний вид (требуется обратить внимание пользователей - добавлена какая-то их хотелка) или добавлен параметр в файл настройки, поведение которого по умолчанию ничего для администраторов не меняет; -* Младшая цифра (*11*) - когда в программе сделаны какие-то незначительные +* Младшая цифра (*3*) - когда в программе сделаны какие-то незначительные изменения в коде или исправлены ошибки. О более старой истории первоначального автора **mozers** есть в прилагаемом -[файле](docs/changelog.md). +[файле]. + +## Идеи и пожелания, ошибки + +Данные для обратной связи находятся в коде заголовка HTA-приложения. +(Всякие хотелки принимаются и по возможности претворяются.) + +Есть некоторые [Идеи] развития проекта. +Свои пожелания и сообщения об ошибках лучше размещать в [Issues]. ## 3rd party software Проект использует два свободнораспространяемых (Free) ActiveX контрола: + * w3Sockets from **Dimac** (socket.dll) - с октября 2016 сайт больше не доступен; -* [Buffer](http://www.xstandard.com/en/documentation/xbuffer/) -from **XStandart** (xbuffer.dll) - на сайте есть инструкции по установке -и использованию. +* [Buffer] from **XStandart** (xbuffer.dll) - на сайте есть инструкции +по установке и использованию. -Больше об этом можно прочитать в -[wiki](https://github.com/diev/SVK-Transport-hta/wiki). +Больше об этом можно прочитать в [Wiki]. ## Лицензионное соглашение -Licensed under the [Apache License, Version 2.0](LICENSE). +Licensed under the [Apache License, Version 2.0]. (Вы можете использовать его совершенно свободно без всяких ограничений.) -Данные для обратной связи находятся в коде заголовка HTA приложения. +[Важные изменения, влияющее на совместимость]: #важные-изменения-влияющее-на-совместимость +[Основные возможности программы]: #основные-возможности-программы +[Замечания к использованию]: #замечания-к-использованию +[Дополнительная информация на сайте Банка России]: #дополнительная-информация-на-сайте-банка-россии +[История версий]: #история-версий +[Идеи и пожелания, ошибки]: #идеи-и-пожелания-ошибки +[3rd party software]: #3rd-party-software +[Лицензионное соглашение]: #лицензионное-соглашение + +[Wiki]: https://github.com/diev/SVK-Transport-hta/wiki +[Идеи]: https://github.com/diev/SVK-Transport-hta/projects/1 +[Issues]: https://github.com/diev/SVK-Transport-hta/issues +[releases]: https://github.com/diev/SVK-Transport-hta/releases/latest + +[CHANGELOG]: CHANGELOG.md +[Apache License, Version 2.0]: LICENSE + +[icon]: docs/assets/images/svktrans.png +[Рабочее окно приложения]: docs/assets/images/screen.png +[файле]: docs/changelog.md + +[TSH Transport]: http://diev.github.io/TSH-Transport +[SVK Transport]: http://diev.github.io/SVK-Transport-hta +[ПТК ПСД - Обозреватель отчетности]: http://diev.github.io/PTK-PSD-Browser-hta +[UFEBS Viewer]: http://diev.github.io/UFEBS-Viewer-hta + +[appveyor]: https://ci.appveyor.com/project/diev/svk-transport-hta +[ПТК ПСД]: http://ptkpsd.ru/ +[СВК]: http://www.cbr.ru/mcirabis/itest/ +[Bitbucket]: https://bitbucket.org/html-applications/svk-transport +[7-Zip]: https://www.7-zip.org/ +[Microsoft]: http://www.microsoft.com/downloads/details.aspx?FamilyID=d21c292c-368b-4ce1-9dab-3e9827b70604&displayLang=ru +[Информация о новых версиях программного обеспечения]: http://www.cbr.ru/mcirabis/?PrtId=itest (СВК, УТА) +[семантического версионирования]: http://semver.org/lang/ru/ +[Buffer]: http://www.xstandard.com/en/documentation/xbuffer/ + +[Build status]: https://ci.appveyor.com/api/projects/status/1mvedcg27p6n7aj0?svg=true +[GitHub Release]: https://img.shields.io/github/release/diev/SVK-Transport-hta.svg diff --git a/SVKTrans.hta b/SVKTrans/SVKTrans.hta similarity index 98% rename from SVKTrans.hta rename to SVKTrans/SVKTrans.hta index 33c51d1..23b848d 100644 --- a/SVKTrans.hta +++ b/SVKTrans/SVKTrans.hta @@ -1,1591 +1,1591 @@ - - - - - - - - - - - - - - -
-
 Время, оставшееся до... - - - - - -
  ... периодической проверки входящих сообщений: ¹ - Á  -   -
  ... проверки наличия исходящих сообщений:  - +  -   -
  ... запроса ответа на отправленное сообщение:  - .  -   -
  ... повтора неудавшейся попытки соединения:  - )  -   -
-
-
- - -
- -
- -
- - + + + + + + + + + + + + + + +
+
 Время, оставшееся до... + + + + + +
  ... периодической проверки входящих сообщений: ¹ + Á  +   +
  ... проверки наличия исходящих сообщений:  + +  +   +
  ... запроса ответа на отправленное сообщение:  + .  +   +
  ... повтора неудавшейся попытки соединения:  + )  +   +
+
+
+ + +
+ +
+ +
+ + diff --git a/SVKTrans.ini b/SVKTrans/SVKTrans.ini similarity index 98% rename from SVKTrans.ini rename to SVKTrans/SVKTrans.ini index 0b42f3d..d4c1c3b 100644 --- a/SVKTrans.ini +++ b/SVKTrans/SVKTrans.ini @@ -1,132 +1,132 @@ -[Account] -; Сервер СВК (если нет уверенности в стабильной работе DNS, то лучше задавать не имя, а IP адрес) -svk_host=172.19.35.4 - -; Имя dialup соединения с СВК (если используется постоянное подключение, то параметр необходимо закомментировать!) -connection=SVK - -; Логин канальной аутентификации (при постоянном подключении параметр не используется) -chan_login=chan_nnv746 - -; Пароль канальной аутентификации (при постоянном подключении параметр не используется) -chan_passw=12345678 - -; Адрес:порт сервера Telnet (если не задан, то telnet аутентификация не проводится) -;telnet_host=172.19.35.6:23 - -; Логин telnet-аутентификации -telnet_login=tel_nnv746 - -; Пароль telnet-аутентификации -telnet_passw=12345678 - -; Логин web-аутентификации (для регионов с раздельной web-аутентификацией - логин для платежных сообщений) -web_login=web_nnv746 - -; Пароль web-аутентификации (для регионов с раздельной web-аутентификацией - пароль для платежных сообщений) -web_passw=12345678 - -; web-логин для информации и статистики (ТОЛЬКО ДЛЯ РЕГИОНОВ С РАЗДЕЛЬНОЙ WEB-АУТЕНТИФИКАЦИЕЙ) -;web_login_info=ko745i - -; web-пароль для информации и статистики (ТОЛЬКО ДЛЯ РЕГИОНОВ С РАЗДЕЛЬНОЙ WEB-АУТЕНТИФИКАЦИЕЙ) -;web_passw_info=12345678 - -; web-логин для тестовых платежных сообщений (ТОЛЬКО ДЛЯ РЕГИОНОВ С РАЗДЕЛЬНОЙ WEB-АУТЕНТИФИКАЦИЕЙ) -;web_login_test=ko745pt - -; web-пароль для тестовых платежных сообщений (ТОЛЬКО ДЛЯ РЕГИОНОВ С РАЗДЕЛЬНОЙ WEB-АУТЕНТИФИКАЦИЕЙ) -;web_passw_test=12345678 - -; Адрес получателя файлов статистической отчетности -to_addr=nnovg2 - -; Запрашивать (true) или нет (false) квитанции о получении файлов статистической отчетности -; Если необходимы квитки на платежные документы, то настройте АРМ КБР (Конфигурация - Транспортные реквизиты - Запрашивать квитанции) -AckRequest=true - -; Адрес отправителя файлов статистической отчетности (требуется только для сортировки квитанций о получении) -; (Этот адрес пишется в ноде "props:To" в квитанции о получении) -from_addr=nnv746_stat - -; Логический адрес АРМ КБР -UEO_uic_work=uic:220274600000 - -; Логический адрес АРМ КБР РР -;UEO_uic_work=uic:220274600020 - -; Логический тестовый адрес АРМ КБР -UEO_uic_test=uic:220274600011 - -; Логический тестовый адрес АРМ КБР РР -;UEO_uic_test=uic:220274600021 - -; Логический адрес АРМ КБР (для информационных сообщений) -UEO_uic_ies=uic:220274600050 - -; Логический тестовый адрес АРМ КБР (для информационных сообщений) -UEO_uic_ies_test=uic:220274600051 - -; Имена компьютеров или пользователей (через запятую) для отправки сообщений об ошибках в работе скрипта -;messages_recipient=Admin,192.168.0.12 - -[Paths] -; Каталог входящих платежных сообщений -pay_in=C:\BankOfRF\Payments\Incoming\UEO - -; Каталог исходящих платежных сообщений -pay_out=C:\BankOfRF\Payments\Outcoming\UEO - -; Каталог квитанций на платежные сообщения -pay_kvit=C:\BankOfRF\Payments\Kvit\UEO - -; Каталог входящих тестовых платежных сообщений -pay_test_in=C:\BankOfRF\PaymentsTest\Incoming\UEO - -; Каталог исходящих тестовых платежных сообщений -pay_test_out=C:\BankOfRF\PaymentsTest\Outcoming\UEO - -; Каталог квитанций на тестовые платежные сообщения -pay_test_kvit=C:\BankOfRF\PaymentsTest\Kvit\UEO - -; Каталог входящих информационных и сообщений из статистики -stat_info_in=C:\BankOfRF\StatInfo\Incoming - -; Каталог исходящих информационных и сообщений в статистику -stat_info_out=C:\BankOfRF\StatInfo\Outcoming - -; Каталог квитанций на сообщения в статистику -stat_info_kvit=C:\BankOfRF\StatInfo\Kvit - -; Каталог для создания резервных копий принимаемых и отправляемых сообщений (если не задан, то резервное копирование не ведется) -backup=C:\BankOfRF\Backup - -; Фильтры входящих информационных сообщений (от 0 до 9). -; Задается приемный каталог и маски файлов, которые должны в него попадать. -; Срабатывают последовательно. Не попавшие ни под одну маску файлы попадают в stat_info_in -;stat_info_in_filter0=C:\BankOfRF\StatInfo\Incoming\files\*.tif|*.rar|*.pdf -;stat_info_in_filter1=C:\BankOfRF\StatInfo\Incoming\update\0????.cab -;stat_info_in_filter2=C:\BankOfRF\StatInfo\Incoming\365P\mz*.* - -[Timeout] -; Проверка по таймауту (сек) -next=3600 - -; Проверка наличия исходящих сообщений (сек) -outbox=60 - -; Запрос ответа на отправленное сообщение (сек) -conform=600 - -; Повтор неудавшегося подключения (сек) -connerror=20 - -[Config] -; Маска файлов которые будут немедленно уничтожаться на сервере (без их загрузки) -; например, ED374 (информация об участниках системы БЭСП) -;file_ignore=ED374?????.EDS - -; Размер сегментов для получения/отправки файла по частям (рекомендуются значения: 2048, 4096, 8192, 16384) -; Оптимальное значение выбирается исходя из качества связи и настроек сервера СВК -;segment_size_download=16384 -;segment_size_upload=16384 +[Account] +; Сервер СВК (если нет уверенности в стабильной работе DNS, то лучше задавать не имя, а IP адрес) +svk_host=172.19.35.4 + +; Имя dialup соединения с СВК (если используется постоянное подключение, то параметр необходимо закомментировать!) +connection=SVK + +; Логин канальной аутентификации (при постоянном подключении параметр не используется) +chan_login=chan_nnv746 + +; Пароль канальной аутентификации (при постоянном подключении параметр не используется) +chan_passw=12345678 + +; Адрес:порт сервера Telnet (если не задан, то telnet аутентификация не проводится) +;telnet_host=172.19.35.6:23 + +; Логин telnet-аутентификации +telnet_login=tel_nnv746 + +; Пароль telnet-аутентификации +telnet_passw=12345678 + +; Логин web-аутентификации (для регионов с раздельной web-аутентификацией - логин для платежных сообщений) +web_login=web_nnv746 + +; Пароль web-аутентификации (для регионов с раздельной web-аутентификацией - пароль для платежных сообщений) +web_passw=12345678 + +; web-логин для информации и статистики (ТОЛЬКО ДЛЯ РЕГИОНОВ С РАЗДЕЛЬНОЙ WEB-АУТЕНТИФИКАЦИЕЙ) +;web_login_info=ko745i + +; web-пароль для информации и статистики (ТОЛЬКО ДЛЯ РЕГИОНОВ С РАЗДЕЛЬНОЙ WEB-АУТЕНТИФИКАЦИЕЙ) +;web_passw_info=12345678 + +; web-логин для тестовых платежных сообщений (ТОЛЬКО ДЛЯ РЕГИОНОВ С РАЗДЕЛЬНОЙ WEB-АУТЕНТИФИКАЦИЕЙ) +;web_login_test=ko745pt + +; web-пароль для тестовых платежных сообщений (ТОЛЬКО ДЛЯ РЕГИОНОВ С РАЗДЕЛЬНОЙ WEB-АУТЕНТИФИКАЦИЕЙ) +;web_passw_test=12345678 + +; Адрес получателя файлов статистической отчетности +to_addr=nnovg2 + +; Запрашивать (true) или нет (false) квитанции о получении файлов статистической отчетности +; Если необходимы квитки на платежные документы, то настройте АРМ КБР (Конфигурация - Транспортные реквизиты - Запрашивать квитанции) +AckRequest=true + +; Адрес отправителя файлов статистической отчетности (требуется только для сортировки квитанций о получении) +; (Этот адрес пишется в ноде "props:To" в квитанции о получении) +from_addr=nnv746_stat + +; Логический адрес АРМ КБР +UEO_uic_work=uic:220274600000 + +; Логический адрес АРМ КБР РР +;UEO_uic_work=uic:220274600020 + +; Логический тестовый адрес АРМ КБР +UEO_uic_test=uic:220274600011 + +; Логический тестовый адрес АРМ КБР РР +;UEO_uic_test=uic:220274600021 + +; Логический адрес АРМ КБР (для информационных сообщений) +UEO_uic_ies=uic:220274600050 + +; Логический тестовый адрес АРМ КБР (для информационных сообщений) +UEO_uic_ies_test=uic:220274600051 + +; Имена компьютеров или пользователей (через запятую) для отправки сообщений об ошибках в работе скрипта +;messages_recipient=Admin,192.168.0.12 + +[Paths] +; Каталог входящих платежных сообщений +pay_in=C:\BankOfRF\Payments\Incoming\UEO + +; Каталог исходящих платежных сообщений +pay_out=C:\BankOfRF\Payments\Outcoming\UEO + +; Каталог квитанций на платежные сообщения +pay_kvit=C:\BankOfRF\Payments\Kvit\UEO + +; Каталог входящих тестовых платежных сообщений +pay_test_in=C:\BankOfRF\PaymentsTest\Incoming\UEO + +; Каталог исходящих тестовых платежных сообщений +pay_test_out=C:\BankOfRF\PaymentsTest\Outcoming\UEO + +; Каталог квитанций на тестовые платежные сообщения +pay_test_kvit=C:\BankOfRF\PaymentsTest\Kvit\UEO + +; Каталог входящих информационных и сообщений из статистики +stat_info_in=C:\BankOfRF\StatInfo\Incoming + +; Каталог исходящих информационных и сообщений в статистику +stat_info_out=C:\BankOfRF\StatInfo\Outcoming + +; Каталог квитанций на сообщения в статистику +stat_info_kvit=C:\BankOfRF\StatInfo\Kvit + +; Каталог для создания резервных копий принимаемых и отправляемых сообщений (если не задан, то резервное копирование не ведется) +backup=C:\BankOfRF\Backup + +; Фильтры входящих информационных сообщений (от 0 до 9). +; Задается приемный каталог и маски файлов, которые должны в него попадать. +; Срабатывают последовательно. Не попавшие ни под одну маску файлы попадают в stat_info_in +;stat_info_in_filter0=C:\BankOfRF\StatInfo\Incoming\files\*.tif|*.rar|*.pdf +;stat_info_in_filter1=C:\BankOfRF\StatInfo\Incoming\update\0????.cab +;stat_info_in_filter2=C:\BankOfRF\StatInfo\Incoming\365P\mz*.* + +[Timeout] +; Проверка по таймауту (сек) +next=3600 + +; Проверка наличия исходящих сообщений (сек) +outbox=60 + +; Запрос ответа на отправленное сообщение (сек) +conform=600 + +; Повтор неудавшегося подключения (сек) +connerror=20 + +[Config] +; Маска файлов которые будут немедленно уничтожаться на сервере (без их загрузки) +; например, ED374 (информация об участниках системы БЭСП) +;file_ignore=ED374?????.EDS + +; Размер сегментов для получения/отправки файла по частям (рекомендуются значения: 2048, 4096, 8192, 16384) +; Оптимальное значение выбирается исходя из качества связи и настроек сервера СВК +;segment_size_download=16384 +;segment_size_upload=16384 diff --git a/SVKTrans.ini.702 b/SVKTrans/SVKTrans.ini.702 similarity index 78% rename from SVKTrans.ini.702 rename to SVKTrans/SVKTrans.ini.702 index ff78005..17005cf 100644 --- a/SVKTrans.ini.702 +++ b/SVKTrans/SVKTrans.ini.702 @@ -28,34 +28,36 @@ telnet_passw=12345678 ; Логин web-аутентификации (для регионов с раздельной web-аутентификацией - логин для платежных сообщений) ;web_login=web_nnv746 -web_login=ko702p +;web_login=ko702p +; С переходом на ТШ КБР больше не используется! ; Пароль web-аутентификации (для регионов с раздельной web-аутентификацией - пароль для платежных сообщений) ;web_passw=12345678 -web_passw=12345678 +; С переходом на ТШ КБР больше не используется! ; web-логин для информации и статистики (ТОЛЬКО ДЛЯ РЕГИОНОВ С РАЗДЕЛЬНОЙ WEB-АУТЕНТИФИКАЦИЕЙ) ;web_login_info=ko745i web_login_info=ko702i ; web-пароль для информации и статистики (ТОЛЬКО ДЛЯ РЕГИОНОВ С РАЗДЕЛЬНОЙ WEB-АУТЕНТИФИКАЦИЕЙ) -;web_passw_info=12345678 web_passw_info=12345678 ; web-логин для тестовых платежных сообщений (ТОЛЬКО ДЛЯ РЕГИОНОВ С РАЗДЕЛЬНОЙ WEB-АУТЕНТИФИКАЦИЕЙ) ;web_login_test=ko745pt -web_login_test=ko702pt +;web_login_test=ko702pt +; С переходом на ТШ КБР больше не используется! ; web-пароль для тестовых платежных сообщений (ТОЛЬКО ДЛЯ РЕГИОНОВ С РАЗДЕЛЬНОЙ WEB-АУТЕНТИФИКАЦИЕЙ) ;web_passw_test=12345678 -web_passw_test=12345678 +; С переходом на ТШ КБР больше не используется! ; Адрес получателя файлов статистической отчетности ;to_addr=nnovg2 to_addr=ias ; Запрашивать (true) или нет (false) квитанции о получении файлов статистической отчетности -; Если необходимы квитки на платежные документы, то настройте АРМ КБР (Конфигурация - Транспортные реквизиты - Запрашивать квитанции) +; Если необходимы квитки на платежные документы, то настройте АРМ КБР +; (Конфигурация - Транспортные реквизиты - Запрашивать квитанции) AckRequest=true ; Адрес отправителя файлов статистической отчетности (требуется только для сортировки квитанций о получении) @@ -65,31 +67,39 @@ from_addr=ko702i ; Логический адрес АРМ КБР ;UEO_uic_work=uic:220274600000 -UEO_uic_work=uic:403070200000 +;UEO_uic_work=uic:403070200000 +; С переходом на ТШ КБР больше не используется! ; Логический адрес АРМ КБР РР ;UEO_uic_work=uic:403070200020 +; С переходом на ТШ КБР больше не используется! ; Логический тестовый адрес АРМ КБР ;UEO_uic_test=uic:220274600011 -UEO_uic_test=uic:403070200011 +;UEO_uic_test=uic:403070200011 +; С переходом на ТШ КБР больше не используется! ; Логический тестовый адрес АРМ КБР РР ;UEO_uic_test=uic:403070200021 +; С переходом на ТШ КБР больше не используется! ; Логический адрес АРМ КБР (для информационных сообщений) ;UEO_uic_ies=uic:220274600050 -UEO_uic_ies=uic:403070200050 +;UEO_uic_ies=uic:403070200050 +; С переходом на ТШ КБР больше не используется! ; Логический тестовый адрес АРМ КБР (для информационных сообщений) ;UEO_uic_ies_test=uic:220274600051 -UEO_uic_ies_test=uic:403070200051 +;UEO_uic_ies_test=uic:403070200051 +; С переходом на ТШ КБР больше не используется! ; Логический адрес АРМ КБР (для информационных сообщений ED510, ED511) -UEO_uic_51x=uic:403070200053 +;UEO_uic_51x=uic:403070200053 +; С переходом на ТШ КБР больше не используется! ; Логический тестовый адрес АРМ КБР (для информационных сообщений ED510, ED511) -UEO_uic_51x_test=uic:403070200063 +;UEO_uic_51x_test=uic:403070200063 +; С переходом на ТШ КБР больше не используется! ; Имена компьютеров или пользователей (через запятую) для отправки сообщений об ошибках в работе скрипта ;messages_recipient=Admin,192.168.0.12 @@ -98,27 +108,33 @@ UEO_uic_51x_test=uic:403070200063 [Paths] ; Каталог входящих платежных сообщений ;pay_in=C:\BankOfRF\Payments\Incoming\UEO -pay_in=C:\SVK\PLAT\IN +;pay_in=C:\SVK\PLAT\IN +; С переходом на ТШ КБР больше не используется! ; Каталог исходящих платежных сообщений ;pay_out=C:\BankOfRF\Payments\Outcoming\UEO -pay_out=C:\SVK\PLAT\OUT +;pay_out=C:\SVK\PLAT\OUT +; С переходом на ТШ КБР больше не используется! ; Каталог квитанций на платежные сообщения ;pay_kvit=C:\BankOfRF\Payments\Kvit\UEO -pay_kvit=C:\SVK\PLAT\REP +;pay_kvit=C:\SVK\PLAT\REP +; С переходом на ТШ КБР больше не используется! ; Каталог входящих тестовых платежных сообщений ;pay_test_in=C:\BankOfRF\PaymentsTest\Incoming\UEO -pay_test_in=C:\SVK\PTEST\IN +;pay_test_in=C:\SVK\PTEST\IN +; С переходом на ТШ КБР больше не используется! ; Каталог исходящих тестовых платежных сообщений ;pay_test_out=C:\BankOfRF\PaymentsTest\Outcoming\UEO -pay_test_out=C:\SVK\PTEST\OUT +;pay_test_out=C:\SVK\PTEST\OUT +; С переходом на ТШ КБР больше не используется! ; Каталог квитанций на тестовые платежные сообщения ;pay_test_kvit=C:\BankOfRF\PaymentsTest\Kvit\UEO -pay_test_kvit=C:\SVK\PTEST\REP +;pay_test_kvit=C:\SVK\PTEST\REP +; С переходом на ТШ КБР больше не используется! ; Каталог входящих информационных и сообщений из статистики ;stat_info_in=C:\BankOfRF\StatInfo\Incoming diff --git a/Socket.dll b/SVKTrans/Socket.dll similarity index 100% rename from Socket.dll rename to SVKTrans/Socket.dll diff --git a/XBuffer.dll b/SVKTrans/XBuffer.dll similarity index 100% rename from XBuffer.dll rename to SVKTrans/XBuffer.dll diff --git a/restrictions.dat b/SVKTrans/restrictions.dat similarity index 98% rename from restrictions.dat rename to SVKTrans/restrictions.dat index 7af43de..30997ff 100644 --- a/restrictions.dat +++ b/SVKTrans/restrictions.dat @@ -1,14 +1,14 @@ -; , -; .. , , .. -; : -; , , , , , , - ( ) -; 17.04.2010-18.04.2010 - ( ) -; 01.01.2011 - -; 00:00-08:30 - ( , , 2- ) -; . -; -; . -; . -; ---------------------------------------------------------------------------- - -00:00-08:00 ; +; , +; .. , , .. +; : +; , , , , , , - ( ) +; 17.04.2010-18.04.2010 - ( ) +; 01.01.2011 - +; 00:00-08:30 - ( , , 2- ) +; . +; +; . +; . +; ---------------------------------------------------------------------------- + +00:00-08:00 ; diff --git a/appveyor.yml b/appveyor.yml index ee8252f..9335f9e 100644 --- a/appveyor.yml +++ b/appveyor.yml @@ -10,11 +10,11 @@ init: git config --global core.autocrlf input install: - ps: >- - $HTAFile = 'SVKTrans.hta' + $AppFile = 'SVKTrans\SVKTrans.hta' $RegularExpression = [regex] 'version=\"(\d*\.\d*\.\d*)\"$' - $FileContent = Get-Content $HTAFile + $FileContent = Get-Content $AppFile foreach($content in $FileContent) { $match = [System.Text.RegularExpressions.Regex]::Match($content, $RegularExpression) @@ -33,11 +33,7 @@ install: Write-Host "Building v$env:APPVEYOR_BUILD_VERSION dated $env:BuildDate" build_script: - cmd: >- - echo SVKTrans.* >>Package - - echo *.dll >>Package - - echo *.dat >>Package + echo SVKTrans\*.* >>Package echo %APPVEYOR_PROJECT_NAME% v%APPVEYOR_BUILD_VERSION% (%BUILDDATE%) >readme.txt diff --git a/docs/images/screen.png b/docs/assets/images/screen.png similarity index 100% rename from docs/images/screen.png rename to docs/assets/images/screen.png diff --git a/docs/images/svktrans.png b/docs/assets/images/svktrans.png similarity index 100% rename from docs/images/svktrans.png rename to docs/assets/images/svktrans.png diff --git a/docs/index.md b/docs/index.md index f98f875..583645b 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,11 +1,22 @@ -# ![svktrans.png](images/svktrans.png) SVK Transport -[![Build status](https://ci.appveyor.com/api/projects/status/1mvedcg27p6n7aj0?svg=true)](https://ci.appveyor.com/project/diev/svk-transport-hta) -[![GitHub Release](https://img.shields.io/github/release/diev/SVK-Transport-hta.svg)](https://github.com/diev/SVK-Transport-hta/releases/latest) +# ![icon] SVK Transport +[![Build status]][appveyor] +[![GitHub Release]][releases] Прием и отправка платежной XML информации, бинарных информационных и файлов статистики по HTTP протоколу в систему СВК Банка России. -![Рабочее окно приложения](images/screen.png) +![Рабочее окно приложения] + +* [Важные изменения, влияющее на совместимость] +* [Основные возможности программы] +* [Замечания к использованию] +* [Дополнительная информация на сайте Банка России] +* [История версий] +* [Идеи и пожелания, ошибки] +* [3rd party software] +* [Лицензионное соглашение] + +----- Данное HTA-приложение осуществляет прием и отправку платежной XML информации, бинарных информационных и файлов статистики по HTTP протоколу. @@ -13,9 +24,20 @@ Файловый адаптер СВК и др.) выглядит крошечной и шустрой утилитой, тем не менее обладающей достаточно развитым функционалом. -Смотрите также проекты [PTK-PSD Browser](/PTK-PSD-Browser-hta) для просмотра -информационных посылок ПТК ПСД Банка России и [UFEBS Viewer](/UFEBS-Viewer-hta) -для просмотра файлов УФЭБС. +*Примечание: +С момента запуска Единого централизованного платежного шлюза (транспортный +шлюз - ТШ, ТШ КБР) функции платежного обмена с Банком России отделились.* + +Смотрите также проекты: + +* [TSH Transport] - отдельный транспортный агент для работы с ТШ Банка России; +* [PTK-PSD Browser] - для просмотра информационных посылок ПТК ПСД Банка России; +* [UFEBS Viewer] - для просмотра файлов УФЭБС. + +## Важные изменения, влияющее на совместимость + +Кодировка ini для удобства на GitHub переведена в UTF-8. Верните в 1251, +если это играет роль в Вашей системе. ## Основные возможности программы @@ -33,15 +55,13 @@ web-аутентификацией. ## Замечания к использованию -* Распаковать дистрибутивный `zip` из -[Releases](https://github.com/diev/SVK-Transport/releases) в отдельную папку. +* Распаковать дистрибутивный `zip` из [Releases] в отдельную папку. * Программа из соображений защиты IE работает только с локального диска! * До первого запуска программы внимательно изучите и отредактируйте `SVKTrans.ini`. * Для отправки информационных сообщений требуется MSXML версии 4.0 или выше. Программа при старте проверяет его наличие, выдавая предупреждение при его -отсутствии. Загрузить MSXML 6.1 можно с сайта -[Microsoft](http://www.microsoft.com/downloads/details.aspx?FamilyID=d21c292c-368b-4ce1-9dab-3e9827b70604&displayLang=ru). +отсутствии. Загрузить MSXML 6.1 можно с сайта [Microsoft]. * Запускать следует `SVKTrans.hta`, снимать зависший - `mshta.exe` (В Windows 10 - *Microsoft(R) HTML приложение (32 бита)*). * В Windows 7+ (проверено и в Windows 10) встроенная регистрация прилагаемых @@ -56,42 +76,47 @@ DLL может выдать ошибку с кодом 0x80004005. Это сра ## Дополнительная информация на сайте Банка России -* [Информация о новых версиях программного -обеспечения](http://www.cbr.ru/mcirabis/?PrtId=itest) (СВК, УТА). +* [Информация о новых версиях программного обеспечения]. ## История версий -Проект импортирован на GitHub с версии 2.9.11 с его страницы на -[Bitbucket](https://bitbucket.org/html-applications/svk-transport). +Проект импортирован на GitHub с версии 2.9.11 с его страницы на [Bitbucket]. -Нумерация версий ведется по принципам -[семантического версионирования](http://semver.org/lang/ru/) со следующими -особенностями (для примера - пусть будет версия *2.9.11*): -* Старшая цифра (*2*) меняется, когда сильно +Нумерация версий ведется по принципам [семантического версионирования] +со следующими особенностями (для примера - пусть будет версия *1.2.3*): + +* Старшая цифра (*1*) меняется, когда сильно меняется внешний вид (требуется новое обучение пользователей) или внутренний функционал программы (требуется обратить внимание администраторов и сделать вдумчивые перенастройки); -* Средняя цифра (*9*) - когда что-то добавляется во внешний вид +* Средняя цифра (*2*) - когда что-то добавляется во внешний вид (требуется обратить внимание пользователей - добавлена какая-то их хотелка) или добавлен параметр в файл настройки, поведение которого по умолчанию ничего для администраторов не меняет; -* Младшая цифра (*11*) - когда в программе сделаны какие-то незначительные +* Младшая цифра (*3*) - когда в программе сделаны какие-то незначительные изменения в коде или исправлены ошибки. О более старой истории первоначального автора **mozers** есть в прилагаемом -[файле](changelog.md). +[файле]. + +## Идеи и пожелания, ошибки + +Данные для обратной связи находятся в коде заголовка HTA-приложения. +(Всякие хотелки принимаются и по возможности претворяются.) + +Есть некоторые [Идеи] развития проекта. +Свои пожелания и сообщения об ошибках лучше размещать в [Issues]. ## 3rd party software Проект использует два свободнораспространяемых (Free) ActiveX контрола: + * w3Sockets from **Dimac** (socket.dll) - с октября 2016 сайт больше не доступен; -* [Buffer](http://www.xstandard.com/en/documentation/xbuffer/) -from **XStandart** (xbuffer.dll) - на сайте есть инструкции по установке -и использованию.. +* [Buffer] from **XStandart** (xbuffer.dll) - на сайте есть инструкции +по установке и использованию.. -Больше об этом можно прочитать в -[wiki](https://github.com/diev/SVK-Transport-hta/wiki). +Больше об этом можно прочитать в [Wiki]. ## Лицензионное соглашение @@ -99,4 +124,41 @@ Licensed under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0 "LICENSE"). (Вы можете использовать его совершенно свободно без всяких ограничений.) -Данные для обратной связи находятся в коде заголовка HTA приложения. +[Важные изменения, влияющее на совместимость]: #важные-изменения-влияющее-на-совместимость +[Основные возможности программы]: #основные-возможности-программы +[Замечания к использованию]: #замечания-к-использованию +[Дополнительная информация на сайте Банка России]: #дополнительная-информация-на-сайте-банка-россии +[История версий]: #история-версий +[Идеи и пожелания, ошибки]: #идеи-и-пожелания-ошибки +[3rd party software]: #3rd-party-software +[Лицензионное соглашение]: #лицензионное-соглашение + +[Wiki]: https://github.com/diev/SVK-Transport-hta/wiki +[Идеи]: https://github.com/diev/SVK-Transport-hta/projects/1 +[Issues]: https://github.com/diev/SVK-Transport-hta/issues +[releases]: https://github.com/diev/SVK-Transport-hta/releases/latest + +[CHANGELOG]: CHANGELOG.md +[Apache License, Version 2.0]: LICENSE + +[icon]: assets/images/svktrans.png +[Рабочее окно приложения]: assets/images/screen.png +[файле]: docs/changelog.md + +[TSH Transport]: /TSH-Transport +[SVK Transport]: /SVK-Transport-hta +[ПТК ПСД - Обозреватель отчетности]: /PTK-PSD-Browser-hta +[UFEBS Viewer]: /UFEBS-Viewer-hta + +[appveyor]: https://ci.appveyor.com/project/diev/svk-transport-hta +[ПТК ПСД]: http://ptkpsd.ru/ +[СВК]: http://www.cbr.ru/mcirabis/itest/ +[Bitbucket]: https://bitbucket.org/html-applications/svk-transport +[7-Zip]: https://www.7-zip.org/ +[Microsoft]: http://www.microsoft.com/downloads/details.aspx?FamilyID=d21c292c-368b-4ce1-9dab-3e9827b70604&displayLang=ru +[Информация о новых версиях программного обеспечения]: http://www.cbr.ru/mcirabis/?PrtId=itest "(СВК, УТА)" +[семантического версионирования]: http://semver.org/lang/ru/ +[Buffer]: http://www.xstandard.com/en/documentation/xbuffer/ + +[Build status]: https://ci.appveyor.com/api/projects/status/1mvedcg27p6n7aj0?svg=true +[GitHub Release]: https://img.shields.io/github/release/diev/SVK-Transport-hta.svg