Multiple Selection

The multiple selection is a list item that allows you to select multiple entries at once. It is suitable, for example, for distribution lists, product groups, and much more. The multiple-selection feature is available as both an input and a display element.

The Multiple Selection Input Element

Properties in the browser

Data Source "Values from Applications" / "User-Defined Values"

If you select "Values from Applications" or "Custom Values" as the data source in the Multiple Selection properties, the element in the browser consists of two lists. The left-hand side lists all available entries, while the right-hand list shows all selected entries. When the page is saved, the selected entries are stored in the linked data field, provided that a link to it has been configured.

Using the arrow buttons at the top right or top left next to the list titles, you can move the currently selected entry from one list to the other. This also works by double-clicking an entry. You can use the CTRL key to select multiple entries at once.

The multi-select field can be configured to retrieve its entries from, for example, an ID or GUID, but display a different value from the same data set. For example, item numbers could be used as entries, and the item description could be displayed instead.

In addition, so-called selection filters can be set up; these appear as small, icon-based buttons at the top of the multiple-selection list and, when clicked, filter the entries in the list accordingly.

The values entered using multiple selection can be displayed using the "Multiple Selection View" and the view table.

Distributor Selection

If you have selected "Distribution List Selection" as the data source in the Multi-Select Properties, the multi-select feature in the browser can be used to select users, user groups, and other objects from the "Users" module.

You can use the search field to search for terms that narrow down the list of user objects. The Schema Manager is used to specify which data can be used for the search. For the desired attributes, select the setting "Use in User Management search. "

Using the selection filter—the filter buttons above the user lists—you can narrow or expand the search to include users, user groups, distribution lists, organizational units, and roles, depending on whether the corresponding button is enabled or disabled.

When the record is saved, the GUIDs of the user objects are stored in the associated data field. You can create new distribution lists by clicking "Create Distribution List" at , provided that the "Create Distribution List" setting is enabled in the data source.

This section illustrates the structure of user management. Select here where you want to create the new distribution list, and then click "Save."

Enter the name and description of the distribution list here. The members of the distribution list can be defined below. To do this, click the " " button on the right.

Select the member(s) you want here and click "Save."

Go to the "Permissions" tab.

Here, you specify which user objects are allowed to modify the distribution list you just created. Click the " " button on the right to select the appropriate users. After saving, the new distribution list will be added to the "Users" module.

Click to edit all existing distribution lists.

Properties in the "Applications" module

When you create a multiple selection in the "Applications" module, the Properties dialog box opens automatically.

General

Here, you can configure the general properties of multiple selections.

Title / Title from Constant

You can enter a static title here. Alternatively, the title can be retrieved from a language constant, which you can select here. You can find all the information on this topic here.

Heading "Unselected Entries" / Heading "Selected Entries"

Here, you can specify the headings for the two lists in the multiple-selection field. A constant can be used here as well.

Input Required

With this setting, the field becomes required.

Invalid entries

Display Saved Values

If values are written to a data field via a multiple selection, it is possible—for example, due to an application export or import—that the values are no longer valid. With this setting, the invalid saved values are displayed instead of the currently configured display value.

Delete when saving

Invalid values are removed from the data field of the current record.

Search Options

Initial search term

The search term entered here will be automatically entered into the search field and will filter the "Available" list when the corresponding page is loaded. The maximum number of results is displayed when the * character is entered in the search field.

No search term displays all entries

Displays all entries when the search field is empty.

Click "Next."

Data Source

This is where you configure the source of the entries in the multiple-selection list.

Values from Applications

With these settings, the entries are generated from data from any application.

Application, Data Group

Select the application and data group here whose values you want to display in the multiple-selection list.

Filter

Opens a dialog box where you can define a filter. The data is then displayed in the multiple-selection list according to the filter criteria.

Stored value

All data fields for the selected data group are displayed here. Specify the field whose values are to be saved when the user selects an entry from the multiple-selection list. For example, you can display employees' names in a multiple-selection list, but save the corresponding ID instead of the name.

More Options

Maximum number of entries

