Skip to main content

Settings and options

Plug-in attributes​

List Extension is used as an initialize element on page load. In order for the plug-in to work, the following attributes must be set at the plug-in instance level:

Page item​

This is the main setting of the plug-in. Please select an item in which the new value will be returned.
The item must be set on the current page when the plug-in is used so that JavaScript can access it. The item needs to be one of the following types :

  • PopupLov,
  • Select list,
  • Radio group,
  • Checkbox group,
  • Shuttle type

For the plug-in to work, items must also use a "Dynamic" List of Values (LOV).
If you select an incompatible page item, an error will appear as a page rendering error.

Page returning item value​

This attribute determines the item name by returning a new value id.
The best approach is to find the primary key item through this setting.

IMPORTANT: Do not forget to add the item into "Items to Return" on the DialogClose process in the modal window page!
In case there is no item to return, fetch action will not be triggered.

Action​

This action is possible only on items that support multiple choice otherwise the default behavior of "Set Value" is taken by default.

Set Value​

When the action is set to "Set Value" and a new value id is created, the item gets replaced with new value.
This setting is applied to the selected page item by default.

Append Value​

When the action is set to "Append Value" and a new value id is created, the item adds a new value to the already existing stack. Multiple values setting on the item must be enabled so that action "Append Value" can take place.

Button location​

Button location gets interesting when using "Radio group", "Checkbox group", or "Shuttle" page item types with a lot of data to display.
With this setting developers can easily manage button position on the element.

Shuttle element has additional declarative classes to be displayed among already existing buttons.

As a suggestion the "Stretch" option is the best fit for "Popup LOV" and "Select list" page item types.

Affected Elements​

In the "Affected Elements" setting of the plug-in, you can define which button to put beside the page item, for easier navigation. The button can be placed anywhere on the page, for easier development infrastructure place the button at least in the same region. The button can be defined declaratively on the page and used as a normal button on the page. For the List Extension action to work, the best fit is to set a redirect on the page containing the page item that will be returned.