¶¶Òõ

Skip to main content

3.9.19-x

2024-06-06 | 3.9.19-1 ¶¶ÒõKitchen Management

The information provided below includes the user experience, process workflow, and infrastructure improvements and updates for this production version of ¶¶ÒõKitchen Management (XKM) API and UI.

Supplemental Information

This release is not dependent on another release.

New Features

XKM-7976

Kitchen Printer Routing

XKM is updated to support an array of multiple item label printers for individual kitchen screens. The item labels conform to the print template specified for each printer.

This update ensures that in an environment where multiple kitchen stations display the same screen, the item labels printed at each kitchen station are specific to the items prepared at that station.

This benefits the staff members at each station by printing the appropriate label on item claim or bump, so that the label is ready to be attached to their prepared item as needed.

All printers assigned to a kitchen screen are listed on the Peripheral tab of Station Status.

For more information, see Kitchen Screen Routing to Multiple Printers.

Improvements

XKM-4891

Order Ready Screen

This update enables the user to customize the appearance of the Order Ready screen to suit business needs and preferences.

Data Management Configuration

From the Theme page of the Kitchen Screen Settings editor, configure the appearance of the following:

  • Main Screen

  • Screen Sections

  • Order Tiles

  • Order in Progress

  • Order Ready

XKM-5844

Combined Split Orders

Resolved an issue for XKM environments with the following configuration:

  • Display Combined Orders Method : Fixed

With this update, when two (2) or more split orders are combined at the POS, the order items from the combined orders are combined into one (1) order on the XKM display.

XKM-6694

Split Orders

The following identifies how deleted items appear on kitchen displays if the user splits an order at the POS, and then deletes an order item.

In environments with the following XKM configuration, the deleted item is displayed on the kitchen with the "Deleted" label:

  • Show Deleted Items: Yes

  • Display Split Orders Method: Fixed

If Identical Items Display Method is set to Consolidate Like Items, and a consolidated like item is deleted, the deleted item is separated from its like items and labeled as "Deleted".

In environments with the following XKM configuration, the deleted item is NOT displayed in the kitchen:

  • Show Deleted Items: No

  • Display Split Orders Method: Fixed

XKM-7137

Order Ready Screen

This update ensures that the Order Ready screen components are displayed at the appropriate size with respect to the screen resolution and the screen orientation (i.e. landscape or portrait).

XKM-7265

Split Orders

When an order with like items is split at the POS, the XKM now displays the like item quantities for each split order as expected.

XKM-7442

Kitchen Printing Settings

Implemented a Kitchen Screen Setting that controls the number of bump receipts that are printed when the same kitchen screen is used at multiple stations.

Kitchen Screen Setting

The following setting is located on the Printing page of the Kitchen Screen Settings editor in Data Management.

  • Consolidate Print Jobs - °Õ´Ç²µ²µ±ô±ðÌýYes to print only one (1) receipt when an order/item is bumped from this screen regardless of the number of kitchen stations where this screen is used.

    °Õ´Ç²µ²µ±ô±ðÌýNo to print a duplicate receipt for each kitchen station where this screen is used.

XKM-7510

Hold Timer for Upstream Displays

This update resolves an issue in upstream environments where the Hold Timer for an order was not set when an order was master bumped from the screen that triggers the Hold Timer.

When Show Hold Timer is enabled, the HoldTimerStarted and HoldTimerStopped values for a bumped order now match the BumpTime value of the MasterBump event if the order is bumped from the master screen before it is bumped from the hold timer upstream screens.

The Show Hold Timer setting is set in the Cell Header section of the Cells page of the Kitchen Screen Settings editor in Data Management.

In the event the Hold Timer is NOT started and the bumped order is recalled:

  • The HoldTimerStarted and HoldTimerStopped values for the order are cleared.

  • The HoldTimerStarted value is set when the hold timer begins for the order (i.e. when all order items on the upstream hold screens are bumped from the hold dependent screens).

  • The HoldTimerStopped value is set when the hold timer stops for the order (i.e. when the order is bumped from the screen that triggers the Hold Timer).

  • The values are sent one more time to the POS.