Limits the number of entries. If you enter -1, all entries will be displayed.

Sorting

This section displays the fields by which the entries are currently sorted. Clicking "Sort" on opens a dialog box where you can select the data fields by which to sort.

Sorting

"Available" column

This section lists all data fields that can be used for sorting.

"Selected" Column

This section lists all the data fields that have already been selected for sorting.

Remove a data field from the sort / Include a data field in the sort

Moves the currently selected field from one list to the other.

Move a data field up or down in the sort order

Changes the order of the currently selected fields. The following applies: The top field in the list is the primary sort criterion. All subsequent fields sort based on the results of the parent field.

Sort Ascending / Descending

Right-clicking here opens a menu that allows you to set the sort order to ascending or descending.

Click "OK" to save your changes and close the dialog box.

Starting with Intrexx version 12.1.5:

The sorting can be controlled via a setting.

Selection Filter

Above the element, you can set up a filter with buttons for filtering the entries in the browser. In the Properties dialog box, the active selection filter—if any—is listed under "Data Source" in the "Additional Options" section.

Selection Filter

Opens a dialog box where you can select the images for the buttons and define the filter.

Selection Filters in the Control Panel

"Active" Column

The browser displays a button for each filter you have configured here. In this column, you can specify whether the button should be displayed as already clicked (active) or not yet clicked (inactive).

"Image" Column

Displays the path to the selected image.

"Text Alternative" Column

Displays the text alternative that has been entered.

/ Edit a selection filter

Opens a dialog box where you can create a button for the selection filter or edit an existing button.

Image

The path to the image is displayed here, provided that an image has been selected for the button.

Select an image

Opens a dialog box where you can select an image.

Remove Image

Removes the reference to the image.

Edit Text Alternative

Opens a dialog box where you can enter text that will be displayed in place of the image on devices that cannot display images.

Filter

Here you can see the filter expressions that have already been defined.

/ Edit filter expression

Opens a dialog box where you can define a new filter expression or edit an existing one.

Remove filter expression

Removes the filter expression from the list.

Edit Filters in Expert Mode

Opens the filter editor, where you can edit the XML of the filter expression. This setting is available only when Expert Options are enabled.

View image in original size

With this setting, the selected image is displayed at its original size. If this setting is not enabled, the image will be displayed at a size of 16x16 pixels on desktop devices and 32x32 pixels on mobile devices.

The filter is enabled by default

Ensures that the filter is enabled when the page loads.

Click "OK" to save your changes and close the dialog box.

Delete Selection Filter

Removes the currently selected filter from the list.

Move a selection filter up or down one position in the sort order

Changes the order of the buttons.

Show all entries when all selection filters are disabled

If this setting is not enabled, no entry is displayed when all selection filters are inactive.

Link

The individual filters can be linked using an "OR" or "AND" operator. With an "OR" condition, at least one criterion must be met for the corresponding data to be displayed. In an "AND" condition, all criteria must be met.

Click "OK" to save your changes and close the dialog box.

Adjust the display value to match the stored value

If this setting is enabled, the data from the data field you selected in the "Saved Value" setting will be displayed.

Display value

The current display value is shown here, provided that a display value has been configured.

Display value

Opens a dialog box in which you can select a display value that differs from the saved value.

Display value

Add a display value

Opens a dialog box where you can select the data field whose values you want to display.

"Name" column

Here you will find the names of the data fields that can be selected as display values.

"Data Type" column

This column displays the data type of the data field.

"Control Type" Column

The corresponding control type is displayed here.

Insert a separator

You can enter a separator here to separate the individual values from one another. This is also possible in the previous dialog. Also select the "Insert Separator" option so that the separator is applied.

Click "OK" to save your changes and close the dialog box.

Add a separator

Inserts a new line where you can enter the desired separator.

Remove Display Value

Removes the currently selected display value from the list.

Move the display value further to the left / right

Changes the order of display values and separators. The following rule applies: The higher a display value or separator appears in the list, the further to the left it will be displayed in the browser.

Control Type

Select the desired control type for your display values.

Restriction Separator

