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

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

Дистрибутив

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

  1. Дистрибутив Farcards, доступен по адресу ftp://ftp.ucs.ru/rk7/other/fc_http/. Скачайте последнюю версию.
  2. Библиотека ExtDllHTTP.dll для связи с внешней системой по HTTP на основе протокола Farcards v29, доступна по адресу: ftp://ftp.ucs.ru/rk7/other/fc_http/

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

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

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

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

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

  • запустить утилиту 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
XML
  • Настроить конфигурационный файла библиотеки для связи по протоколу 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=
XML
  •  R-Keeper настраивается стандартным образом для связи с системой R-Keeper CRM.

Локализация

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

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

[LicGen]
Localize=LicGenEn.xlf
XML

В параметре 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