List box control

A list box control displays a list of items in a box that is always open. Place this control inside a section control.

General properties

Attribute name Description

Control ID

Each control in a presentation is assigned a unique Control ID that is read-only.

Default Label

This read-only value is the text value that is associated with the database attribute bound to this control.

Label

You can specify a text value in this field to override the Default Label for the control. This label is specific to the application and is not stored in the MAXATTRIBUTE or APPFIELDDEFAULTS tables.

Attribute

You can associate this control with a database attribute. Not all attributes have a Default Label value.

Business Object Name

Specify the name of a MBO in this field to determine which MBO the control uses to show and process information. If a MBO is not specified, the control uses the data source of its parent control. When you set a MBO for this control a data source is created that can be referenced from other controls.

Parent Data Source ID

You can specify the ID of a data source to use as the parent object for a relationship, or to specify a parent object for a bean class if necessary. Then specify the relationship that uses this parent in the Relationship field. If the field is blank, the control uses the data source ID of its parent control as the Parent Data Source ID.

Key Attribute

You can specify a different attribute of the business object to use as a key attribute for the list other than the key attribute specified for the MBO.

Key Value

You can specify an option in the list to display as the default value.

Input Mode

Input mode options are:

  • Blank: An input mode with no value is read/write. Any information entered in this field is stored in the database column specified in the Attribute field.
  • Default: This mode is used for quick entry of default table data in tables.
  • Query: This mode is read-only and shows a typed value.
  • Readonly: This mode is read-only and shows grayed-out text.
  • Required: This mode is read/write and the record cannot be saved unless the user enters a value in the field.

Height

To make the control shorter or longer, enter a numeric value.

Width

To make the control narrower or wider, enter a numeric value.

Advanced properties

Attribute name Description

Bean class

You can specify the name of a data bean class to use when creating the data source for the control. If not defined and the control is creating a data source, the default psdi.webclient.system.DataBean class is used. Typically, you use this property to create custom event methods or to override the manner in which the data source obtains its MboSet.

Where Clause

You can specify a WHERE clause that the data source for this control uses to retrieve data. This WHERE clause is used in addition to any default WHERE clause used by the business object of the data source.

Order By

You can specify the order in which a SQL query fetches data for the data source for this control.

Auto-Refresh

If selected, information in this control refreshes automatically when there is a change to the business object.

Always Synchronous

If deselected, the control can communicate with the database without pausing user activities. If cleared, the user cannot perform activities in other fields until validations for this field are completed. Synchronous activity is disabled by default. If there are dependencies between values specified for this control and other controls in the application, you can enable synchronous activity for the dependent controls.

Signature Option

You can specify a signature option that can restrict access to this control or change the properties of this control based on a condition that you specify. To create a signature option, click Add/Modify Signature Options in the Select Action menu. To specify a condition, click the Configure Conditional Properties button.

Sig Option Data Source ID

An MBO must be used to evaluate whether or not a user has access to a signature option. Specify the value of the data source that performs this evaluation if it is different to the data source that is configured for this control.



Feedback