jHOST

Для программы "Удаленный Клиент" (или jClient) версии 2.0 и выше

ВНИМАНИЕ! Пожалуйста, прочтите этот документ до конца, он не такой уж и большой, и Вам же потом будет проще. Я же его смог написать, ну а прочесть гораздо легче :)

Назначение программы.

Программа jHOST предназначена для организации работы нескольких клиентов, работающих с программой jClient 2.x через одно внешнее устройство модуля "Накопитель". jHOST также способен работать с DiaCLIENT'ом.

Текущая версия и отличия от предыдущих

Установка программы

Разверните дистрибутивный архив в каталог по Вашему выбору. Проставьте в файле CONFIG.SYS значение параметра FILES не ниже 40

Настройка программы

Для настройки параметров программы jHOST существует специальная утилита jHOSTcfg.exe, которая входит в комплект дистрибутива. Процесс настройки условно можно подразделить на следующие этапы:

• Общие настройки программы jHOST
• Настройка параметров клиентов и списка счетов, им доступных
• Настройка параметров маршрутизации документов

Рассмотрим эти шаги подробнее:

1. Общие настройки
   Запустите jHOSTcfg.exe, в главном меню выберите пункт "Настройки" -> "Общие настройки" и в появившемся диалоговом окне произведите установку параметров в требуемые значения. Рассмотрим общие параметры настройки поподробнее
   

   Каталог, куда помещаются файлы запросов к внешнему устройству	Задает имя каталога, которое прописано в настройках внешнего устройства модуля "Накопитель", как каталог в котором "Накопитель" ищет файлы с запросами
   Каталог, куда внешнее устройство помещает файлы ответов	Задает имя каталога, которое прописано в настройках внешнего устройства модуля "Накопитель", как каталог в который "Накопитель" помещает файлы с ответами на запросы. Может совпадать с предыдущим параметром, но в таком случае имена файла запроса и файла ответа должны быть разными
   Имя файла-запроса к внешнему устройству	Задает имя файла запроса к внешнему устройству
   Имя файла-ответа внешнего устройства	Задает имя файла-ответа внешнего устройства
   Каталог, куда помещаются принятые файлы от клиентов	Задает имя каталога, в который помещаются расшифрованные файлы, принятые от удаленных клиентов
   Каталог, куда помещаются файлы для клиентов	Задает имя каталога, в который помещаются файлы с результатами обработки запросов клиентов. Файлы, которые здесь располагаются еще незашифрованны
   Название образца отчета	Название образца отчета, как оно фигурирует в ДиасофтБАНКе. По этому образцу для клиента будет готовиться выписка.
   Полное имя BAT-файла для запуска RBANK.EXE	Имя BAT-файла с указанием полного пути. С его помощью будет запущена подсистема отчетов для формирования выписки. Пример такого BAT поставляется вместе с jHOST.
   Номер филиала	Номер филиала. Параметр используется для получения выписок при запуске подсистемы "Отчеты банка" в пакетном режиме. Должен совпадать с тем, который указан в настройках "ДиаБАНКа"

2. Настройка параметров клиентов
   В главном меню выберите пункт "Настройки" -> "Настройки клиентов". Появится список клиентов, которые обслуживаются программой jHOST, Вы можете добавить нового клиента (INS), удалить клиента (DEL), отредактировать параметры клиента (F4) и отредактировать список счетов, принадлежащих данному клиенту (ENTER). Занесите в список всех Ваших клиентов, идентификатор клиента должен совпадать с идентификатором в jClient, имя для регистрации и пароль соответственно тоже. Ответисполнитель по клиенту - это некий номер, полученный при регистрации ответисполнителя во внешнем устройстве. Если данное поле оставить пустым, то при каждом заходе в это поле будет предприниматься попытка регистрации ответисполнителя. Если необходимо перерегистрировать ответисполнителя, просто очистите данное поле, выйдите из него и войдите в него снова. Если один ответисполнитель обслуживает нескольких клиентов, то регистрировать его каждый раз не надо! Просто скопируйте полученный ранее идентификатор. И, наконец, каждому клиенту пропишите список счетов, с которыми данный клиент может работать и/или получать остатки.
