Introduction

Guest Screen (GS) is a new version of the second screen.

Hotkeys:

• F11 — enables/disables full-screen display
• F5 — update
• Ctrl+F5 — refresh without cache

System Requirements

The minimum system requirements:

• OS — Windows 7 and older, operation not guaranteed for Windows XP
• 1 GHz processor frequency
• 512MB RAM
• 200MB HDD
• Net Framework 4. Download: http://microsoft.com/ru-ru/download/details.aspx?id=3556
  • Windows XP or installed Net Framework 4 requires Service pack KB2468871
  • Windows 7 embedded requires Service pack KB2533623
• Visual C++ redistributable 2013 libraries. Download: https://www.microsoft.com/ru-RU/download/details.aspx?id=40784.
  In case the Please install the "VC redist 2033" error occurs, install the x86 version.
• These ports must be open on the server:
  • 443 to access the https://l.ucs.ru and https://weblate.ucs.ru/
  • 60606 to access the licensing system.

Installation

Download the installation file from the FTP server at ftp://ftp.ucs.ru/rk7/other/Guest_Screen/.

Starting with GuestScreen 1.0.0.68, you can choose one of three desktop themes:

• Bakary
• Cafe
• Pizza

These themes are available with the following screen resolutions:

After installation, the GS client shortcut will appear on the desktop.
The first launch of GS must always be performed as an administrator. If you have installed GS to Program Files, you will always have to run it as administrator.

After installation, go to Settings > Modes and check for a template of modes and scenarios in the GS settings. The list should contain 7 standard modes. If there are none, import the templates.

Licensing

The guest screen requires licensing. The license is purchased for a year.
On the licensing server, it is called the R-Keeper module Guest Screen 12 months of software. The detailed process of obtaining licenses is described in the article about the licensing system.

Run GS. In the window that opens, enter your Dealer ID.

First, GS needs to be activated. To activate the license, the object must have a master license. If you do not have it, get it.
If there is no master license, an error will appear:

Select the object where you want to activate the license.

After selecting the object, click Get a new and select master license. Click Generate.

If you need to remove the license, you must also run GS from the administrator.
If you need to link an existing license, select Link an existing license and select an available master license from the list.

Click Binding.

Changing license settings

You can change the licenses. To do this, go to Settings > License and log in as a dealer.

Here you can choose another license or generate a new one.

Setting up communication with r_keeper 7

Driver update

RK7 and GS integration requires the HTTP Order Notify driver 18+ version. As the current assembly does not contain it yet, it should be updated manually. To do this, perform the following steps:

1. Stop the reference server and the cash server
2. Download the httpnotf.udb file from the attached files or from FTP: ftp://ftp.ucs.ru/rk7/other/KDS_PRO/Extra_Files/
3. Copy the httpnotf.udb file to [RK7 installation folder]\base\workmods with the replacement
4. Start the r_keeper 7 servers

Manager station settings

Open the manager station and go to Service > Stations and devices.

Enable the use of the HTTP port on the cash server. Specify a free port in the HTTP Data Port field and do not check the Use Free Listen Port box.

Then, set up the HTTP order notify drive.

For r_keeper 7.6.5 and later

Since version 7.6.5.371, HTTP Order Notify settings were moved from the Drivers tab to the Properties. !

Select the desired cash server and add the HTTP order notify driver to it. Enter the settings:

• Log File — log file name
• Log Level — the logging level. It can take the values 0...2, where 0 is only errors, and 2 is the most detailed log
• DestURLs — GS connection string. Specify the IP and port of the GS server in the line below according to your data:

http://   

172.22.25.64   

:   

2121   

/api/httpNotify/postOrders​

• Make sure that the driver version is 18 or older:

• Link the created interface to the logical one in the menu Service > Interfaces
  
• In the HTTP restrictions > XML Interface section, specify the HTTP Access privilege. If there is no such privilege, click the button  and create it.

• Save and restart the cash register server.

Go to the menu Staff > Employees > and create a user in the HTTP Access role, without using Russian letters in the name. Make sure that the role has all the rights.
Save the settings and restart the cash register server.

Setting up in Guest Screen

Launch GS and tap 5 times in the upper-right corner of the screen. When clicked, a white circle should appear.

After 5 clicks, the modes window will open.

To open the menu, click the button 
To go to settings, click the gear in the upper-right corner.

You will be taken to the connection settings. Specify here the data for connecting to the cash register server via the HTTP interface.

1. XML-int.: address — the IP address of the cash register server
2. XML-int.: port — HTTP port of the cash register server
3. RK7: login — the name of the user from the HTTP-Access group
4. RK7: password — this user's password
5. Click Check. The system will check the connection and display a message, depending on the result.
   1. ​If the data is entered correctly, a message about the established connection will appear:
   2. If you enter your username and password incorrectly, you will see the Unauthorizederror:
   3. The error An error occurred while sending the requestmeans that the connection settings to the cash server are specified incorrectly. Check the IP and connection port.
6. After successful connection, the code of the restaurant and the cash register will be downloaded from the cash register server. Select the appropriate sales registers from which you want to receive orders in the field Cash register code

