Данное ПО находится в постояном процессе доработки, поэтому актуальные версии следует искать в http://tracker.ucs.ru .

Введение

Установка программы осуществляется простым копированием файлов на компьютер, где будет выполнятся экспорт данных. Дистрибутив лежит на ФТП в папке ftp://ftp.ucs.ru/rk7/INSTALL/RK7_DBF/

Программа RK7_dbf предназначена для экспорта накопительных таблиц и справочников в формат DBF/DB. Утилита создает файл логов logapp.txt.

Программа состоит из rk7_dbf.exe и директорий dbf_files, db_files с шаблонами DBF/DB таблиц.

Возможны следующие способы запуска:

1) user_mode (запуск в режиме настольного приложения);

2) выгрузка в формате RK6 :server_mode (параметр '\server'). ;

3) console_mode (в качестве параметров передаются '\console', начальная и конечная даты промежутка для экспорта в формате, установленном в ОС);

4) в режиме службы ( для запуска в режиме службы необходимо запустить утилиту с параметром /install. После установки необходимо перегрузить систему или же запустить службу вручную. В директории с утилитой будет создан файл Delete_Service_rk7dbfService.bat, необходимый для удаления службы. Служба каждые 10 минут проверяет наличие невыгруженных смен и выгружает их, если во вкладке "Настройка экспорта" не настроено иначе).

Первый запуск утилиты рекомендуется проводить в user_mode для задания необходимых параметров.

В режиме user_mode настраиваются параметры подключения, выбирается папка для экспорта, категория цен и прочие настройки. При закрытии приложения все настройки сохранятся в ini-файл (rk7_dbf.ini).

Важно: Протестировано и работает с версиями 7.4.21.XXX и выше.

Важно: Версии RK7_DBF.EXE 1.0.0.26, RK7_DBF.EXE 1.0.0.68 работают с версиями 7.5.3.214 и выше.

Настройка

Для корректной работы программы необходимо:

1. Настроить строку подключения к базе RK7. Для этого во вкладке "Настройка подключения" необходимо нажать кнопку «Изменить», в открывшемся окне прописать строку соединения, указать пароль и установить параметр, разрешающий его сохранение. Во время сохранения настроек пароль и имя пользователя выделяется из строки подключения и шифруется (если он там присутствует, в противном случае пароль необходимо указать в соответствующем поле). После ввода настроек нажать кнопку «Подключить» (см. рис. 1). В момент запуска модуля, данные дешифруются и добавляются в строку подключения.

Рис. 1 - Настройка строки подключения к базе RK7

2. После подключения и перезапуска приложения во вкладке "Свойства экспорта" обновятся строки «Классификация блюд», «Тип цены», «Ресторан», "Использовать цену для экспорта" (строка "Использовать цену для экспорта" актуальна в том случае, если за смену блюдо было продано по разным ценам). В данных строках из выпадающих списков необходимо выбрать подходящие критерии экспорта (пример см. рис. 2). При выгрузке цена берется из чека. В том случае, если продаж не было, берется указанный в настройках тип цены.

Для выгрузки информации по определенному ресторану и предприятию необходимо указать их коды в строках "Код предприятия (RK6)" и "Код ресторана (RK6)" соответственно.

В зоне "Тип транзакции"(KIND, указывается через запятую) указать код транзакции бонусов.

Для выгрузки валюты в ARCheck необходимо установить галочку «Выгружать валюты в ARCheck» (не совместим с форматом rk6). Если необходимо выгружать данные с определенным кодом валют-устанавливаем соответствующую галочку и из выпадающего списка выбираем необходимое свойство кода валют «Использовать свойство кода валюты».

При необходимости использовать EXTCODE в качестве Sifr устанавливаем галочку "Использовать EXTCODE в качестве Sifr (кроме персонала и причин удаления)".

 

 

Рис. 2 - Выбор критериев экспорта

3.Во вкладке "Настройка экспорта" в  строке «Путь для экспорта файлов» указать папку, в которую будут экспортироваться данные, в зоне "Формат выгрузки" назначить формат, в котором будет производиться экспорт, выбрать структуру папок для выгрузки (при выборе режима  "название ресторана/oldres/дата" структура папок будет " папка экспорта/название ресторана/DBF", или "папка экспорта/название ресторана/DB", или "папка экспорта/название ресторана/oldres/дата"; при выборе режима "название ресторана/дата/oldres" - "название ресторана/дата/oldres", или "название ресторана/дата/DB", или "название ресторана/дата/DBF"). Также можно установить параметр "Выгружать в поле Name 128 символов". При этом в поле "Name" будет выгружаться до 128 символов (см. рис. 3).

В том случе, если выгрузку необходимо производить в определенное время, необходимо установить галочку "Экспорт по времени", указать время выгрузки. В противном случае выгрузка будет производиться каждые 10 минут.

В том случае, если выгрузку необходимо производить не за всю историю ресторана, рекомендуется установить настройку "Выгружать в режиме службы/server начиная с ..." - указать, с какого числа данные необходимо выгружать.

 

 

 

Рис. 3 - Выбор папки для экспорта

 

Для консольного режима можно задать параметр, при котором выгрузка будет осуществляться в выбранную директорию без создания новой директории с датами выгрузки.

 Если необходимо выгружать в режиме console_mode, требуется установить галочку «Выгружать по указанному пути в консольном режиме (без добавления даты)». В консольном режиме программа выгружает все смены, согласно указанным в ini-файле параметрам из промежутка дат, переданного в параметрах запуска.