3. Настройка параметров маршрутизации
   Таблица маршрутизации необходима программе jHOST для определения корсчета в банке, через который проводить тот или иной межбанковский документ. Таблица содержит четыре параметра
   

   Актуально с	Этот параметр указывает время, с которого действует правило маршрутизации
   БИК банка получателя платежа	Код БИК конечного банка, который указан в поручении клиента, как банк получателя
   БИК банка посредника	Код БИК банка посредника, через которого проводится поручение
   Корр счет банка	Корр.счет банка посредника, открытый в плане счетов Вашего банка

   В данной таблице должна быть как минимум одна запись, для проведения платежей "по умолчанию", в данной записе код БИК банка получателя должен быть равен "999999999" (девять девяток). При определении маршрута проведения документа jHOST будет пытаться найти код БИК банка получателя в соответствующем поле таблицы и при нахождении такой записи проведет данный платеж через соответствующий коррсчет. Если банка с таким кодом найдено не будет, тогда используется запись "по умолчанию".

Как работает jHOST

Для того, чтобы проще было настраивать jHOST рассмотрим этапы, которые проходит документ в процессе обработки:

1. Файл с документами, принятый от клиента, расшифровывается и помещается в каталог принятых документов для jHOST
2. Запускается программа jHOST.exe
3. jHOST сканирует каталог принятых документов и обрабатывает файлы, которые там находятся по следующей схеме
   • из имени файла берутся первые 4 символа, которые являются идентификатором клиента
   • по идентификатору производится поиск клиента в таблице клиентов jHOST'a и если клиент не найден, то обработка файла прекращается и файл удаляется из каталога. Если клиент найден, то производится сверка регистрационного имени клиента и его пароля, переданных в файле с документами с теми именем и паролем, которые указаны в параметрах клиента в программе jHOST и при их несовпадении обработка опять же прекращается.
   • каждое поручение, которое будет найдено в обрабатываемом файле, проверяется, что бы счет, который стоит как счет плательщика, совпадал с одним из счетов, принадлежащих данному клиенту, и, если такая проверка проходит успешно и данный счет не блокирован, то поручение принимается к обработке.
   • Из каталога, в который накопитель помещает файл ответа внешнего устройства, производится попытка удаления старого файла ответа. "На всякий случай, чтоб под ногами не путался :-)"
   • В каталоге, заданном как каталог для запросов к внешнему устройству, создается файл с именем "файл запроса к внешнему устройству" и все поручения, которые прошли проверку выгружаются в этот файл, таким образом, что а) инициация процесса загрузки документов в накопитель происходит от лица пользователя системы "ДиасофтБанк" указанного в качестве ответисполнителя по данному клиенту и б) документы закачиваются в пачку, указанную в параметрах клиента.
   • В каталоге ответа внешнего устройства ожидается появление файла ответа и после появления jHOST читает из него коды ошибок загрузки документов клиента. Файл ответа после прочтения удаляется.
   • Если в файле, принятом от клиента, содержался так же и запрос на получение выписки, то jHOST сформирует файл с командами для пакетного запуска подсистемы "Отчеты банка" и запустит BAT-файл, указанный в общих настройках. (ПРИМЕЧАНИЕ: Старые версии jHOST'a не имели такой возможности, поэтому по запросу на выписку формировался запрос к внешнему устройству накопителя на получение остатков по всем счетам клиента за дату, которая указана как дата конца периода, за который необходима выписка).
   • Результаты загрузки документов и (если запрашивались) остатки по счетам выгружаются в файл с тем же самым именем, какое было у принятого файла, только уже в каталоге для отправки клиентам.
   • Обработанный таким образом файл с документами клиента удаляется из каталога приема
   • jHOST приступает к обработке следующего файла или заканчивает работу, если файлов больше нет.
4. Файлы, расположенные в каталоге для отправки клиентам шифруются и рассылаются внешней программой. jHOST этим не занимается :)

Как связаться с автором