Device Menus
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:
- Main Menus
- 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.