XKM-7616

Timestamp Print Variables

Kitchen timestamp variables are included in bump event print jobs.

This allows for the order start and order ready timestamps to be printed on receipts and chits.

The following order-level variables are now supported on Bump Chit and Item Label print jobs triggered by a kitchen bump event:

  • bump_time - Time when the order is bumped from the current screen.

  • first_arrival_time - Time when the first item included in this bump event’s print job was received by XKM.

  • last_arrival_time - Time when the last item updates occurred.

XKM-7755

Upstream Displays

Resolved an issue for upstream displays in an order session environment with the following configuration:

  • Display Combined Orders Method: Labeled

With this update, if an order is bumped from an upstream display, and then combined with another order on another display, the order items are combined as expected.

XKM-7762

Upstream Displays

The Hold Timer now appears and functions as expected in an environment where upstream indicators are enabled.

XKM-7926

Configuration Refresh

If an issue is encountered when upgrading XKM from the ¶¶ÒõPortal and refreshing the configuration data , the user is automatically redirected to the Shell where XKM can be reinstalled.

XKM-7950

Logging

When upgrading from XKM 3.7 to 3.8, all required logging data is now updated in local storage as expected.

XKM-7986

Receipt Templates

With this update, it is not required to define an Options and Sorts section for a receipt template.

From the Options and Sorts section of the Receipt Templates editor, define optional elements for a print template.

XKM-7991

Combine / Separate Item Quantities

When the quantity of consolidated claimed / completed items is decreased, the remaining order items on the display now respect the Identical Items Display Method setting.

This setting is defined in the Cell Body section of the Cells page of the Kitchen Screen Settings editor.

XKM-8002

Split Orders

This update resolves an issue with child items from a previously bumped order reappearing on the kitchen display after a Split Order operation was performed on the order at the POS.

This issue occurred when a combo meal with a quantity greater than one (1) with multiple identical child items was split or shared between multiple orders.

With this update, the child items from a previously bumped order do not reappear on the kitchen display after a Split Order operation is performed on the order at the POS.

XKM-8004

Split Orders

This update resolves an issue with split order Items and the autobump feature. This issue was encountered in environments with the following XKM configuration:

  • Display Combined Orders Method : Fixed

  • Display Split Orders Method : Fixed

With this update, all order items on the split order are autobumped together as expected. The autobump timer starts after the last update to any item on the displayed order.

XKM-8032

Display Font Size

When the user changes the Font Size for a kitchen display from the XKM popup menu, the font size is now immediately updated. Performing a configuration refresh is not required.

XKM-8035

Change Item Quantity

Resolved an issue that occurred in Order Session environments with the following XKM configuration:

  • Identical Items Display Method : As Received

  • Show Deleted Items : Yes

When the quantity of a combo meal item with multiple child items is reduced at the POS after it is sent to the kitchen, the combo meal item quantity is updated accordingly on the kitchen displays.

The deleted combo meal item is displayed as deleted in the original order session, but it is not displayed in the new order session.

XKM-8041, XKM-8149

Vehicle ID Indicator

The purpose of this update is to notify the drive-thru staff with a kitchen cell header indicator when an order is associated with a vehicle recognized by DTD Vision.

The XKM API is updated to accept the Vehicle ID (Vehicle_ID) included with an order.

Kitchen Screen Configuration

The following setting is available in the Cell Header Settings in the Cells section of the Kitchen Screen SettingsÌý±ð»å¾±³Ù´Ç°ù:

  • Show Vehicle ID - °Õ´Ç²µ²µ±ô±ðÌýYes to display the Vehicle Indicator in the cell header of the order when the associated vehicle is identified by DTD Vision.

    This setting is only available when Show Vehicle Info (located in the same section) is toggled Yes.

In a Header Template configuration, the Vehicle item can now be customized to show the Vehicle ID when the vehicle is identified by DTD Vision.

XKM-8052

Split Orders

When an order is split at the POS, all subsequent modifications made to the order items (including size changes) are now accurately reflected on the XKM displays without unexpectedly duplicating any items.

XKM-8054

Item Quantity

