Введение

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

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

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

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

  • user_mode (запуск в режиме настольного приложения);
  • выгрузка в формате RK6 :server_mode (параметр '\server'). ;
  • console_mode (в качестве параметров передаются '\console', начальная и конечная даты промежутка для экспорта в формате, установленном в ОС);
  • в режиме службы ( для запуска в режиме службы необходимо запустить утилиту с параметром /install. После установки необходимо перегрузить систему или же запустить службу вручную. В директории с утилитой будет создан файл Delete_Service_rk7dbfService.bat, необходимый для удаления службы. Служба каждые 10 минут проверяет наличие невыгруженных смен и выгружает их, если во вкладке "Настройка экспорта" не настроено иначе).

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

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

Важно

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

Использование 2 налоговLink to Использование 2 налогов

Утилита корректно работает только с 1 налогом.

Если у вас используется 2 и более налогов, то записи будут дублироваться. Это особенность программы, учитывайте при работе с ней. 

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

То есть перед выгрузкой укажите только один налог, который и будет показан при выгрузке. При этом в таблицу arCheck будет попадать только одна запись с выбранным налогом.

Настройка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  •  отметить галочку в строке «Загружать файлы на FTP»;
  •  ввести адрес FTP-сервера в строке «FTP-сервер»;
  •  ввести порт в строке «Порт» (по умолчанию присвоен номер «21», но при необходимости, может отличаться);
  •  ввести логин пользователя FTP-сервера в строке «Пользователь»;
  •  ввести пароль пользователя FTP-сервера в строке «Пароль»;

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

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

Примечания

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

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

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

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

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