Если необходимо выгружать данные, соблюдая структуру папок и логику выгрузки rk6 в режиме server_mode, необходимо установить галочку «Выгружать в формате RK6 (server/service mode)». В режиме сервера программа находит все не выгруженные смены и производит их экспорт в фоновом режиме. 

Если необходимо выгружать данные, соблюдая структуру папок и логику выгрузки rk6 в режиме user_mode, необходимо установить галочку "Выгружать в формате rk6 (user mode)".

В режиме выгрузки RK6 каждый кассовый сервер будет выгружаться в отдельную папку с оригинальным названием.

В том случае, если необходимо согласование справочников «Причина удаления», требуется нажать на кнопку «Справочники».

Если настройка производится впервые, отобразится сообщение о необходимости указать путь к справочникам Reasons.DB/Reasons_.DB из RK6. Необходимо нажать кнопку «ОК», в открывшемся окне указать путь к файлам нажать кнопку «ОК» (см. рис. 4).

 

Рис. 4 – Указание пути к справочникам RK6

Появится окно согласования справочников, в котором для каждого значения справочника RK7 в столбце «Наименование RK6» необходимо указать соответствующее значение справочника RK6, закрыть окно (см. рис. 5)

 

Рис. 5 – Настройка соответствия справочников

Для смены пути к файлам Reasons.DB/Reasons_.DB необходимо выбрать пункт «Изменить расположение справочников» в контекстном меню (после изменения пути окно «Справочники» закроется).

Если в новом справочнике нет значений старого, перед сменой справочника необходимо очистить данные при помощи кнопки «Очистить данные» в контекстном меню (см. рис. 6).

 

Рис.6 – Контекстное меню

В том случае, если не указано значение справочников RK6, то выгружаться будет «0». Если согласование не настроено совсем, то выгрузка будет производиться без согласования.

Для выгрузки данных по персоналу из RK6 необходимо во вкладке "Персонал" установить галочку "Использовать данные RK6" (см рис. 7). В противном случае данные будут выгружаться из RK7.

 

Рис. 7 - "Справочники"-"Персонал"

Для выгрузки данных по налогам из RK6 необходимо во вкладке "Налоги" установить галочку "Использовать" во вкладке "Налоги" (см. рис. 8).

Рис. 8 - "Справочники" - "Налоги"

Для согласования кассовых станций  необходимо воспользоваться кнопкой «Маппинг станций». В открывшемся окне при помощи контекстного меню нажать кнопку «Добавить». В окне «Станции» ввести идентификатор станции RK7 и соответствующий идентификатор станции RK6, нажать кнопку «ОК» (см. рис. 9)

В строке «Станция по умолчанию (для неидентифицированных станций)» по умолчанию отобразится первая введенная станция RK6. Ее можно заменить на любую другую станцию, которая будет использоваться по умолчанию.

 

Рис. 9 - Согласование станций RK6 и RK7

В консольном режиме программа выгружает все смены согласно указанным в ini-файле параметрам из промежутка дат, переданного в параметрах запуска.

4. Во вкладке "Экспорт"  том случае, если необходимо выгружать все данные - установить галочку напротив «Все». В случае если необходимо выгрузить меню и модификаторы – установить галочку напротив «Только меню и модификаторы». В случае, если не требуется выгружать меню и модификаторы – установить галочку напротив «Все, кроме меню и модификаторов». В зонах «Начальная дата» и «Конечная дата» необходимо выбрать диапазон дат, за который необходимо экспортировать данные (см. рис. 10).

 

 

Рис. 10 – Диапазон дат, за который необходимо осуществить выгрузку

5. По умолчанию меню язык меню приложения - английский. Смена языка интерфейса производится при помощи файла локализации. Путь к файлу локализации необходимо указать во вкладке "Прочее" в зоне"Язык" (см. рис. 11). Перевод на необходимый язык производится с помощью приложения  Langer. Файл локализации должен находиться рядом с rk7_dbf.exe.

Возможно расширенное логирования работы приложения при запуске в режиме службы. Для этого необходимо установить галочку "Расширенный лог (service mode)" (в расширенном логе указывается список смен, готовых к отправке, и список смнен не готовых к отправке) (см. рис. 11) .

Рис. 11 - Вкладка "Прочее"

6. Начиная с версии RK7_DBF.EXE 1.0.0.68, появилась возможность выгрузки файлов сразу на FTP-сервер. Для это во вкладке «Настройки FTP» (см. рис.12) необходимо:

- отметить галочку в строке «Загружать файлы на FTP»;

- ввести адрес FTP-сервера в строке «FTP-сервер»;

- ввести порт в строке «Порт» (по умолчанию присвоен номер «21», но при необходимости, может отличаться);

- ввести логин пользователя FTP-сервера в строке «Пользователь»;

- ввести пароль пользователя FTP-сервера в строке «Пароль»;

- ввести название каталога на сервере, куда будут выгружаться файлы, в строке «Каталог»; если ничего не указано, то файлы будут загружаться в корневой каталог; если в корневом каталоге нет каталога с введенным названием, то он будет создан.

Рис. 12 - Вкладка "Настройки FTP"

7. Нажать кнопку «Экспорт».

 

Примечания

В системе Rkeeper V7 идентификаторы элементов больше 65000, поэтому в программе применяется перекодирование. Соответственно SIFR в программе и фаиле DBF не будут совпадать.

Однажды назначенный на объект SIFR, всегда останется таким же.

В качестве кода «Группы станций» передается код «Категории заказа».

В новой версии у модификаторов есть цена.

Все сотрудники выгружаются с типом менеджер.