If the sales register is not displayed, click Update

1. Optionally, specify the logging level and the synchronization frequency with r_keeper_7
2. Click Save 
3. Connection setup is complete.

Update

The Guest Screen is updated via the installer.
If you have version 0.0.0.x installed, be sure to delete the gs.db database file. It is in the root folder of the installation with GuestScreen.exe

Run the installer, the system will detect the old version and offer to update it:

Import Templates

After the update, you need to download a new standard template. Download the template file from the FTP server using the link ftp://ftp.ucs.ru/rk7/other/Guest_Screen/. The template file has the .exp extension, for example, GS-UCS-0.0.1.33.exp.
Open GS and go to settings, tab Common

Select the template file in the Upload Template and Settings field. Check both boxes and click Import:

The standard templates will be loaded into GS.

Displaying content

Display Settings

In the settings, select Screens section

Here you can select the monitor to display the content and the resolution.

Standard Settings

There are several concepts describing content display on the screen in GS:

• Modes — this is the mode of operation of the cash register;
• Scenarios — a sequence of conditions under which scenes will be shown;
• Scenes — design of the content that will be shown according to the scenarios.

GS has ready-made modes by default:

• Standby mode (before the cashier registers)
• Order. Creating a new one
• How the screen works with a cash register that is not running
• Order. Dishes not selected
• Order. Adding dishes mode
• Order. Calculation and payment status
• Order. Receipt printing

And scripts:

• Mode1 – Standby mode. It is applied to the checkout where there is no user authorization.
• Mode11 – Order. Creating a new one. Displays an image when the cash register is available and ready to accept the order;
• Mode18 – Operation of the screen with an empty cash register. Displays the image on the screen when the connection with the cash register is lost;
• Mode2 – Service mode (cashier is registered). Activated when the user is logged in at the checkout;
• Mode32 – Order. Dish adding mode. Displays images of dishes on the screen when they are added at the checkout;
• Mode4 – payment scenario. Displays the order receipt with the total payment amount;

Scenes

Scenes are content that is shown according to the conditions of the scenarios. Accordingly, create scenes before creating scripts.

1. To create a scene, go to Scenes
2. Click Add 
3. Enter the name of the scene and select its type. It is possible to add videos. The video should be located at \Front\media\video. Its size depends on the computer capacities. If the video slows down during playback, it means that the video size is too large for this computer.
4. Upload the selected content. For example, choose the type of scene — The image. Download the file by clicking Select an image
   
5. Click Browse and select the file on your computer. The file will be uploaded to GS. Click on the desired image with the mouse.
6. Adjust the display settings: stretch, align, size
7. Click

to create a scene.

1. The scene is ready, you can move on to creating a script.

Scenarios

Make sure that you have all the default scripts. After installation, there should be 6 of them. If there are no scripts or they are partially installed, you need to import standard templates.
Consider the Order mode32 scenario, i.e. the mode of adding dishes. Go to the Scripts section and click on the pencil next to the script you want:

You will be taken to the script editing window. Here you can create and delete content display conditions. The conditions are checked sequentially from top to bottom and the first suitable one will be met.

Create a new condition by clicking the button 

1. Specify the name of the script;
2. Select the desired scenes in the blocks;
3. Set up the conditions for displaying the scene. You can create conditions based on:
   • The availability of dishes from the desired categories in the order
   • The absence of dishes from the desired categories in the order
   • The last dish from the categories
   • Availability of dishes with codes in the order
   • Absence of dishes with codes in the order
   • The last dish with codes

Important!

Early versions of GS request data from RK7 at the time of launch. Therefore, if there is a connection to the cash server, and the dish data is not shown, restart GS.

1. Specify the restaurant codes to apply the created script to;
2. Specify the business periods during which this scenario will be executed;
3. Select the display model:
   • Show after payment
   • Show before payment
   • Show always
4. Click the button 

Let's create an example script.

In this scheme, the first checked condition is Salads. If there is no salad in the order, the following condition will start to be met — Soups. If the order contains a dish with soup, this condition will display an image with certain settings. If the order does not include a dish with soup, then the following condition will be fulfilled, located below the list.
If the order contains soup and salad, the condition will be displayed on the screen Salads, because this condition is located above the condition Soups and has a display priority. If necessary, the conditions can be reversed by clicking on the up or down arrow .

The Default condition can be placed below all the created conditions, so that it fulfills those dishes that do not fall under any condition.

Consider the first condition Salads. Go to the condition editing mode Salads, tap the pencil mark  
Select needed dishes in the field Presence of dishes with codes in the order. Change the rest of the settings as you see fit. Save the settings.

Make settings for the condition Soups:

Now, if an order with a salad is time-stamped at the cash register, the order with the scene settings will appear on the screen.

If the soups are in the order, we will see the following screen with the order:

The soup condition settings are applied first since the soup "borsch" was added to the order earlier than the salad and it has a display priority.

 Configuring the Drive Thru system    Printing a QR code on a receipt for payment of non-cash tips