Selection groups restrict the values available in reference (dropdown) fields based on a previous selection. They ensure users can only choose valid combinations of related attributes, both when entering data on screen and when a process writes records.
For example, if a record has both a Region and a Country field, a selection group can ensure the available countries change based on the selected region.
How Selection Groups Work
A selection group applies to a single object and links two or more reference attributes together. A separate mapping object defines the valid combinations. When a user selects a value in one field, the dropdown for the related field is filtered to show only the values permitted by the mapping object.
Step 1 - Create the Mapping Object
The mapping object stores the valid combinations. Each record in the mapping object represents one permitted pairing of values.
For example, to restrict Country by Region, create a mapping object such as Region Country with attributes for Region and Country. Each record stores one valid Region-Country combination.
Requirements for the mapping object:
The mapped attributes must be part of the mapping object's unique key
The mapping object must contain a distinct list of valid combinations
Virtual objects cannot be used as mapping objects
Step 2 - Configure the Selection Group
Navigate to Objects \> Objects and select the target object.
In the Selection Groups panel, click Edit.
Add a record for each attribute that should be part of the group.
For each entry, define:
Selection Attribute - the attribute on the current object to be controlled
Mapping Object - the object that defines valid combinations
Mapping Attribute - the attribute in the mapping object that provides the valid values
To configure the Region-Country example, you create two records - one for Region and one for Country - both pointing to the same mapping object.
Multiple Selection Groups
You can define multiple selection groups on the same object to control different sets of attributes independently. However, a single attribute can only belong to one selection group. If multiple selection groups share the same mapping object, use the Label field (visible in Detail view) to distinguish them.
Effect on Dropdown Lists
Once applied, the dropdown for a controlled attribute no longer draws directly from the referenced object. It uses the mapping object instead. This means only the values present in the mapping object will appear, even if the referenced object contains additional records. Keep mapping objects complete and up to date.
Behaviour with Processes
Selection groups apply to both screen input and process outputs. If a process attempts to write a record that violates a selection group, the process will fail. Selection group definitions are stored in the EU_SELECTION_GROUP object and can be loaded into a process for explicit validation before writing data.
Constraints
Mapped attributes must be part of the mapping object's unique key
An attribute can only appear once in the selection group list
Existing records are not revalidated if the mapping object changes
Chains of references (A controls B which controls C) are not supported