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

Система StoreHouse v4 (далее SH4) импортирует из R-Keeper v6 (далее RK6) следующие данные:

  • меню, на основании которого в SH4 формируется справочник товаров;
  • продажи, на основании которых формируются документы расхода (после проведения - расходные накладные).

В статье описано два варианта импортирования данных при помощи штатной утилиты импорта из состава SH - importRk.exe:

  1. Запуск и работа утилиты импорта в настольном-режиме;
  2. Запуск и работа утилиты импорта в консольном-режиме. Так называемый автоматический импорт, отрабатывающий автоматически, например сразу после приема данных в RK6 (т.е. сразу после завершения работы утилиты Append32.exe).

Примечание: существуют и другие варианты приема данных в SH4 в том числе и из сторонних систем.

ImportRk.exe - Настройка импорта для работы в настольном режиме

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

  • загрузить с FTP ftp://ftp.ucs.ru/r-keeper/Tools/BDE/bde5.01.rar и установить на клиентском компьютере BDE 5.х
  • запустить приложение \SH4\IRkSetup.exe, подключиться к требуемому серверу и выбрать соответствующую товарную группу (по умолчанию в базе данных существует две группы - "Товары" и "Меню ресторана")

 

Рис. Параметры импорта данных на примере IRkSetup.exe версии 4.57

 

Примечание: В справочнике товаров SH4 можно добавить произвольное кол-во корневых товарных групп (например, "Доп. блюда" или "Блюда Ресторана  №2" и т.д.) 

Важно: Так как в SH4 в справочнике товаров содержится справочник блюд (корневая вершина - "Меню ресторана") и справочник полуфабрикатов/ингредиентов (корневая вершина - "Товары"), надо иметь ввиду, что импорт из RK6 настраивается только на отдельную корневую вершину ("Меню ресторана"). Таким образом, справочник "Меню ресторана" в SH4 будет полностью синхронизирован со справочником "Меню" в RK6 (RK7).

Исходя из этого возникают следующие ограничения:

  • создание/редактирование/удаление блюд происходит только в RK6 - в SH4 эти изменения будут приходить автоматически при каждой операции импорта
  • при использовании импорта данных из RK6 или RK7, в SH4 нельзя вручную создавать или редактировать блюда в справочнике "Меню ресторана"

 

  • заполнить параметры импорта для выбранной товарной группы:
  • StoreHouse использует словари SH HeadOffice - принудительное отключение импорта словарей, установить в случае использования StoreHouse HeadOffice
  • Словари / Путь - путь к директории с базой данных справочников менеджерской RK6, может быть указан как локальный, так и сетевой путь
  • Словари / Тип источника - для импорта справочников доступно только значение Paradox
  • РасходПуть - путь к директории с накопительной базой менеджерской RK6, может быть указан как локальный, так и сетевой путь
  • Расход / Тип источника - формат накопительной базы - для версий менеджерской 6.75 и выше указать UDB, для версий ниже - Paradox
  • Расход / Тип группировки - установить требуемый тип группировки для формируемых документов расхода блюд
  • Расход / Разбивать по складам - установить требуемый тип группировки для формируемых документов расхода блюд

Примечание: Доступные параметры импорта зависят от версии IRKSetup.exe  (и соответственно версии SH4) - выше приведены основные параметры, более детальная информация по остальным параметрам содержится в руководстве пользователя StoreHouse v4

 

  • в файле RKEEPER.INI из рабочего каталога \SH4 прописать пути к базе данных справочников (Alias1) и накопительной базы (Alias2) - значения этих параметров должны в точности соотв. значениям соотв. параметров, заданных в RkSetup.exe
[Common]
Alias1=C:\RK6\DB
Alias2=C:\RK6\DB
  • скопировать файл RKLOGIN.DLL из рабочего каталога \RK6 в рабочий каталог \SH4 - данная операция требуется для корректного взаимодействия с базой данных ARK6.UDB

Важно: Начиная с версии StoreHouse 4.95 не требуется копировать библиотеку RKLOGIN.DLL - необходимо использовать файл, поставляемый по-умолчанию в дистрибутиве.

  • с помощью приложения Disp32.exe из состава менеджерской RK6 завести нового пользователя с именем sklad и паролем sklad и дать ему единственное право "Экспорт в склад"
  • запустить приложение \SH4\ImportRK.exe, проверить и продемонстрировать пользователю работу импорта данных

ImportRk.exe - Настройка импорта для работы в консольном режиме

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

Принцип работы

После выполнения операции "Закрытие дня" в приложении Append32.exe, произойдет автоматический запуск утилиты импорта (в консольном режиме), которая выполнит импорт справочников и расхода практически так же, как если бы отработала при запуске в "desktop"-варианте. После завершения операции будут показаны результаты импорта на экране.

Версионность

Данный функционал работает начиная с версий ПО:
  • Менеджерская RK6 - 6.79g и выше.
  • SH4 - 4.14 и выше.

Настройка RK6

В "Менеджерской RK6" в конфигурационном файле RKEEPER.INI в разделе [Appender] прописать новую строку следующего вида:

[Appender] 
...
PostEXE = PostExe=c:\UCS\SH4_RK6\ImportRk.exe 127.0.0.1:pTa4499 99 42520 0
AutoClose=Yes  - если Yes - приложение закроется само.
...

- где:

  • PostExe=c:\UCS\SH4_RK6\ImportRk.exe - полный путь с указанием запускного файла утилиты ImportRK.exe
  • 127.0.0.1:pTa4499 - строка подключения к серверу SH. Должна выглядить так же как и в реестре при настроенном в штатаном режиме импорте:

Рис. - Параметры настроенного импорта в реестре. Строка подключения к серверу и другие настройки.

  • 99 - указать две последние цифры кода ресторана. Их же, потом нужно указать и в IrkSetup.exe в соответствующем поле (см.раздел - "Настройка SH4").
  • 42520 - это дата с которой импорт начнет проверку и отгрузку данных по расходу блюд. Дата вписывается в виде числа. Число - это количество дней между датой 01.01.1900 и той датой от которой нужно начинать импортировать документы расхода. Рассчитать нужное значение можно например через онлайн калькулятор дат - http://planetcalc.ru/274/
  • Например значение - 42534 - будет соответствовать дате 15.06.2016. 
  • 0 (или 1) - пытаться или не пытаться после приема расхода, автоматически провести документы (рассчитать расход) в SH.

Настройка SH4

Из состава клиентского ПО SH4 запустить приложение IRkSetup.exe и дополнительно к стандартным настройкам импорта (см.раздел выше) добавить следующие настройки:

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

  • Имя пользователя и пароль - указать имя пользователя и пароль из базы данных SH;
  • Код ресторана - указать тот же что указан был указан в строке PostExe (см.раздел выше);
  • В разделе "Автоматические настройки создания накладных" можно включить (при необходимости) параметр "Использовать замены при создании комплектаций";
  • В поле "Код корреспондента для расходных накладных" вписать код корреспондента расхода (любой символ или цифры).