Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

  • Bakary
  • Cafe
  • Pizza

Image RemovedImage Added

These themes are available with the following screen resolutions:

For landscape orientation, px

For portrait orientation, px

800*600600*800
1024*600600*1024
1024*768768*1024
1024*12801280*1024
1366*768768*1366
1440*900900*1440
1600*900900*1600
1920*10801080*1920

1280*800

800*1280

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.

...

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 Link licenseBinding.

Changing license settings

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

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

Setting up communication with r_keeper 7

...

Driver update

RK7 and GS integration requires the HTTP Order Notify driver 18+ version. Since it is not yet in the actual assembly, you need to update it with your handsAs the current assembly does not contain it yet, it should be updated manually. To do this, perform the following steps:

  1. Stop the directory reference server and the cash register server;
  2. Download theudb filefrom Download the httpnotf.udb file from the attached files or from FTP:   ftp://ftp.ucs.ru/rk7/other/KDS_PRO/Extra_Files/
  3. Copy theudb fileto 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 the section Service > Cash register stations Stations and devices.

Enable the use of the HTTP port on the cash register server. Specify a free port in the HTTP Data Port field and do not check the check the Use Free Listen Port box.
image2021-4-7_14-34-37.pngImage Modified

Select the desired cash server and add the Then, set up 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.

...

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. 
Scenario:

  1. In the DestURLs filed, specify the connection string in the following way:
    http://GS_server_address:GS_server_port/api/httpNotify/postOrders
  2. Save the changes
  3. Restart the cash server.
    Image Added
    If you need to specify several connection strings, write them separated by semicolon ";"
    F.ex.: http://127.0.0.1:2121/api/httpNotify/postOrders;https://127.0.0.1:1234/orderTaker

For versions earlier than 7.6.5

If your r_keeper version is lower than 7.6.5, HTTP Order Notify interface should be added manually to the cash server.
Scenario:

  1. For proper KDS PRO operation, the driver version, not earlier than 18, is needed. If you have a lower version, before adding HTTP Order Notify, download the driver from FTP:ftp://ftp.ucs.ru/rk7/other/KDS_PRO/Extra_Files/httpnotf.udb
  2. Copy and replace the httpnotf.udb file in the reference server folder.
  3. Restart the cash sever.
  4. Add HTTP Order Notify driver to the cash server:
    Image Added

  5. Set up the driver for all the cash servers if necessary.
  6. In the DestURLs filed of the Drivers tab, specify the connection string in the following way:
    http://GS_server_address:GS_server_port/api/httpNotify/postOrders
  7. Go to Service > Interfaces and create a new interface
  8. In the DLL Library Files section, select the required restaurant and then select the HTTP Order Notify driver for the cash server
    Image Added

  9. Change the interface status to active and save the changes.

Go to Personnel > Employees and create a new employee with an HTTP role, using only Latin characters. Be sure to assign all the rights to this role.
Save the changes and restart the cash server.

Guest Screen Settings

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

After 5 clicks, the modes window will open.

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

Open the Connection 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
    Image Added
  5. Click CheckVerify. 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:
      Image Added
    2. If login or password is incorrectIf you enter your username and password incorrectly, you will see the the Unauthorized error:
      Image Added
    3. The error An error occurred while sending the request means that the connection settings to the cash server are specified incorrectlyconnection data is incorrect. Check the IP and connection port.
      Image Added
  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 required cash desks, from which you want to receive orders, in the field  Cash register desk code field
    Image Added
    If

...

  1. cash desks are not displayed,

...

  1. click Refresh
  2. Optionally, specify the logging level and the synchronization frequency with r_keeper_7
  3. Click Save
    Click Save Image Added
  4. Connection The 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 It is located 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:
Image Added

Image AddedImage Added

Settings Import

...

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 has the .exp extension, for example, GS-UCS-0.0.1.33.exp.
Open GS and go to settings, tab Common.
Image Added
Select the template file in the Upload Template and Settings fieldin the Import settings field. Check both the boxes (if any) and click Import:.
The standard templates will be loaded into GS.

Displaying content

Display Settings

In the settings, select Screens sectionOpen Settings and select the Screens section.

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

Standard Settings

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

  • Modes this is the operation 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 default ready-made modes by default:

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

And scriptsscenarios:

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

Scenes

Scenes are mean content that is shown according to the scenario conditions of the scenarios. AccordinglyThus, create scenes should be created before creating scriptsscenarios.

  1. To create a scene, go to to the Scenes section
  2. Click Add Add Image Added
  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's capacities. If the video slows down during playback, it means that the video size is too large for this computer.
    Image Added
  4. Upload the selected content. For example, choose the type of scene — The imagethe Image scene type. Download the file by clicking Select an image
    Image Added
  5. Click Browse Visibility and select the file on your computer. The file will be uploaded to GS. Click on the desired image with the mouse.
    Image Added
  6. Adjust the display settings: stretch, alignalignment, size
    Image Added
  7. Click Image Added to create a scene.
  8. The scene is ready, you can move on to creating a script.

...

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

The scenario You will be taken to the script editing window will open. 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 metsatisfied.

Create a new condition by clicking the button button Image Added

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

...

    • Info
      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 scenario 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
    • Payment made
    • Payment not entered
    • In any case
  4. Click Image AddedClick the button 

Let's create an example scriptscenario.
Image Added

In this scheme, the first checked condition is conditionto be checked  is Salads. If If there is no salad in the order, the following next condition will start to be met — satisfied is Soups. If the order contains a dish with soupfrom the Soups category, this condition will display an image with certain settings. If the order does not include a dish with any soup, then the following next condition will be fulfilled, located below in the list, will be satisfied.

If the order contains both soup and salad, the the Salads condition will be displayed on the screen Saladsscreen, because this condition is located above the Soups condition Soups and and has a display priority. If necessary, it is possible to change the conditions can be reversed places by clicking on the up or down arrow arrow .

The Default condition  can can be placed below all the created conditions, so that it fulfills comprises those dishes that do not fall under any condition.
Consider the first condition Salads. Go to Open the condition editing mode Salads, mode — tap the pencil mark   Image Added.
Select needed the required dishes in the field  Presence of Run if thereare dishes with codes in the order field. Change the rest of the settings as you see fitwant. Save the settings.
Make settings for the condition Soups: condition.
Image Added

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

If the soups are in added to the order, we will see the following screen with the order will look as follows:
Image Added

The soup condition settings are applied first since , because the gazpacho 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