Вводная информация

Установка практически любой  конфигурации програмного комлекса r-keeper 6 (от небольшого кафе до огромного развлекательного комплекса)  как правило  начинается с установки "Менеджерской части RK6".   Только установив менеджерскую часть и настроив ее первоначальную конфигурацию можно "наращивать" дополнительные модули комплекса RK6.

Системные требования

Так как, ПО находится на рынке продолжительное время (не один десяток лет) и в архитектуре своей достаточно устойчиво  и меняется не значительно, то и требования к работоспособности находятся на том же уровне, что и несколько лет назад. 

Оборудование

  • Стандартный ПК офисной конфигурации: CPU - P4, RAM - 1-2 Gb, HDD - 20 Gb и выше + LAN + USB.

Операционная система

ПО работает под управлением операционной системы (ОС) семейства MS Windows 98 и выше.

  • Рекоммендовано, что бы редакция ОС была не начальной - Basic, Home, Lite edition (максимально урезанной), а ближе к профессиональным - Professional, Interprise и др.
  • В PRO-редакциях полноценно поддерживается и настраиватся сеть, сетевые ресурсы и пользователи ОС.  
  • Так же, рекомендуется, что бы ОС имела разрядность  32-bit, так как некоторые модули RK6 продолжают активно эксплуатировать сетевой протокол обмена данными Netbios, который в современных 64-битных ОС полноценно не поддержан (пробрасывается только поверх TCP).

Примечание: в качестве примера, идеальной среды для работы RK6 можно указать - ос windows xp pro sp2(sp3). Данная ОС зарекоммендовала себя большим количеством установок и временем. 

Примечание: серверные редакции не рекоммендованы в силу сложности их обслуживания и обилия дополнительных настроек. Т.е. необходимо обладать знаниями по настройке и администрированию данных систем.

