Импорт себестоимости из SH5 через Feature Server

Введение

Из r_k StoreHouse Pro в r_keeper_7 можно импортировать себестоимость и другие данные в режиме онлайн. Для этого необходим Feature Server, идущий в комплекте с интерактивными отчетами.

Важно!

Для корректной работы импорта необходима версия r_k StoreHouse Pro 5.107 и выше, а так же WebAPI версией 1.16.3

Перед настройкой импорта, у вас должно быть установлены и запущены:

MS SQL Server 2012 или старше
WebAPI 1.16.3
UCS Common server
Плагин интерактивных отчетов
Feature Server (FS). Минимальная версия Feature Server для работы импорта — 1.39.1.7. Лучше всего скачать последнюю версию с FTP-сервера по адресу: ftp://ftp.ucs.ru/rk7/other/IR_reports/
- Пропишите параметр MasterServer=1 в файле настроек Feature Server IRReportsFSPrj.ini перед запуском
```
i_Guid={D54BA83D-EA0F-4ADC-834D-70C336259F6D} 
instance_name=171848 
MasterServer=1
```
  XML

Настройки в менеджерской станции

Для работы импорта необходима настроенная связь с MS SQL и интерактивных отчётов и установленный сервер WebAPI 1.16.3, подключенный к r_k StoreHouse Pro.

Перейдите в меню Расширения > База данных
1. Если видите ошибку Недопустимое имя объекта PLG_OBJECTS
2. Откройте обозреватель MS SQL и выполните скрипт:
```
CREATE VIEW [dbo].[PLG_OBJECTS] AS
SELECT
GUIDSTRING
,CODE 
,NAME 
,ALTNAME 
,STATUS 
FROM dbo.RESTAURANTS 
WHERE (STATUS = 3)
```
  XML
  Ошибка должна исчезнуть.
Нажмите правой кнопкой мыши на раздел Все и выберите пункт Создать новую группу баз данных. Переименуйте её по желанию.
Подобным образом нажмите на группу и создайте новую базу данных
Находясь в меню группы, выберите базу данных в правом меню и заполните поля:
1. Название
2. В разделе Основное укажите данные для подключения к серверу WebAPI 1.16.3:
  1. Имя пользователя r_k StoreHouse Pro
  2. Пароль пользователя r_k StoreHouse Pro.
    
    Важно!
    У пользователя r_k StoreHouse Pro обязательно должен быть пароль.
  3. Данные сетевого подключения к WebAPI, в формате IP:PORT, например: localhost:9999
3. В разделе Другое:
  1. Поставьте галочку напротив SH5
  2. Заполните поля Параметр Начальная дата и Параметр Конечная дата
4. В разделе Настройки импорта StoreHouse
  1. В полях Валюта и Группа товаров укажите параметры для импорта данных.
    
    Примечание
    Валюта и группа товаров доступны для выбора только при удачном подключении к серверу r_k StoreHouse Pro
  2. Для корректной работы импорта не заполняйте поле Место реализации.
  3. Если вr_k StoreHouse Pro производится спец учет, поставьте галочки в зоне полях Специальный учет и Рассчитывать в ед. изм. "для расхода"
5. Нажмите сохранить
Подключение настроено, теперь его необходимо проверить. Нажмите правой кнопкой мыши на базу данных в меню слева и выберите пункт Проверка соединения с БД...
- Если подключение настроено верно, появится сообщение:
- Если соединение настроено неверно, то появится сообщение:
Теперь необходимо привязать объект к созданной базе данных в списке слева. Для этого нажмите правой кнопкой мыши на поле справа и выберите пункт Добавить новый объект

Нажмите Добавить и сохраните изменения.
Откройте r_k StoreHouse Pro и убедитесь, что в контрагентах есть хотя бы 1 подразделение. Если его нет — создайте.
Делается это в меню Словари > Контрагенты > Подразделения.

