Использование http-протокола для FarCards (ExtDllHTTP.dll)

Общая информация

Использование HTTP-протокола для взаимодействия с ретранслятором карт Farcards исключают необходимость разработки интерфейсной библиотеки и расширяют возможности по интеграции сторонних систем с R-Keeper.

Дистрибутив

Для работы по протоколу http необходим следующий набор:

  1. Дистрибутив Farcards v604, доступен по адресу ftp://ftp.ucs.ru/r-keeper/versions/PERSCARD/FARCARDS/fc604.7z;
  2. Библиотека ExtDllHTTP.dll для связи с внешней системой по HTTP на основе протокола Farcards v29, доступна по адресу: ftp://ftp.ucs.ru/rk7/other/fc_http/

Структурная схема

Лицензирование

Обратите внимание, что на объекте пролицензировать можно только один экземпляр DLL.

Библиотека ExtDllHTTP.dll требует лицензирования.

Для лицензирования необходимо:

 

 

 

 

 

 

 

 

Рис. 1 - Авторизация в HTTP_LicGen.exe

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Рис. 2 Выбор объекта

 

 

 

 

 

 

 

 

 

 

 

Рис. 3 Выбор даты окончания лицензии

 

 

 

 

 

 

 

 

 

 

 

Рис. 4 Результат успешного создания лицензии

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Рис. 5 Дата окончания лицензии меньше даты окончания уже сгенерированной лицензии

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Рис. 6 Информация о лицензии и просмотр событий

 

 

Настройка

Пример:    

[FarServer]
Type = 1
DLL = ExtDllHTTP.dll
Gate = 1
Log = 4

 

Пример:

[Server]

;Точка входа процессингового сервера
Address=http://192.168.101.141:80

;адрес обработчика функции GetCardInfoEx, т.е. это выполнится http://192.168.101.141:80/getcardinfoex.php
GetCardInfoEx=getcardinfoex.php

;адрес обработчика функции TransactionsEx
TransactionsEx=transactionsex.php

;адрес обработчика функции FindEmail
FindEmail=findemail.php

;адрес обработчика функции GetCardImageEx
GetCardImageEx=getcardimageex.php

;адрес для нотификации ошибок лицензирования
LicenseInfo=licenseinfo.php


;Прокси используется для запросов к серверу лицензий UCS 
[Proxy]

;Использовать прокси (1-да, 0 - нет)
UseProxy=0
BasicAuthentication=0
Server=127.0.0.1
Port=9944
UserName=
Password=
 

 

Локализация

Библиотека ExtDllHTTP.dll не требует локализации.

Для генератора лицензий Http_LicGen.exe есть возможность указать язык интерфейса - для  этого в файле конфигурации ExtDllHttp.ini необходимо установить параметр Localize в секции [LicGen]:

[LicGen]
Localize=LicGenEn.xlf

В параметре Localize можно указать как относительный, так и абсолютный (полный) путь к файлу локализации.

Файл английской локализации (LicGenEn.xlf) можно загрузить по ссылке http://localize.ucs.ru/en_GB/Http_LicGen/

Примечание: В переводе могут быть неточности,  правильность перевода  рекомендуется предварительно проверить.

 

Как работает механизм локализации:

  1. При запуске Http_LicGen.exe происходит попытка загрузить локализацию из файла, указанного в ExtDllHttp.ini
  1. Если файл конфигурации ExtDllHttp.ini не настроен либо нет указанного файла локализации илбо произошла ошибка при загрузке локализации, используется локализация по-умолчанию (RU).

 

Авторизация на внешнем сервисе

Если внешний сервис требует авторизации, необходимо задать имя пользователя и пароль (поддерживается только базовая авторизация).

Имя пользователя и пароль задаются через утилиту Http_LicGen.exe и хранятся в зашифрованном виде в файле ExtDllHttp.dat:

 

Спецификация протокола

Спецификация HTTP-протокола  доступна на FTP-сервере по ссылке: ftp://ftp.ucs.ru/rk7/other/fc_http/fc_http.pdf