Установка менеджерской

  1. Скачать с ФТП  (например, отсюда - ftp://.../dealers/r-keeper/versions/RK6/MAN69504.7Z) актуальный архив дистрибутива \RK6. 
  • Что бы понять, что находится в архивах в большинстве директорий на фтп находятся текстовые файлы, с названием типа - content.txt. В них описано содержание скачиваемых архивов. Так же, рекомендуется уделять особое внимание и остальным текстовым файлам например, -  HISTORY.TXT, VERSION.TXT, VER.TXT, README.TXT и т.п. так как в этих документах содержиться масса полезной информации по дистрибутивам ПО, которое вы собираетесь использовать, что несомненно позволит лучше ориентироваться в программном обеспечении и в самом FTP.

Пример, в content.txt указано:

MAN69504.7Z - полная инсталляция офисной части R-Keeper 6.95.04 без содержимого архивов Cfx.7z, Fr302.7z, Hlp.7z.

- запись говорит о том что, также необходимо будет скачать недостающие архивы Cfx.7z, Fr302.7z, Hlp.7z. Без них дистрибутив ПО РК6 будет не полным .

  1. Распаковываем основной архив (в нашем случае это - MAN69504.7Z), и распакованную папку \RK6 копируем в рабочий раздел ПК (по-умолчанию, в корень диска C:\ или D:\). Дополнительные архивы (Cfx.7z, Fr302.7z, Hlp.7z.) так же распаковываем и их содержимое копируем в папку \RK6.
  • С версии менеджерской 6.95 приложение полностью переведено на работу с модулем отчетов "Fast report", необходимая поддержка этого модуля находится в архиве - ftp://ftp.ucs.ru/dealers/r-keeper/versions/OTHER/Fr302.7z.
  • Если, ставятся более старые версии менеджерской, то необходимо использовать ftp://ftp.ucs.ru/dealers/r-keeper/versions/OTHER/fr208.7z + доустановить модули поддержки отчетов "Crystal report" (можно взять здесь - ftp://ftp.ucs.ru/dealers/storehouse/sh3/crpe.inst.rar). Если, поддержку "Crystal report" не доустанавливать, то не будет работать большинство печатных форм отчетов.
  1. Скопировать с ftp://ftp.ucs.ru/dealers/r-keeper/Tools/BDE/ архив дистрибутива Borland Database Engine, распаковать и установить, следуя стандартным инструкциям установщика этого сервиса.
  • Рекоммендовано, для работы с RK6 использовать версию BDE 5.0 с апгрейдом до 5.01.
  •  В результате успешной установки, в Панели Управления ОС появится ярлык "BDE  Administrator".
  1. Запустить "BDE  Administrator" и отредактировать следующие параметры:
  • Зайти во вкладку Configuration\Drivers\Native\Paradox и изменить значение LANGDRVER на "Pdox ANSI Cyrillic".
  • Зайти во вкладку Configuration\Drivers\Native\DBASE и изменить значение LANGDRIVER на "dBASE RUS cp866".
  • После этого сохранить изменения и перезапустить ПК.

Примечание: на современных ОС могут возникать непредвиденные ситуации связанные с запуском и работой BDE и "BDE Administartor", может потребоваться запуск от имени администратора с правом правки реестра. Иначе, настройки не сохранятся. Так же, для работы в 64-битных системах должна использоваться 64-битная сборка BDE (выложена там же на FTP).

  • В рабочей папке \RK6 с версии менеджерской 6.95 и выше ОТСУТСТВУЕТ папка \TTFONTS в которой, содержались необходимые для установки в ОС шрифты.
  • Если используется для установки дистрибутив менеджерской версии ниже 6.95 и в нем есть папка \TTFONTS соответсвенно их нужно просто доустановить в ОС, через \Панель Управления\Шрифты или путем копирования содержимого папки в рабочий каталог \Windows\FONTS.
  • В состав менеджерского комлекса RK6 входит несколько приложений. Часть из них предназначена для непосредственных пользователей, остальные же носят чисто технический или сервисный характер.
  1. Следующим действием, необходимо создать на рабочем столе папку \RK6 куда вывести ярлыки пользовательских приложений:
  • E_Rest32.exe - Редактор
  • Report32.exe - Отчеты
  • Append32.exe - Закрытие дня
  • Disp32.exe - Диспетчер пользователей

По необходимости, могут выводиться и использоваться приложения:

  • Transp32.exe - Транспорт в DBF для связи со сторонними системами или R-KEEPER HEAD OFFICE.
  • Monit32.exe - Мониторинг кассового сервера.
  • MonSum.exe - Обобщающий мониторинг нескольких кассовых серверов.

 - эти приложения потребуют отдельных настроек при их использовании в зависимости от конфигурации ПО предприятия.

Сервисные приложения:

  • DealRK.exe - первоначальная конфигурация (Заход под дилерским ID и PSW с наличием в папке \RK6 обновленного файла RAL.DAT).
  • FEditor.exe - редактор кассовых печатных форм.
  • Reind32.exe - реиндексация менеджерской базы данных \DB.
  • UPGRK32.exe - обновление менеджерской базы данных до версии самой менджерской.
  • RECOV32.exe - утилита перекачки записей из таблиц PARADOX.
  1. Следующим шагом, настроить основной конфигурационный файл rkeeper.ini.
  • Этот файл разбит на разделы, названия разделов заключены в квадратные скобки. Так как менеджерская представляет собой комплекс приложений для многих из них, в конфигурационном файле rkeeper.ini отведены отдельные разделы.
  • Кроме того, менеджерская может дополняться и другими приложениями производства UCS, (например, - PCARDS) в которых, также используется в качестве ОСНОВНОГО конфигурационного файла - rkeeper.ini.
  • Другими словами, rkeeper.ini можно дополнять новыми разделами и параметрами в зависимости от конфигурации и количества различных модулей используемого ПО.
  • Ниже приведен стандартный вид файла:

RKEEPER.INI

[Common]                  - [ОБЩИЕ]
Alias1=.\DB               - путь к таблицам справочников менеджерской части (PARADOX). Может быть сетевым (через IP, расшаренный ресурс, сетевую букву диска)
Alias2=.\DB               - путь к накопительной базе (ARK6.UDB). Может быть сетевым (через IP, расшаренный ресурс, сетевую букву диска)

Language=.RUS             - язык, по-умолчанию
EditFRF=yes               - разрешен/запрещен встроенный редактор печатных форм FAST REPORT

[Reports]                 - [ОТЧЕТЫ] 
CFXFontName               - шрифт для надписей в графиках и диаграммах
CFXFontSize               - его размер 
CFXFontCharset            - его кодовая страница - см Charsets.txt
CSLinkDLL=                - dll для связи с сервером персональных карт
CSLinkGate=               - номер Report32 в секции этой dll
CharCode=                 - dll для перекодировки строк, иногда нужна (rus, litva, latin2)
TipsVAT=                  - размер налога на чаевые в процентах
SpdUnpay=0                - 0 - не включать чеки с неплательщиками в отчеты по скорости обслуживания
                          - 1 - включать все чеки в отчеты по скорости обслуживания
SpdMinTime=0              - минимальное время жизни чеков (минут), включаемых в отчеты по скорости обслуживания
SpdMode=0                 - 0 - скорость на чек;  1 - скорость на гостя
BsoMatrix=0               - 0 - Контрольная лента выводится на обычный принтер 1-на матричный
DBF=                      - экспорт сформированных отчетов в dbf-формат
ItemsReport=1             - если 1, то следующие отчеты будут в национальной валюте:
                                    Расход блюд         
                                    Расход блюд по категориям
                                    Расход блюд по группам станций
                                    Расход блюд по валютам
DaysReport=1              - если 1, то следующие отчеты будут в национальной валюте:
                                    Выручка по дням
StartHour=                - начальный час для почасовых отчетов
Guardant=$(ID ключа)      - параметр явно указывающий ID используемого лицензионного ключа.
  • Параметр Guardant= необходимо прописывать для каждого раздела (приложения RK6) которое использует лицензионный ключ. Если, параметр не указан (не используется), то возможны конфликты с другими ключами (если, к ПК одновременно подключено несколько ключей с лицензиями под разные приложения UCS).
  • Указание параметра Guardant= также ускоряет опрос ключа при запуске приложений RK6 что в свою очередь повышает скорость запуска приложений комплекса RK6. 

Важно! ID ключа можно считать при помощи утилиты диагностики драйвера ключа (\Панель Управления\Драйверы Guardant) - как правило, состоит из 8-ми цифр (HEX), символ "h" не является значимым!

[Editor]
KbdFont=Antica             - каким шрифтом делать распечатку раскладки грячих клавиш клавиатур.
NetGate=6                  - сетевая настройка
RKOrderDir=D:\RKORDER      - каталог выгрузки RK6ORDER.XML для связи с ПО RK-ORDER
OnLine=Yes                 - передавать on-line блюда и персонал на кассы
LockDel=                   - DLL для разрешения удалений
RkOrderDir=                - Путь куда выкладывать файл для RK-Order.
Guardant=$232D7F11         - параметр явно указывающий ID используемого лицензионного ключа.

[Monitor]                  - Мониторинг
...
NetGate=5                  - сетевая настройка

[Appender]                 - Закрытие дня
EndDayPath=d:\RK6\ENDDAY\  - каталог приема данных закрытых смен от кассовых серверов. Может быть сетевым (через IP, расшаренный ресурс, сетевую букву диска)
AutoClose=Yes              - Если Yes - приложение закроется само
AvatPath=.\DB              - указать тот же путь что указан в Alias2                   
BackupPath=.\DB\           - путь, куда делать бэкап файла ARK6.UDB при каждом запуске Закрытия Дня
BackupCount=10             - количество хранимых бэкапов
PostExe=                   - можно указать приложение для запуска после закачки
TransPath=                 - путь куда сбрасывать файл ltrans.dbf

[Admin]                    - доп.параметры администрирования
ShowHistory=YES            - показывать ли историю выполняемых в менеджерской базе действий.

[Transport]                - Транспорт
StockPath=                 - куда записывать экспортируемые DBF
DBF=OEM                    - OEM / ANSI - кодировка в DBF файлах экспорта
Office=No                  - если YES, то можно принимать файлы из Бэк-офиса и отправлять файлы в бэк-офис.
ShowExport=YES             - показывать ли пункт меню "Экспорт в офис"
OfficeOut=                 - Путь куда записывать файлы для Бэк-офиса
GenPath=                   - Путь откуда брать файлы, присланные из РосИнтера
RboLink=1                  - 0  Бэк-офисом является РосИнтер
                           - 1  Бэк-офисом является RBO
                           - 2  Mеню (группы печати, модификаторы), НДС - из RBO, остальное из Gener32
                           - 3  Меню и сопутствующее - из локальной RBO, остальное - из головной RBO
RboPath=                   - Путь откуда брать файл, присланный из RBO
AutoClose=                 - если YES то приложение закроется само в случае запуска из командной строки
DishServ=1                 - 0 - не принимать группу печати блюда от RBO
                           - 1 - принимать группу печати блюда от RBO
OMC=0                      - 1 - экспорт в DBF по техзаданию от "OMC"
CSLinkDll=                 - dll для связи с CardServ (если OMC=1)
CSLinkGate =               - номер Transporta в секции этой dll
RboScreens = 0             - принимать ли Экраны станций из RBO 0-нет 1-да

[RNBOpen]                  - модуль связи с кассовым сервером
Client5 = Mon_01           - имя клиента мониторинга для связи с кассовым сервером
Server5 = RLSERV           - имя кассового сервера для подключения мониторинга
Adapter5 = 0               - номер адаптера кассового сервера для подключения мониторинга

Client6 = RK-Editor        - имя клиента приложения редактор
Server6 = RLSERV           - имя кассового сервера для подключения редактора
Adapter6 = 0               - номер адаптера

[RNetbios]                 - модуль связи через NETBIOS
Server1 = PCSERV           - имя сервера
Client1 = RK-Transport     - имя клиента

Server2 = PCSERV           - имя сервера (параметры зависят от конфигурации системы)
Client2 = RK-Reports       - имя клиента (параметры зависят от конфигурации системы)

Примечание: Если параметр AdapterX присутствует, то используется указанный номер адаптера. Если параметр отсутствует или его значение не указано, используется первый из существующих номеров адаптеров и это значение не обязательно будет равно 0.

Примечание: Файл RKEEPER6.INI может дополняться новыми разделами и параметрами - актукальную инфомрацию можно получить из истории изменений менеджерских модулей в файле \RK6\VER\VER_HIST.TXT 

7. Содержимое архива Cfx.7z, что мы скопировали в папку \RK6 ранее, содержит необходимые компоненты для поддержки в приложении Report32 (Отчеты) графических представлений сформированных отчетов в виде графиков, диаграм и т.п. Что бы данный функционал заработал, необходимо не только скопировать модули, но и зарегистрировать их в реестре запустив \RK6\chartfx.reg.

8. Скопировать с  ftp://ftp.ucs.ru/dealers/r-keeper/ral актуальный файл RAL.DAT после чего, можно запускать DealRK.exe для первоначальной конфигурации менеджерской базы RK6.

9. Последним действием, запустить сам E_rest32.exe (Редактор), заполнить справочники. Без минимального наполнения справочников, не запуститься кассовое ПО.

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

Для защиты "Менеджерской RK6" используются стандартные для многих приложений компании UCS электронные usb-ключи производства компании Guardant. Официальный сайт - http://www.guardant.ru. Там же, можно скачать и последние актуальные драйвера для этих ключей.

Так же, драйвера ключей есть и на нашем фтп, например, -  ftp://ftp.ucs.ru/dealers/Novex.drv/

  1. Скачать актуальный драйвер ключа, разархивировать, запустить установщик, следуя инструкциям по установке установить драйвер без подключенного физически ключа.
  2. После установки подключить ключ в порт и далее следовать автоматической стандартной установке устройств ОС Windows.
  3. По завершению на ключе должна загореться лампочка, а в "Панели Управления" добавиться ярлык менеджера ключей Guardant.

Для работы менеджерской RK6 требуется наличие ключа именно на том ПК где она запускается. 

Терминальный доступ для работы с Менеджерской RK6 компанией UCS не поддерживается. Это связанно:

  • С техническими ограничениями накладываемыми ключем (не поддерживаются сетевые технологии)
  • Особенностями работы BDE (DB RK6 не является многопользовательской)
  • С политикой компании (сколько менеджерских мест RK6 ставится столько лицензий/ключей и приобретается).

Смена дилерства

  1. Клиент должен отправить официальное письмо (с печатью и подписью руководителя) в компанию UCS с просьбой сменить дилера.
  2. Со стороны принимающего дилера - должно быть отправлено такое же письмо (со всеми регалиями) подтверждающее этот переход.
  3. При попытке зайти в DealRK (новым дилером) будет выдано сообщение о принадлежности базы предыдущему дилеру и в каталоге \RK6 будет сформирован спецфайл - REMOTE.ARE.
  4. Сформированный файл выслать туда же (в отдел лицензирования или в коммерческий отдел компании UCS).
  5. После получения отделом лицензирования всего вышеперечисленного, новому дилеру будет выслан модифицированный RAL.DAT (разового использования), который необходимо положить в каталог RK6 и снова запустить DealRK, при этом предыдущее дилерство из базы будет удалено, а новое прописано.
  6. После всего, появится возможность создать своего собственного нового Администратора, под которым можно продолжить работу.
  7. После смены дилерства можно будет использовать стандартные RAL.DAT с ФТП.

Примечание: при получении модифицированного RAL.DAT рекоммендуется воспользоваться им без промедления, так как есть привязка к дате.

Поддержка параметров кассовой системы (INIVAL, INISRV)

Начиная с версии менджерской 6.92 (кассовая часть 6.98) параметры кассовой системы могут быть определены в приложении "Редактор" (E_REST32.EXE)
 
Перед запуском кассовой системы и использованием параметров, в редакторе должны быть добавлены все кассовые сервера (меню "Списки" - "Серверы").
 
Есть два типа параметров: 
  • "Параметры кассовых станций" - содержаться в отдельном справочнике, который можно открыть кликнув правой кнопкой мыши по станции и в контекстном меню выбрать - "Параметры".
  • "Параметры кассовых серверов" - содержатся в отдельном справочнике, который можно открыть кликнув правой кнопкой мыши по серверу и в контекстном меню выбрать - "Параметры".

Справочник параметров кассовых станций хранится в файле \RK6\INIVAL.DEF, справочник параметров кассовых серверов - в файле \RK6\INISRV.DEF.

Актуальную версию справочников INIVAL.DEF и INISRV.DEF можно загрузить с FTP-сервера ftp://ftp.ucs.ru/r-keeper/versions/RK6/INIVAL  либо скачать через Центр Поддержки по адресу http://support.ucs.ru/inival_support.

Примечание: Справочники параметров INIVAL.DEF и INISRV.DEF поставляются с дистрибутивом менеджерской части RK6 , но данные в справочниках могут быть не актуальны.

Справочники INIVAL.DEF и INISRV.DEF зашифрованы и используются только менеджерским приложением "Редактор" (E_rest32.exe).

Важно! В DealRK.exe доступ к параметрам станций и серверов регулируется отдельным правом "Редактировать настройки станций".

Кассовые станции и кассовые сервера используют другой формат справочников - \DB\INIVAL.DBA  и \DB\INISRV.DBA  соответственно эти файлы, по-умолчанию, отсутсвуют в директории \DB.

Важно! Кассовый сервер не запустится без файлов \DB\INIVAL.DBA и \DB\INISRV.DBA!

Для создания файла  \DB\INIVAL.DBA  требуется изменить какой-либо параметр любой из кассовых станций и сохранить конфигурацию (нажав кнопку "OK"). Например, параметр - Общие настройки ⇒ Сервисные Параметры ⇒ Порядок обработки параметров системы (заполняется обязательно!).

Для создания файла  \DB\INISRV.DBA  требуется изменить какой-либо параметр любого из кассовых серверов и сохранить конфигурацию (нажав кнопку "OK"). Например, параметр Общие настройки ⇒ Сервисные Параметры ⇒ Порядок обработки параметров системы (заполняется обязательно!).

Обновление файлов INIVAL.DBA и INISRV.DBA на кассовом сервере происходит так же, как и других таблиц дневной базы данных (в том числе посредством RKSHARE).

Существуют параметры, которые не могут быть определены в редакторе, т.к. используются еще до инициализации механизма обработки параметров - например, параметры Network, ServerName, UnitName должны быть явно указаны в RKEEPER6.INI.

Параметры, которые не относятся к кассовой станции или кассовому серверу, должны быть явно указаны в RKEEPER6.INI - например, параметры фискальных регистраторов, библиотек расширения, различных доп. драйверов и т.д. должны быть прописаны в RKEEPER6.INI (при этом порядок обработки параметров не имеет значение).

Если какой-либо параметр для кассовой станции или кассового сервера не задан в редакторе, будет использоваться значение этого параметра по-умолчанию (или параметр, указанный в RKEEPER6.INI - в зависимости от порядка обработки параметров, см. ниже).

Параметр IniType (Порядок обработки параметров системы) должен быть обязательно определен перед запуском системы - это необходимо сделать для каждой кассовой станции и для каждого кассового сервера!

Для кассовой станции параметр IniType задается в справочнике параметров в разделе Общие настройки ⇒ Сервисные параметры ⇒ Порядок обработки параметров системы - для кассовых сервером параметр IniType задается аналогично.

Параметр IniType ("Порядок обработки параметров системы") может принимать следующие значения:

  • 0 - ("подавление значений из RKEEPER6.INI") - из RKEEPER6.INI берутся только остутствующие переменные. Неназначенные параметры считаются значениями по-умолчанию, независимо от значений в RKEEPER6.INI
  • 1 - ("приоритет серверных назначений") - из RKEEPER6.INI берутся только отсутствующие и неназначенные переменные
  • 2 - ("приоритет файловых назначений")  - из справочника берутся только отсутствующие и неназначенные переменные
  • 3 - ("игнорировать серверные значения") - используются только параметры из  RKEEPER6.INI, неназначенные параметры считаются значениями по-умолчанию, независимо от значений в справочнике 

Под "отсутствующими" параметрами имеются ввиду переменные, которых нет в справочнике (INIVAL.DEF или INISRV.DEF).

"Неназначеные" параметры - это параметры, которые есть в справочнике, но которые не были инициализированы (т.е. ни разу не были установлены в одно из значений).

Значение "по-умолчанию" - это значение, которое определено на уровне ядра системы и которое принимает параметр, если нет других источников данных.

Примечание: Если идет речь о "серверных назначениях", это может относиться как к параметрам станций, так и к параметрам серверов  - это связано с тем, что обработка справочников происходит в любом случае на уровне кассового сервера.

Приложение

Структура каталога RK6

 Ниже идет краткая структура и описание основных папок, файлов и библиотек рабочего каталога RK6:

  • Папка DB -  менеджерская база данных. Условно состоит из двух частей: Таблиц  paradox (*.DB, *.MB и их индексные файлы - *.PX). В них храняться все справочники системы RK6 и файла ARK6.UDB - накопительная база данных (формат UDB является зашифрованным, разработан компанией UCS)
  • E_rest32.frf, Monit32.frf, Report32.frf - папки содержащие печатные формы отчетов соответсвующих приложений комплекса RK6 и что не менее важно, -  ОПИСАНИЕ ПОЛЕЙ, котороые можно вывести в эти печатные формы.  Формат FRF - формат печатных форм созданных на базе втроенного редактора fast report.
  • Newdb - чистая база данных, содержащая эталонные таблицы, необходимые при апгрейде оригинальной менеджерской базы RK6.
  • TTFONTS - в старых версиях, папка содержала необходимые для установки в ОС шрифты.
  • Папка Ver - содержит файл Ver_hist.txt, в котором, описаны все изменения и обновления версий ПО.
  • GrdVkc32.dll (NOVEX32.dll - в версиях до 6.94) - поддержка драйвера лицензионного ключа.
  • RKEEPER.INI - основной конфигурационный файл.
  • RAL.DAT - поддержка дилерского захода при использовании DealRK.exe.
  • Mfc40.dll, Msvcirt.dll, Msvcrt.dll, Msvcrt40.dll, Olepro32.dll, Cfx32.ocx, chartfx.reg - библиотеки и файлы поддержки представления отчетов в графическом виде.
  • Fastrep.dll, fr_eng.dll, fr_rus.dll, FREXTF.dll -  библиотеки поддержки встроенного редактора печатных форм отчетов Fast Report.
  • *.hlp - файлы справки (вкладка \Справка или "F1" в пиложении).

Примечание!! Если после одновления r_keeper_6 до версии 6.99.6 зайти сразу в отчеты, то появится ошибка:

Во избежание этой ошибки нужно сначала зайти в редактор (E_REST32.exe), а только потом в отчеты.