Here, you can suppress the display of individual separators if their values are empty.

• Always

  A separator is displayed to the left or right of the displayed value.

• Text is not empty

  A separator appears to the left or right of the displayed value if the text to the left or right of the displayed value is not empty.

• The data field is not empty

  A separator appears to the left or right of the displayed value if the data field immediately to the left or right of the displayed value is not empty.

Preview

At the bottom of the dialog box, you'll see a preview of the list showing the current settings for display values and separators.

Distributor Selection

Instead of the "Values from Applications" data source option, you can also select the "Distribution List Selection" setting for multiple selections. This allows the element to be used to select users, user groups, and other objects from the "Users" module. Find out here what a multiple-selection field configured this way looks like on the web and how it can be used there.

Maximum number of items in the dialog box

Specifies the maximum number of entries to display in the results list during a search. When selecting a distribution list, you cannot define additional filters or make changes to the existing filter settings.

Selection filters in the control panel

You can find all the information here.

Filter

Opens a dialog box where you can create an additional filter. This is applied to the selected filters using an AND operator.

Create / Edit Distribution List

Display the respective buttons for creating and editing distribution lists in the browser. Here, you can specify the default container in which a new distribution list is to be created in User Management.

Enable Client Filter

If the client filter is enabled, only user objects that are assigned to at least one of the current user's clients are displayed.

View Deactivated Users

With this setting, all users whose accounts are deactivated in User Management are also displayed.

Adjust Display Values

Here, you can edit the values displayed in the distribution list selection.

Edit Display Values

Opens a dialog box for editing the display values.

Display value ... Edit

You can find all the information you need about editing display values here.

Click "OK" to save your changes and close the dialog box.

Custom Values

Instead of the "Value from Applications" or "Distribution List Selection" options, user-defined values can also be used as entries in the multiple-selection list. Custom values, therefore, do not come from a data source but are entered statically here in the dialog box.

Data type of the stored value

Specify here the data type used to store the selected value.

"Displayed Value" column

The value entered here will be displayed in the browser's drop-down list.

"Saved Value" column

The value entered here is saved in the data field associated with the multiple-selection list.

"Preselection" Column

The value shown next to the checked box in this column will be preselected in the multiple-selection list when the page loads.

/ Edit custom value

Opens a dialog box where you can create a new value or edit an existing one.

List entry

Enter the value you want to display for the user to select and the value you want to save. The display value can also be entered in multiple languages.

Synchronize Displayed Value / Saved Value

As a rule, when one field is changed, the contents of both fields are automatically updated in the other field. You can prevent or restore this behavior by clicking "Synchronize Title / Saved Value."

Click "OK" to apply the changes and close the dialog box.

Delete Custom Value

Deletes the currently selected value.

Move the value up or down in the display order

Changes the order of the entries.

Click "OK" to save your changes and close the dialog box.

Click "Next."

Storage Options

Here, you can configure how the value of the multiple-selection field should be saved.

No link

With this option, the multiple selection is not linked to a data field. The selected values are not saved.

List in a text field

The values are stored in a data field with the "Text" data type.

Create a New Data Field

Opens a dialog box where you can create a new text data field.

Data Group

The values from a multiple-selection are stored as individual records in a child data group.

"Data Group" Selection List

If there are subordinate data groups, they can be selected and used here.

Create a New Child Data Group

Creates a child data group containing the relevant system data fields and an ID field for the ID of the stored value.

The values in the primary key and foreign key are automatically generated when records are created in the browser. The value of the primary key corresponds to the ID of a child record, while the value of the foreign key corresponds to the ID of the associated parent record. The stored value is determined from the data source.

Clicking the small arrow icon to the right of the " " button opens a menu where you can select the type of primary key for the new child data group ("Integer as Primary Key" or "GUID as Primary Key").

Grouping filters for saved records

Opens a dialog box where you can define a filter that is applied when multiple multiple-select input elements are used on an input page. For example, if you use two multiple-select input fields on an input page—one to select call center employees and the other to select service department employees—you can filter the lists to show only those employees who share a common task. If the task title is stored in a data field for each data record, you can compare that data field in the grouping filter.

