This troubleshooting guide will be helpful if an existing Maitre'D database is upgraded to version 7.08.000.410 or later for use with the Advanced POS User Interface (HTML POS).
Legacy preferential screens and Sreen Layouts can have defects that would prevent the Advanced User Interface from working correctly. These defects may even prevent the Advanced POS from loading properly.
The POS will not start in Advanced POS UI mode, but does start in Legacy POS UI mode.
In advanced UI mode, the POS hangs, becomes unresponsive or crashes when specific screens are accessed.
In advanced UI mode, the POS hangs, becomes unresponsive or crashes when logging in with certain employees.
Some Preferential Screen or Screen Layout buttons look awkward, especially those located near the edges of the screen.
To resolve these issues, follow the steps below:
Temporarily revert to the Legacy POS User Interface. (See below)
Logon to the Maitre’D Back-Office with appropriate credentials. (Distributor or System Owner)
Start the Point of Sale Control module.
Click on the View menu and select the Options... option.
The Point of Sale Control module's options window opens on the Configuration branch.
Click on the POS sub-branch and disable the Use advanced POS UI option.
Click OK. You will be asked to create the workstation data. Click OK to proceed. The entire process could take from a few seconds to a few minutes, depending on your system's performance and the number of workstations on your Maitre'D license.
The options window will close, and you will be back to the Point of Sale Control module.
At this point, the POS workstations should automatically restart with the Legacy POS User Interface.
When preferential screens are created and later modified, it is possible to accidentally have buttons that expand beyond the screen boundaries. This wasn't much of an issue with the Legacy POS User Interface, but this can lead to random crashes or even the POS not starting at all with the Advanced POS UI.
Logon to the Maitre’D Back-Office with appropriate credentials. (Distributor or System Owner)
Start the Point of Sale Control module.
Click on the Screens menu and select Preferential Screen setup...
The list of available Preferential Screens is displayed.
Select an existing preferential screen and click the Modify button to edit its properties.
The Preferential Screen Editor will appear (Legacy UI mode).
On some occasions, it is possible to have buttons where the Right Expand or Bottom Expand options are enabled but grayed out because the button is on the edge of the screen.
This happens when copying or moving an already “expanded” button to the right or bottom edges of the screen. It can also happen if the screen's properties were changed. Here are a few tricks that can help in identifying problematic buttons:
If the screen has fewer than 50 buttons, increase the screen size to quickly spot expanded buttons and fix them before reverting to the original screen size.
Here is an example with “Screen 18” where everything looks normal:
Increasing the number of buttons by switching to “Screen 36” shows that some expanded buttons were actually hiding on the edge of the screen:
50 is the maximum number of buttons that can fit on one screen. To quickly spot problematic buttons in this case:
Make a mental note of the buttons that are on the rightmost column and on the bottom row.
Click on the Screen button and change the screen to a smaller button count, for instance “Screen 36”.
Use the Previous and Next buttons to navigate across multiple pages of buttons. Look for any button that looks awkward. The text and graphics on problematic buttons will appear truncated or strangely formatted.
Fix the buttons by disabling the appropriate expanded options.
Revert the screen to its original size. Click the Close button to save changes.
The same issue can occur on Screen Layouts. However, there are no fancy tricks to detect out-of-bounds buttons.
Logon to the Maitre’D Back-Office with appropriate credentials. (Distributor or System Owner)
Start the Point of Sale Control module.
Click on the Screens menu and select Screens layout setup...
The list of available screen layouts is displayed.
Select an existing screen layout and click the Modify button to edit its properties.
The Screen Layout Editor screen will appear.
Unfortunately, there are no fancy tricks to detect problematic buttons on Screen Layouts. You need to double-click on each button that is located near an edge and look for grayed-out expand options:
Next, you will need to move the button (drag & drop) to an empty space that will allow it to expand properly. Then, you will be able to disable the Expand options and move the button back to where it was.
When preferential screens are created and later modified, it is possible to accidentally have buttons that overlap each other. This wasn't much of an issue with the Legacy POS User Interface, but this can lead to random crashes or even the POS not starting at all with the Advanced POS UI.
Logon to the Maitre’D Back-Office with appropriate credentials. (Distributor or System Owner)
Start the Point of Sale Control module.
Click on the Screens menu and select Preferential Screen setup...
The list of available Preferential Screens is displayed.
Select an existing preferential screen and click the Modify button to edit its properties.
The preferential Screen Editor will appear (Legacy UI mode).
Overlapping buttons can happen when enabling the Right Expand or Bottom Expand options next to existing buttons. Buttons to the right and below the expanded button still exists, but are now hidden by the expanded button. This will cause unexpected behaviour with the Advanced POS User Interface.
To fix the issue, you can disable the expand options and leave them disabled. You may also delete the hidden buttons before re-enabling the desired expand options.
Unfortunately, there is no easy way to spot overlapping buttons. The only way is to open the properties of each expanded button, disable the expand options and see if there were one or more buttons hiding behind it.
Overlapping buttons can also be found in Screen Layouts. The procedure to locate and fix them is exactly the same as for Preferential Screens.
Advanced POS UI Sccreen Issues
Locate and repair Expanded Buttons
Locate and repair Overlapping Button
