FoodFactory Installation

Introduction

FoodFactory (abbreviated FF) is an additional module for SH5 that allows you to work with the user interface through a browser.
For FoodFactory to work, you should have installed and running:

• StoreHouse 5 server
• WEB API II server

The FF module requires licensing. To use it, get a master license in advance on the license server. The license is checked via the Internet, so the FoodFactory server must have internet access.

By default, FoodFactory runs on 2 ports:

• 7000 — HTTP
• 7001 — HTTPS

If desired, one of the protocols can be disabled in the settings after installation.

Installing the Food Factory

Download the FoodFactory installer from the FTP server ftp://ftp.ucs.ru/StoreHouse 5/FoodFactory/. Launch it and select the language. Install the program according to the screenshots below:

The connection settings for SH5 and Web API servers will be saved in the appsettings.json file, by default located at C:\Program Files (x86)\UCS\Food Factory\FF\appsettings.json. You can change the settings by editing the file as a text document. The server executable file is called FF_API.exe and it is located in the same folder.

Food Factory is installed as a Windows service. The service is named according to the template: FoodFactory: [instance name]. You can install several FF instances on your computer. The FF instance is the address at which the FoodFactory is opened. The list of instances can be changed in the hosting.json file.

Troubleshooting

Problem: The FoodFactory service cannot be installed and launched
Solution: Install updates KB2999226 and KB2533623

In Windows 10, there are all the necessary libraries and the installation goes without problems, but in Windows 7/2008, the FoodFactory service is not installed and does not start. For diagnostics, run the FF_API.exe file from the command line, located in the root of the FoodFactory folder. If at FF_API.exe launch, an error connected hostfxr.dll appears, install 2 updates sequentially.

• Install KB2999226 and restart the PC
  x86 https://www.microsoft.com/en-us/download/details.aspx?id=49077
  x64 https://www.microsoft.com/en-us/download/details.aspx?id=49093
  

After the restart, FF should work.

Setting Up Food Factory

Food Factory is available at [ip_server:server port]. By default, this is http://127.0.0.1:7000.

The authorization page will open. Enter your Dealer ID and password. You will be redirected to the FF licensing page.

In order to use FF, you must have the r_keeper_7 FoodFactory module license.

To license FF, do the following:

1. Enter the desired date or click GET to select the maximum available date
2. Click GET A LICENSE
3. The system will check whether you have a license, and if everything is fine, you will see a message that the License was successfully obtained.

After receiving the license, open FoodFactory at http://127.0.0.1:7000/#!/login. The authorization window will appear. Enter the username and password of your SH5 server.

For authorization, the user must have the right to do this, explicitly specified in SH5. To add it:

1. Open Sdbman.exe and go to Users > User list
   
   
2. Open User properties and go to the StoreHouse tab
   
   
3. At the bottom of the window, enable the rightAllow data transfer to StoreHouse from FoodFactory
4. If you want the user to be able to change the SH5 settings via FF, then check the box Allow access to the FoodFactory settings.
   The user will have the opportunity to go to the settings. In them, you can change the license settings, printing, and others.

The Food Factory is ready to work.

Work in the Food Factory

Go to the Food Factory. If the server is installed locally, the FF address will be http://127.0.0.1:7000/#!/login or http://localhost:7000/#!/login. If the FF is installed on a remote server, use the IP address of this server.
After entering the login and password SH5, you will be taken to the main FF menu. All available operations are located here. To get into the settings, click the gear.

In SH5, you can create or change document layouts. The ReportDesigner.exe app it is installed together with the program. By default, it is located in the folder C:\Program Files (x86)\UCS\Food Factory\FF\ReportDesigner.exe. Ready-made document layouts are located in a subfolder C:\Program Files (x86)\UCS\Food Factory\FF\Rpt\.

 Working with the Web API directly     Weight labels printing