Resolved an issue that occurred in Order Session environments with the following XKM configuration:

  • Identical Items Display Method : As Received

  • Display Split Orders Method : Fixed

This issue occurred when a combo meal with a quantity greater than one (1) with different child items was shared between multiple orders.

With this update, order items from a previously bumped order do not reappear on the kitchen display after a Share Order operation with a fractional quantity is performed on the order at the POS.

XKM-8061

Kitchen Printing

This update adds support for up to six (6) indented levels for parent items, child items, modifiers, bundles, and combos printed on bump chits and item label receipts.

This enables the kitchen staff to more easily determine the order item relationships on the printed chit or label, so that they can prepare and serve the order correctly.

XKM-8076

Device Power Failure

This update addresses the following conditions that were discovered after a kitchen device encountered a power failure. The user was required to sign back in to register the device.

  • Implemented log file duplication.

  • IP validation on Android devices when network not found.

  • Addressed obsolete command execution.

  • Update config refresh time after app reload.

XKM-8084, XKM-8111

DataSync and Vision Updates

This update optimizes DataSync processing of DTD Vision service point updates that XKM receives from the POS.

With this update, there is no degradation in system performance when there are 100+ orders with associated service points in the application database.

Kitchen cells are updated and populated as expected following bump operations, and bump upstream indicators are displayed appropriately following service point updates.

XKM-8087

File Server Updates

Identified the following basic file server errors that may affect XKM performance:

  • Buffer issue caused by a port scanner application.

  • Socket send issue with large file size can potentially disrupt the application loading process.

  • Socket send issue with standard file size indicates high network load or low processor time.

XKM-8097

Kitchen Timestamps

To ensure consistency in Kitchen Timestamp values, the Preparation Start Time (prepStartTime) is now appropriately set on items that are received from the POS on-the-fly.

XKM-8139

DataSync and Vision Updates

This update optimizes DataSync processing of DTD Vision service point updates that XKM receives from the POS.

With this update, there is no extended delay before new orders appear on the kitchen displays when there are 350+ orders with associated service points in the application database.

XKM-8156

Order Retention Timer

Improved order retention to ensure all orders are purged from the database and removed from all kitchen displays after the configured retention time expires.

XKM-8159

Manual Bump

Updated the timer calculation used to govern bump overrides to ensure Open orders cannot be manually bumped ahead of the defined Min Bump Time.

XKM-8168

Bump Upstream - Bump Events

The bump upstream functionality is updated to ensure orders are bumped as expected in an upstream environment that includes three (3) or more upstream monitors.

This update adds the following rules for bump priority:

  • When a bump occurs on a screen that has direct bump upstreams, then this direct dependency is given top priority over any bump behavior type that exists on indirect paths.

  • When a bump occurs on an indirect bump upstream path with a different bump behavior type, then the ENTIRE ORDER is given top priority.

XKM-8191

Order Comments

Improved filtering to ensure order-level comments are not displayed when the associated order is filtered from the screen.

XKM-8195

Comments

Improved filtering to ensure order-level comments are not displayed when the associated order is filtered from the screen by order destination.

This update also ensures that orders that contain both item-level and order-level comments are able to bumped from all displays.

XKM-8207

Kitchen Displays

This update addresses reported incidents at a site where orders were not appearing on the kitchen display and the bump bars were not responding as expected.

This update improves the bump event handling process to resolve the reported display issues.

XKM-8211

Android MINIX Support

With this update, XKM is supported on Google Chrome version 66 (or greater) on Cordova devices.

XKM-8216

Kitchen Displays

This update improves order handling and payload processing to ensure orders received from the POS are displayed on the kitchen displays as expected.

XKM-8245

Bump Events

Improved workflow of bump events to eliminate the delay in orders disappearing from the display upon bump.

XKM-8260

Maintenance Time

If the user attempts to process orders during a site's scheduled Maintenance Time, the user may experience performance issues while the XKM configuration files are updated.

A future update will enable the administrator to define the duration of the maintenance time window. In the event of failure, the user will be notified that maintenance did not run and the user will be provided with the option to manually perform maintenance.