Введение

Food Factory (сокращённо FF) - это дополнительный модуль для SH5, который позволяет работать с интерфейсом пользователя через браузер. 
Для работы FoodFactory у вас должны быть предварительно установлены и запущены:

Модуль FF требует лицензирования. Для его использования, заранее получите мастер-лицензию на сервере лицензирования. Проверка лицензии происходит через интернет, поэтому сервер FoodFactory должен иметь доступ в интернет.

По умолчанию FoodFactory работает на 2 портах:

  • 7000 — HTTP
  • 7001 — HTTPS 

По желанию, один из протоколов можно отключить в настройках после установки.

Установка Food Factory

Скачайте установщик FoodFactory с FTP-сервера ftp://ftp.ucs.ru/StoreHouse 5/FoodFactory/.  Запустите его и выберите язык. Установите программу по скриншотам ниже:

Прочтите и примите условия пользовательского соглашения.

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

Укажите путь установки и имя экземпляра сервера.

Укажите настройки подключения к Web API и к SH5: имя пользователя и пароль. Укажите локальный порт для доступа к FF. Нажмите кнопку Тест для проверки соединения.

Нажмите Установить.

Установка завершена. Нажмите Завершить.

Настройки подключения к серверам SH5 и Web API сохранятся в файле appsettings.json, по умолчанию расположенном по адресу C:\Program Files (x86)\UCS\Food Factory\FF\appsettings.json Настройки можно поменять, отредактиров файл как текстовый документ. Исполняемый файл сервера называется FF_API.exe и находится в той же папке.

Food Factory устанавливается как служба Windows. Служба называется по шаблону: FoodFactory: [имя экземпляра]. На компьютере можно установить несколько экземпляров FF. Экземпляр FF - это адрес, по которому открывается FoodFactory. Список экземпляров можно изменять в файле hosting.json

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

Проблема: служба FoodFactory не устанавливается и не запускается
Решение: установить обновления KB2999226 и KB2533623

В Windows 10 есть все нужные библиотеки и установка проходит без проблем, но в Windows 7/2008 служба FoodFactory не устанавливается и не запускается. Для диагностики запустите из командной строки файл FF_API.exe, он находится в корне папки FoodFactory. Если при запуске FF_API.exe ругается на hostfxr.dll, то нужно последовательно установить 2 обновления.

После перезагрузки должно заработать. 

Настройка Food Factory

Food Factory доступна по адресу [IP_сервера:порт сервера]. По умолчанию, это http://127.0.0.1:7000.

Вы попадёте на страницу авторизации. Введите ваш Dealer ID и пароль. Вас перенаправит на страницу лицензирования FF.

Важно: Для работы FoodFactory сам StoreHouse должен быть пролицензирован.

Для того, чтобы пользоваться FF, у вас должна быть лицензия R-Keeper модуль FoodFactory (12 мес) ПО. Для лицензирования FF:

  1. Укажите желаемую дату или нажмите кнопку ПОЛУЧИТЬ, чтобы выбрать максимально доступную дату.
  2. Нажмите кнопку ПОЛУЧИТЬ ЛИЦЕНЗИЮ.
  3. Система проверит наличие у вас лицензии, и если всё хорошо, вы увидите сообщение, что Лицензия успешно получена:

После получения лицензии, откройте FoodFactory по адресу http://127.0.0.1:7000/#!/login. Зайдя по этому адресу, вы увидите окно авторизации. В нём нужно ввести логин и пароль от вашего сервера SH5. 

Для авторизации пользователь должен иметь на это право, явно указанное в SH5. Чтобы его добавить:

  1. Откройте клиент Sdbman.exe и перейдите в меню Пользователи > Список пользователей
  2. Откройте Свойства пользователя и перейдите во вкладку StoreHouse.
     
  3. В нижней части окна включите право Разрешить передачу данных в StoreHouse из FoodFactory

     
  4. Если вы хотите, чтобы пользователь мог изменять настройки SH5 через FF, то поставьте галочку Разрешить доступ к настройкам FoodFactory. 
    У пользователя появится возможность заходить в настройки. В них можно изменить настройки лицензии, печати и другие. 

Food Factory готова к работе. 

Работа в Food Factory

Зайдите в Food Factory. Если сервер установлен локально, то адрес FF будет http://127.0.0.1:7000/#!/login или http://localhost:7000/#!/login. Если FF установлена на удалённом сервере, используйте IP-адрес этого сервера.
После ввода логина и пароля SH5, вы попадёте в главное меню FF. Все доступные операции находятся здесь. Чтобы попасть в настройки, нажмите шестерёнку. 

В SH5 вы можете создавать или изменять макеты документов. Приложение ReportDesigner.exe устанавливается вместе с программой. По умолчанию, оно находится в папке C:\Program Files (x86)\UCS\Food Factory\FF\ReportDesigner.exe. Готовые макеты документов расположены в подпапке C:\Program Files (x86)\UCS\Food Factory\FF\Rpt\.