Интеграция с R-keeper 6

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

Система 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

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