Customize Listbox

General

Customizing Information

• Listboxes are modules that can be opened via a data field with pull down menu. For information on the use of listboxes, click here.
• Listbox modules are customized like regular modules.
• The records for the listboxes can be
  • formed from existing data, e.g. the project data or
  • created in the listbox categories or
  • created in an individual data table.

Parameters to be taken into account

• When customizing listbox modules:
  • LB: Value transfer
  • LB: Partial string search
  • Background symbol (for storing a frame color)
• When embedding listbox modules:
  • LBMOD
  • DF behavior
  • Input only via listbox

Customizing Rules

• Listbox modules
  • can only contain one data window.
  • can contain visible as well as invisible data fields.
• In data areas, in which Never display is activated, LB: Value transfer or LB: Partial string search must not be activated for any data field.
• From a performance point of view, a listbox module may only contain the data fields which it requires. These are data fields which
  • are used for sorting or filter criteria of the listbox.
  • are required for the correct output of visible sorting or filter criteria fields.
• The listbox module may
  • only contain the visible traffic lights.
  • not contain any buttons.
  • not contain any listboxes since in listboxes no other listboxes can be output.

Notes

• In the status line, the following information will be output when a listbox is opened: "Number of hits in listbox: xxx of yyy". Here,
  • "yyy" is the total amount of hits: It is calculated from the records of data fields for which the LB: Value transfer parameter is activated.
  • "xxx" the amount of displayed hits.
    • The height (or width) of list boxes does not have to be set manually, but is calculated based on the number of values (or width of the fields).
    • There is a minimum hight or width.
• Within a listbox, structured data can be displayed as a tree structure (like in a regular module).

Examples

Create Listboxes Manually from Listbox Categories

Objective

• To create a listbox module from listbox categories

Procedure

• Create new listbox categories in the Listbox Values module.
• Create a new module in the Modules module.
• Create a new data area with data fields from the DT454 Listbox values in the Data Areas module and enter the new listbox category for the Listbox category data field in the Filter from data field.
• Assign the data area to the module.

Create Listboxes Automatically from Listbox Categories

Objective

• To create a listbox module automatically from listbox categories

Procedure

• Select the required listbox category from the listbox in the Listbox category field.
• Select the Generate listbox option in the context menu.
• The new listbox module is opened in the Modules module and the listbox data area is opened in the Data Areas module.

Note

• In PLANTA standard, the following global settings required for the function are already preconfigured. They can be adjusted in the Global Settings module upon requirement:
  • MV "Listbox" in the "Data Areas" module: ID of the listbox module variant of the Data Areas module. Is automatically opened after the generation of the listbox module.
  • Generate lisbox: Module ID of the template module which is used for the creation.
    • The template module must only possess one data area.
  • Work area for automatically generated listboxes: ID of the work area to which the newly created listbox module is assigned. If no ID is stored, the new module will not be assigned to any work area.

Adjust Listbox Values

Objective

• Adjust listbox values of a listbox category

Procedure

• Enter the required listbox category ID in the LBCAT field in the Listbox Values module.
  • In case no listbox values are displayed for the listbox category ID, enter the ID in the Listbox Values (Old).
• Edit the listbox values as required.
• Save.

Dependent Listboxes

Objective

• To have the listbox content displayed in a different data field, dependent on the input.

Details

• The dependency is reached through a dynamic variable, which is used in the listbox module as a filter criterion. The last changed value of the data item is read and written into the filter criterion.

Example

• Task listbox in module Add Projects and Tasks for Time Recording.
• The tasks of the task listbox are to be output dependent on the project entered in the project data field.

Procedure

• Search or create a dynamic variable for the Project data item (DT472) (in this example: @D3).
• In the project data area of the listbox module, the project data field contains the @D3 filter criterion.

Listbox Functions

Incarnation Listboxes/Incarnation Fields in Listbox Modules

Information

• Incarnations can be used on the listbox data field as well as in the listbox module.
• The combinations and their effect are summarized in the table below.
• The table is to be read as follows: The top line in a field indicates the listbox data field, the bottom line indicates the field with the “Value transfer” set.