In this article
Pop-up Types
Pop-up Types are used to specify settings that are used when displaying pop-up panels for the following types of pop-ups:
| Pop-up | Handler |
|---|---|
| Infocode, Infocode Group | Infocode Handler |
| Item Modifier, Item Modifier Group | Infocode Handler |
| Time Modifier, Text Modifier | Infocode Handler |
| Cross-selling, Cross-selling group | Infocode Handler |
| Variant (single dimension) | Variant Handler |
| Variant Embedded (variant pop-up within pop-up) | Variant Embedded Handler |
Note: Pop-up types are used with POS Pop-up Version Enhanced.
To set up pop-up types
Note: The PackagePOPUP_HANDLING_25 configuration package includes pop-up types for infocodes and variants. Import this package to get the basic pop-up types with the necessary panels. The package also includes new POS commands.
- Click the
icon, enter Pop-up Types, and select the relevant link. - On a new line, select the desired Pop-up Main Handler. The handler controls which fields are editable in the page. It selects the default settings for certain fields and selects an appropriate default panel.
- If necessary, select the ID of the desired interface profile. This is only necessary if you need to restrict the number of buttons or pick a different option grouping for a specific POS terminal (a mobile POS for example that has very little screen space).
- In the ID field, enter an ID for the pop-up type.
- In the Description field, enter a description of the pop-up type.
- For Infocode Handler, you are able to change the Pop-up Group Selection Handler to Standard Handler and select a specific Option Grouping. The Infocode Handler selects the appropriate default panel for the selected Option Grouping.
- You can mark the pop-up type as Default for Option for Option Grouping No. The pop-up type is then used as default for the pop-up type's main handler, interface profile, and option grouping number.
- You can mark the pop-up type as Default for Group for Option Grouping Yes (closed and open groups). The pop-up type is then used as default for the pop-up type's main handler, interface profile, and option grouping Yes (closed and open groups).
Handlers
The Pop-up functionality is split into sections. Each section represents an interface. The pop-up type specifies which handler handles each section. The functionality can be extended by implementing new handlers. The sections are:
| Section | Description | Handlers |
|---|---|---|
| Main | Retrieves the active pop-up type and the data to show in the pop-up panel, and then processes the panel selection when closed. | Infocode Handler Variant Handler Variant Embedded Handler |
| Group Selection | Processes the selection of a group button in the panel. | Group Selection Handler |
| Texts | Updates the glyph texts on option and group buttons, texts that are shown for the whole panel and for group selection. | Infocode Text Handler |
| Restrictions | Checks whether an action is allowed, based on the current selection and the minimum and maximum selection settings. | Infocode Restriction Handler |
| Message | Decides how to display a message based on the Pop-up Message Type. These message typically explain to the user why a certain action cannot be performed. | Display Message Box Handler Display Banner Handler Skip Display Handler |
| Option Selection | Processes the selection of an option in the panel. | Single Selection Handler Multi Selection Handler |
Option grouping
There are three options for how options are grouped in the pop-up panel:
| Option Grouping | Description |
|---|---|
| No | There is no visible group, the options are ordered in the way they are inserted by the main handler. |
| Yes - One Option Group Visible | The options are grouped in at least two groups. Only one group and its options are visible at a time. Group selection buttons are used to jump between groups. |
| Yes - All Options Visible | The options are grouped in at least two groups. All the groups and options are visible (no scrolling applied). Each group section starts with a button showing the name of the group (no command is behind the button). A group spans one or more rows. The rows show the group options. Note: If there are lot of options or groups, this option may not be feasible. |
Infocode handler Pop-up Type selection for groups
For an infocode group, item modifier group or cross-selling group, the infocode handler selects the pop-up type as follows:
For the active interface profile
- It selects the pop-up type assigned directly to the group.
- If no pop-up type is assigned to the group, it selects the first pop-up type with option grouping Yes - One Option Group Visible marked as Default for Group.
- If not found, it selects the first pop-up type with option grouping Yes -All Options Visible marked as Default for Group.
- If not found, it selects the first pop-up type with option grouping Yes - One Option Group Visible.
- If not found, it selects the first pop-up type with option grouping Yes -All Options Visible.
For interface profile not specified
If no pop-up type was found for the active interface profile, it goes through steps 1 to 5 with a blank interface profile.
Tip: If you want to use the Yes - All Options Visible option for all your groups, you must mark the corresponding pop-up type as Default for Group. If you do not want certain POS terminals to show groups with all options visible, you need to include a pop-up type with option grouping Yes - One Option Group Visible with the interface profile of the POS terminals. See also How to: Display Open Groups in Pop-up Panels.
Infocode handler Pop-up Type selection for non-groups
For an infocode, item, text and time modifier, and cross-selling, the infocode handler selects the pop-up type as follows:
For the active interface profile
- It selects the pop-up type assigned directly to the entity.
- If no pop-up type is assigned to the entity, it selects the first pop-up type with option grouping No marked as Default for Option.
- If not found, it selects the first pop-up type with option grouping No.
For interface profile not specified
If no pop-up type was found for the active interface profile, it goes through steps 1 to 3 with a blank interface profile.
Pop-up panels
Pop-up panels are used to display extra input needed during a transaction in a panel that appears on top of the current POS layout. When the pop-up panel closes, the current POS layout appears again. The Pop-up panels in the LS Central Demo Database are a part of the Interface Profile ##DEFAULT, but as with other panels, these can be copied to other Interface Profiles if you want to change their layouts.
Each pop-up type is assigned a POS panel that is designed to show the options. The panel needs to handle the option grouping selected for the pop-up type.
In the LS Central Demo Database there are five different Pop-up panels designed to display the different Pop-up types:
| Pop-up Panel | Description |
|---|---|
| #PPOP-GROUPS | Used for a pop-up type with option grouping Yes - One Option Group Visible. The user can select multiple options from multiple groups (unless the settings specify otherwise) and selection mode buttons are visible (add, subtract, clear buttons). The panel can show previous selection that the user can change. Panel codeunit is Pop-up Controller. |
| #PPOP-GROUPS-OPEN | Used for a pop-up type with option grouping Yes - All Options Visible. The user can select multiple options from multiple groups (unless the settings specify otherwise) and selection mode buttons are visible (add, subtract, clear buttons). The panel can show previous selection that the user can change. Panel codeunit is Pop-up Controller. |
| #PPOP-OPT-MULTISEL | Used for a pop-up type with option grouping No. The user can select multiple options (unless the settings specify otherwise) and selection mode buttons are visible (add, subtract, clear buttons). The panel can show previous selection that the user can change. Panel codeunit is Pop-up Controller. |
| #PPOP-OPT-SINGLESEL | Used for a pop-up type with option grouping No. The user can only select one option, and the panel has only a Cancel button beside the option buttons. Panel codeunit is Pop-up Controller. |
| #PPOP-OPT-VARIANTEMB | Used for a pop-up type with main handler Variant Embedded. The user can only select one option, and the panel has only a Cancel button. Panel codeunit is Pop-up Controller Embedded. |
Controlling the number of option buttons, rows, and columns
You do not need to restrict how options appear in these pop-up panels. The system creates a button for each option. If an option is unavailable (item is blocked or current availability is none), the option button appears as disabled.
However, if there are a lot of options to show, the buttons will become very small. In that case, you can restrict how many buttons are shown, and how many rows and columns for each pop-up type.
For infocodes, modifiers, and cross-selling, you can create separate pop-up types and assign them directly to an infocode and a modifier. You can do the same for groups.
For example, if there are certain item modifiers that have a lot of options, you can assign a pop-up type to them directly that restricts how many buttons are shown. For those item modifiers with not that many options, the default pop-up type is used.
These fields control how many rows and columns there are shown for option buttons:
| Field | Description |
|---|---|
| No. of Option Button Columns | Specifies how many columns of option buttons appear in the pop-up. If not set, there will be as many as needed to display all the selectable options, based on a default row/column ratio. Option grouping Yes - All Options Visible: If this field is filled out, the system displays the maximum number of rows per group necessary to show all the options. The number of columns is equal to one (the group column) plus however many columns necessary to display the options, the maximum being the number in this field. If this field is not filled, each group spans one row and the number of columns is equal to one (the group column) plus the maximum number of options shown for the groups. Example 1: Example 2: |
| No. of Option Button Rows | Specifies how many rows of option buttons appear in the pop-up. If not set, there will be as many as needed to display all the selectable options, based on a default row/column ratio. Note: Does not apply to option grouping Yes - All Options Visible. |
| Max. Option Buttons Shown | Specifies the maximum number of option buttons shown in the pop-up panel. If set and the number of selectable options exceeds this number, page scrolling is applied. Note: Does not apply to option grouping Yes - All Options Visible. |
Controlling the number of group buttons shown
One field controls how many group buttons are shown.
Max. Group Buttons Shown
Specifies the maximum number of group buttons shown in the pop-up panel. If not set, there will be as many as needed to display all the groups. If set, page scrolling is applied. Group buttons have either one row or one column. The paging orientation of the Base Group POS Menu in the panel controls this.
Note: Does not apply to option grouping No or Yes - All Options Visible.
Controlling the size and position of the panels
The size and position of the Pop-up panels is defined with the panel’s Width, Height, and Position fields. If you want to have these properties different for a certain interface profile, you must copy the ##DEFAULT panel to a new panel with the same Control ID for the interface profile and change the properties for this new panel.
Note: A panel with zero value for the XPos and YPos fields appears in the center of the POS window.