Device menus are integral to the application development process. Menus can be created using the Warehouse Insight Device Menus page in Business Central.  There are two primary types of menus:

1. Main Menus
2. Application Menus

Menus can be created for the main landing page (e.g., launching an application or offline application like Shipping, Receiving, and Item Inquiry) or the menus can be created for a specific application (e.g., Close, Post, and Change Quantity).

When creating a menu, there are several properties that can be set. The table below describes relevant properties available. Additional properties may be available depending on the standard action being performed by the menu.

Standard Actions

Menus primarily define their interactions with Applications via the Standard Action property. Each standard action is described below with examples on how to use them.

Close

The Close standard action closes the current application and triggers the “When the Form Closes” event block.

Change Qty.

The Change Qty. standard action triggers the “When Quantity Should Change on a Row” event block and internally sets the event behavior to indicate that manual quantity change was requested.

Custom Qty.

The Custom Qty. standard action displays a dialog allowing you to enter a number.

When you choose this action, you can set additional properties on the menu.

If you press the OK button on the dialog, the value is set in a variable called “action_result”, and you can then use it by custom code as specified by the menu “Event ID” property.

Custom Text

The Custom Text standard action displays a dialog allowing you to enter text.

When you choose this action, you can set additional properties on the menu.

If you press the OK button on the dialog, the value is set in a variable called “action_result”, and you can then use it by custom code as specified by the menu “Event ID” property.

LP Create

The LP Create standard action triggers either the “When a License Plate is Started” or the “When a License Plate is Stopped” events blocks depending on the current state of the menu.

Offline Application

You can use the Offline Application standard action to trigger an offline application to be launched. Typically, you would use this on the main landing page.

When you choose this action, you can set additional properties on the menu.

Bin Inquiry

The Bin Inquiry standard action launches the application specified in the Warehouse Insight Setup page’s Bin Inquiry Application field.

Additional context parameters are automatically passed to the application for the Bin based on the configured line fields.

Item Inquiry

The Item Inquiry standard action launches the application specified in the Warehouse Insight Setup page’s Item Inquiry Application field.

Additional context parameters are automatically passed to the application for the Item, Variant, Serial and Lot based on the configured line fields.

Item Picture

The Item Picture standard action displays a dialog showing the picture associated with the selected line’s Item record based on the configured line fields.

Lookup List

The Lookup List standard action displays a dialog allowing the user to select an entry from a grid.

When you choose this action, you can set additional properties.

When completed, the context is populated with the selected record’s values. The context variables created are in the format [action_result.FieldName] (e.g., action_result.Description). You can use these variables in the extension codeunit event handler as specified by the “Event ID” associated with the menu.

Hide Completed

The Hide Completed standard action hides or shows grid entries with their quantity to handle fully entered.

Depending on the menu state, the menu option toggles between Hide Completed and Show Completed.

Take Picture

The Take Picture standard action switches to camera mode on the device and allows you to take a picture. The picture data is sent to the extension codeunit event handler as specified by the “Event ID” associated with the menu.

Choose Picture

The Choose Picture standard action prompts you to select an existing image from the device. The image data is sent to the extension codeunit event handler as specified by the “Event ID” associated with the menu.

Start Application

The Start Application standard action launches the specified application. You can launch applications from the main landing page (e.g., Shipping, Receiving, and more) or from within existing applications (e.g., Lookup Lists -> Document, Document -> Drill Downs, and more).

When you launch an application from within another document, all context variables and information is passed to the newly-launched application; when you close the newly-launched application, no context information is passed back to the calling application.

When you choose this action, you can set additional properties on the menu.

Custom Application Event

The Custom Application Event standard action triggers the “Custom Event” block defined by the menu.

When you choose this action, you can set additional properties on the menu.

Customize Page

The Customize Page standard action launches the page configuration dialog allowing you to customize the current page. Currently, the only available customization option is to choose the Grid View or Card View columns.