Если предприятия нет — создайте.
Перейдите в Меню > Классификации блюд и скопируйте GUID классификации, которую планируете использовать. В классификации обязательно должны быть вложенные категории.
1. Остановите Feature Server и откройте его файл настроек — IRReportsFSPrj.ini
2. Добавьте в блок [FS_ADDITIONAL] строчку:
```
SH4_Class={B07330CD-D17E-4151-AC2F-DE341C163C7D}
```
  XML
3. Где после знака "=" вставьте скопированный GUID классификации. Если секция [FS_ADDITIONAL] отсутствует, добавьте.
4. Сохраните файл и запустите Feature Server
Перейдите в меню Настройки > Центральный офис > Рестораны, и нажмите правой кнопкой мыши на ресторане, который необходимо связать со StoreHouse. Выберите пункт Действия > Редактор связи со складом
Выберите необходимые категории. В поле Store House 4 их свойств укажите подразделение, с которого будет производиться выгрузка.
Не обращайте внимания на название поля, всё будет работать нормально.
Если классификации появились, но выбор подразделения пустой, то проверьте:
- Есть ли в базе r_k StoreHouse Pro подразделения? Они должны быть, хотя бы 1
- Если подразделения в r_k StoreHouse Pro есть, то в базе данных SQL имя_базы_STAT_SH4_SHIFTS_FOODCOST в таблице dbo.STAT_SH4_SHIFTS_CORR должен быть их список. Поле TYPECORR у подразделения должно быть равно 0
- Если в SQL нет записей с TYPECORR=0, то очистите папку с логами Feature Server, измените имя подключения к базе r_k StoreHouse Pro и нажмите кнопку сохранить. Таким образом, FS должен повторно запросить данные у r_k StoreHouse Pro.
Сохраните и закройте менеджерскую станцию.
В конфигурационный файл плагина интерактивных отчётов RK7MAN\plugins\SchRepPluginClient\SchRepPluginClient.ini добавьте текст в конец файла:
```
[PLG_ACC] 
use_accounts = 1 
[PLG_PLAN] 
use_plan_params = 1 
[PLG_SH] 
use_sh_params = 1
[FS_AGREGATE]
SH4Agregate=1
```
XML
Если какая-то из секций есть, то вставляйте настройку в нее. Подробнее о настройке SH4Agregate=1 читайте ниже.
Сохраните и запустите менеджерскую станцию.

Запуск импорта

Запустите серверы:

Common
Feature
WebAPI 1.16.3
StoreHouse 5

И откройте менеджерскую станцию.

Если все настройки правильные, Feature Server начнёт загружать данные из r_k StoreHouse Pro в r_keeper_7 за выбранный период:

Если в логе Feature Server есть строчки Date... Invoice load, значит всё работает правильно.

Пересчитать данные r_k StoreHouse Pro можно зайдя в Интерактивные Отчеты (ИО) > Отчеты по безопасности > Системные операции и нажав кнопку Пересчитать данные SH.

Обновление Feature Server

Если у вас установлена старая версия плагина интерактивных отчетов и Feature Server, их лучше обновить. В ранних версиях FS есть требование о необходимости установки FS и SQL на одном компьютере, но с версии 1.39.1.7 это не актуально.

Для обновления Feature Server и плагина:

Скачайте последнюю версию с FTP-сервера ftp://ftp.ucs.ru/rk7/other/IR_reports/
Распакуйте архив в удобное место. Скопируйте с заменой все файлы в папку установленного FS. Файла настроек в архиве нет, поэтому существующие настройки не потеряются.
Закройте менеджерскую станцию и скопируйте содержимое архива из папки plugins в одноименную папку менеджерской станции
Запустите FS и менеджерскую станцию.

Решение проблем

Проблема: после обновления r_keeper на 7.6.5.459 перестали работать Feature отчеты

Причина: не заполняется таблица STAT_SH4_SHIFTS_CORR

Решение: обновите Feature Server до версии 1.39.1.7 или старше