Общая информация
Использование HTTP-протокола для взаимодействия с ретранслятором карт Farcards исключают необходимость разработки интерфейсной библиотеки и расширяют возможности по интеграции сторонних систем с R-Keeper.
Дистрибутив
Для работы по протоколу http необходим следующий набор:
- Дистрибутив Farcards v604, доступен по адресу ftp://ftp.ucs.ru/r-keeper/versions/PERSCARD/FARCARDS/fc604.7z;
- Библиотека ExtDllHTTP.dll для связи с внешней системой по HTTP на основе протокола Farcards v29, доступна по адресу: ftp://ftp.ucs.ru/rk7/other/fc_http/
Структурная схема
Лицензирование
Обратите внимание, что на объекте должна быть только одна лицензия HttpFarcards.
Библиотека ExtDllHTTP.dll требует лицензирования.
Для лицензирования необходимо:
- через сервер лицензий l.ucs.ru оформить заявку на приобретение мастер-лицензии для продукта "R-Keeper интерфейс Farcards-HTTP ПО", дождаться ее подтверждения (заявка создается стандартным образом, более подробно см. http://support.ucs.ru/ru/node/7161)
- запустить утилиту HTTP_LicGen.exe, авторизоваться с помощью дилерского логина и пароля:
Рис. 1 - Авторизация в HTTP_LicGen.exe
- в главном окне нажать кнопку "Выбрать", из списка "Выбор ресторана" выбрать объект, для которого необходимо сгенерировать лицензию:
Рис. 2 Выбор объекта
- нажать кнопку "Получить лицензию" и в открывшемся окне указать желаемую дату окончания лицензии. При выборе "MaxDate" автоматически подставится дата окончания мастер-лицензии (см. рис. 3).
Рис. 3 Выбор даты окончания лицензии
- нажать кнопку "Далее", после успеного создания лицензии отобразится соотв. сообщение:
Рис. 4 Результат успешного создания лицензии
- в том случае. если лицензия генерируется повторно и дата окончания лицензии меньше даты окончания уже сгенерированной лицензии, система ссобщит об ошибку:
Рис. 5 Дата окончания лицензии меньше даты окончания уже сгенерированной лицензии
- в открывшемся окне отобразится информация о созданной лицензии и информация о событиях, произошедших с лицензией (блокировка, продление и пр.) (см. рис. 6)
Рис. 6 Информация о лицензии и просмотр событий
- после успешного создания лицензии можно начинать настройку FarCards.
Настройка
- Распаковать архив FarCards v604
- Распаковать архив библиотеки связи с внешней системой (архив содержит 2 файла: библиотека- ExtDllHTTP.dll и файл настроек - ExtDLLHTTP.ini) в корневую папку FarCards v604.
- Отредактировать FARCARDS.INI - в разделе [FarServer] указать название библиотеки для связи по протоколу http - ExtDllHTTP.dll
Пример:
[FarServer] Type = 1 DLL = ExtDllHTTP.dll Gate = 1 Log = 4
- Настроить конфигурационный файла библиотеки для связи по протоколу http - ExtDLLHTTP.ini. В данном файле необходимо указать адрес удалённого Web сервера, на котором находится база владельцев карт.
Пример:
[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=
- R-Keeper настраивается стандартным образом для связи с системой R-Keeper CRM.
Локализация
Библиотека ExtDllHTTP.dll не требует локализации.
Для генератора лицензий Http_LicGen.exe есть возможность указать язык интерфейса - для этого в файле конфигурации ExtDllHttp.ini необходимо установить параметр Localize в секции [LicGen]:
[LicGen] Localize=LicGenEn.xlf
В параметре Localize можно указать как относительный, так и абсолютный (полный) путь к файлу локализации.
Файл английской локализации (LicGenEn.xlf) можно загрузить по ссылке http://localize.ucs.ru/en_GB/Http_LicGen/
Примечание: В переводе могут быть неточности, правильность перевода рекомендуется предварительно проверить.
Как работает механизм локализации:
- При запуске Http_LicGen.exe происходит попытка загрузить локализацию из файла, указанного в ExtDllHttp.ini
- Если файл конфигурации ExtDllHttp.ini не настроен либо нет указанного файла локализации илбо произошла ошибка при загрузке локализации, используется локализация по-умолчанию (RU).
Авторизация на внешнем сервисе
Если внешний сервис требует авторизации, необходимо задать имя пользователя и пароль (поддерживается только базовая авторизация).
Имя пользователя и пароль задаются через утилиту Http_LicGen.exe и хранятся в зашифрованном виде в файле ExtDllHttp.dat:
Спецификация протокола
Спецификация HTTP-протокола доступна на FTP-сервере по ссылке: ftp://ftp.ucs.ru/rk7/other/fc_http/fc_http.pdf