"Data Source" column

If a subordinate data group exists, the data field names are displayed here. When a new child data group is created here, the entry "Automatic Determination" is displayed here.

"Value" column

Indicates the type of value that is stored in the corresponding field.

"Data Field" Column

Displays the data field name.

4th Column - Status

	The configuration of the storage value is valid.
	Configuration of the storage value is permitted. The assignment does not conform to the standard. However, there may be situations in which such a classification is still appropriate. Functionality at runtime (in the browser) is not guaranteed. When you close the dialog by clicking "OK," a confirmation dialog appears. The configuration can be applied despite the warnings.
	The configuration of the storage value is invalid. The assignment will not work at runtime. As long as an invalid configuration is specified, you cannot close the dialog by clicking "OK."

/Edit a stored value

Opens a dialog box in which a data field—from which the stored value originates—can be mapped to a data field from the child data group currently linked here.

Target Data Field

Select the data field here where the stored value should be saved.

Create a New Data Field

Opens a dialog box where you can create a data field.

Value

Data field from the display data group

Here, select the desired data field from the data group that you have included in the data source configuration.

Automatic Determination

With this setting, the following values are automatically calculated based on the selection and written to the target data field:

• Stored value

• Primary Key

• Foreign Key

The stored value is retrieved from the field in the data source.

Static value

With this setting, you can enter a fixed value that is stored in the destination data field every time a record is saved.

Request Variable

Allows you to enter the value of a request variable whose name you can specify here.

Session variable

The value of a session variable—such as the language setting—can also be used as the value for the target data field. Select the session variable from the drop-down list.

Click "OK" to save the changes and close the dialog box.

Remove Cached Value

Deletes the selected memory value from the list.

Click "Next."

Final Settings

Create Field Titles

With this setting, the "Static Text" element is created along with the new element; it automatically adopts the title of the new element and displays it as a label.

Click "Finish." Multiple selection is now configured and can be used in the browser after the application is saved.

Multiple Selection View

Properties in the "Applications" module

When you create a multiple-selection view in the "Applications" module, the Properties dialog box opens automatically.

Inheritance of Control Properties

If a multiple-selection input validation rule already exists, you can easily apply those settings here. To do this, select the desired multiple selections and check the "Apply Input Control Settings" option.

Click "Next."

General

Title / Title from Constant

Enter the title of the multiple-choice question here. You can find more information on this topic here.

Automatically adjust height to fit content

The multiple-selection list is displayed with a height that allows all available entries to be shown.

Invalid entries

Display Saved Values

If values are written to a data field via a multiple selection, it is possible—for example, due to an application export or import—that the values are no longer valid. With this setting, the invalid saved values are displayed instead of the currently configured display value.

Click "Next."

Display Values

The available settings here largely correspond to the settings that can also be configured as the data source for the multiple-selection input control. You can find the corresponding description here.

Click "Next."

Data Source

This setting specifies the source from which the entries for the multiple-selection view should be read.

List in a text field

Reads values from a data field with the "Text" data type.

Data field

Select the appropriate data field here.

Data Group

This option reads the values from a data group.

Data Group

Select the data group here.

Data field

Select the desired data field here.

Filter

Opens a dialog box where you can define a filter. The data is then displayed in the multiple-selection list according to the filter criteria.

Click "Next."

Final Settings

You can find all the information about this dialog here.

Click "Finish" to save all changes and close the Properties dialog box.

"Multiple Selection" Control Type in View Tables

Browser

In view tables, the "Multiple Selection" control type can be selected if data fields that support multiple selection are included as columns in the table. In the browser, the data is then displayed in the table column as a drop-down list for each cell.

You can find out how to configure table columns and select control types here.

Options in the table column properties

In the Properties dialog box for a table column with the "Multiple Selection" control type, you can configure the following settings in the Options section:

Separation of Entries

Specifies how the entries in the table column are separated.

Delimiter

Enter the desired separator here.

Line break

With this option, each entry is displayed on its own line within the table cell.

Column Layout

You can find all the information on this topic here.