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

Использование 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/

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

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

Обратите внимание, что на объекте должна быть только одна лицензия 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/

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

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

1. При запуске Http_LicGen.exe происходит попытка загрузить локализацию из файла, указанного в ExtDllHttp.ini

2. Если файл конфигурации ExtDllHttp.ini не настроен либо нет указанного файла локализации илбо произошла ошибка при загрузке локализации, используется локализация по-умолчанию (RU).

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

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

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

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

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