Device Menus

Home/Device Menus

Device Menus

You are here:

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.

Property Description
Event ID The event ID to call in Business Central when the menu has processed. Can be used with or without a Standard Action being set.
Refresh On Success If set, the menu triggers the When Loading Document Data event.
Require Line Places the selected lines data into the page context prior to executing the menu.

If no line is selected, the menu does not execute.

Standard Action The primary action to take when you click 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.

Standard Action Description
Close Closes the application and fire the “When the Form Closes” event.
Change Qty. Triggers the “When Quantity Should Change on a Row” event.
Custom Qty. Displays a simple enter quantity dialog.
Custom Text Displays a simple enter text dialog.
LP Show Not available.
LP Create Triggers the “When a License Plate is Started” or “When a License Plate is Stopped” events.  Updates the menu text accordingly.
Offline Application Launches the configured offline application.
Lookup to Barcode Not available.
Prompt to Barcode Not available.
Bin Inquiry Launches the Bin Inquiry application as configured on the Setup page.
Item Inquiry Launches the Item Inquiry application as configured on the Setup page.
Item Picture Displays the selected items picture.
Custom Form Deprecated.
Lookup List Displays a simple lookup grid list for the user to select an entry from.
Hide Completed Toggles the visibility of completed lines.
Take Picture Prompts the user to take a picture using the device’s camera.
Choose Picture Prompts the user to choose a pre-existing image on the device.
Start Application Launches the specified application.
Custom Application Event Fires the “Custom Event” defined in the Custom 1 field.
Switch Take/Place Deprecated.
Search Deprecated.
Customize Page Displays the page customization options dialog.

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.

Property Description Default
Title The title for the dialog. Enter Value
Prompt The prompt to display to the user. Value
Default Quantity The initial value for the dialog. 0

Row values can also be used by referencing in brackets (e.g., [Qty. to Ship]).

Min. Quantity The minimum value allowed to be entered. 0
Max. Quantity The maximum value allowed to be entered. No maximum

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.

Property Description Default
Title The title for the dialog. Enter Text
Prompt The prompt to display to the user. Value
Default Value The initial value for the dialog. Blank

Row values can also be used by referencing in brackets (e.g., [Description]).

Max. Length The minimum value allowed to be entered. 2048 (max variable length allowed)

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.

Property Description Default
Offline Application The offline application to launch.

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.

Property Description Example
Table to Lookup The table to retrieve the records from. 27 (Item)
Table Filter The filter to apply to the table. WHERE (No.=FILTER(*1))
Columns A comma-separated list of columns to display to the user. No.,Description

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.

Property Description Example
Application The application to launch. ADHOCMOVE

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.

Property Description Example
Event Name The name of the custom event to call in the application. OnPost

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.

Was this article helpful?
0.5 out Of 5 Stars

1 rating

5 Stars 0%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 100%
How can we improve this article?
Please submit the reason for your vote so that we can improve the article.
Need help?

Leave A Comment

Go to Top