Back Forward Harness and Section forms
Fields — Adding a Select control

About Harnesses

As of V7.1, the Select control is deprecated, but supported. The Select control no longer appears in the Basic control group. For new development, use the Dropdown control (pxDropdown), which replaces the Select in the Basic control group. See Harness and Section forms — Adding a Dropdown control.

As a best practice, upgrade Select controls to Dropdown controls. If a section contains Select, DynamicSelect, or another control for which there is an improved alternative, a warning displays, along with an Update Controls button. Click Update Controls to automatically update deprecated controls in the section. Automatic update is not available for all controls; see Upgrading deprecated and outdated controls on the PDN.

A cell in a layout can present the value of a property, as display-only or as an input field. Follow these instructions to control the presentation of a property value in a Select box.

NoteDon't confuse this Select control — which supports the run-time presentation of a fixed list of choices, such as produced in the Table Type area of a property — with the Dynamic Select control, where the choices are determined at runtime by running an activity. See Harness and Section forms — Adding a Dynamic Select control.

Click the down-arrow (Arrow) at the right end of the Basic control group (Basics) and select the Select control (Select). Drag the control to the cell or header that is to contain the property value. When the pointer changes shape to indicate that a single cell is selected, release the mouse button to drop the control.

If the cell is not empty, the dropped control replaces the current contents of the cell. Click the magnifying glass (Magnifying glass)to display the Cell Properties panel.

Click (Magnifying glass) to open the Cell Properties panel. Complete the top fields that appear. GRP-229

If the panel is pinned (Pinned), the wireframe presentation on the rule form changes immediately to reflect of your inputs. If the panel is not pinned (not pinned), click Apply to apply your inputs.

Field

Description

Property

SmartPromptSelect or type a property reference that identifies a single text value. SR-4597 B-22011 Single Value only?

Alternatively, you can drag a property name from the lists of properties visible in the Application Explorer. Typically, this works for Single Value properties belonging to in the Applies to class of the current rule (or a higher class). If the container in which this field sits has a non-blank Using Page value, you can drag a Single Value property from within that embedded page property. B-16325 RejectedClick

(magnifying glass) to review the property (if the reference is to an existing property in the Applies To class of this rule or a parent of that class). If the property is not found, the New dialog box for the property form appears.

You can reference properties on any page identified on the Pages & Classes tab, using the normal notation pagename.propertyname for pages other than the page corresponding to the Applies To class of the rule.

If this field is in a cell of a section that includes parameter declarations on the Parameters tab, you can enter the notation param.NAME here, to use a parameter value for the field, where NAME identifies a string parameter. Make sure that the NAME parameter is declared on the Parameters tab, and that your application provides a non-blank value for the parameter value in all possible situations where the section appears. See Sections — Completing the Parameter tab.

Control

SmartPromptTo represent the property as a select control, keep the value PromptSelect.

Click (Magnifying glass)to supply parameter values for this control:

Parameter

Description

DisplayProperty Optional. Leave blank in most cases. If the property in the Property field has a Table Type of Class Key Value (on the General tab of the Property form) you can enter a property name here (with no preceding period) from the class, to provide an initial value for the select.
Size Number of items to show at once in the select list.
Width Width of the select box, in HTML characters.
ReadOnlySmartInfo Optional. Purpose key part of a section to present as a SmartInfo pop-up for this control when the field is read-only.
ReadWriteSmartInfo Optional. Purpose key part of a section to present as a SmartInfo pop-up for this control when the field is read-only.
SmartInfoHeader Optional. Text to appear in a SmartInfo header.

Click OK to save parameter values.

Behavior

Optional. Leave blank if no dynamic form actions to other parts of the form are to occur based on user updates or values for this field. C-1990

To establish a dynamic form action, click the magnifying glass icon (Magnifying glass) to open the Client Event Editor in a new dialog window. Complete the Client Event Editor to select an event (OnBlur, OnChange, or OnClick) and the resulting form action.

Click the help icon ( Help) on the Client Event Editor for assistance. For general information on this capability, see Harness and Section forms Help — Client Event Editor.

Client event support is not available for harnesses, sections, or flow actions that use directives.

Complete the General tab.

The General tab for a Select control is identical to the General tab for a Text Input control. See Adding a Text Input control — Complete the Cell Properties Panel — General tab.

Complete the Advanced tab.

The Advanced tab for a Select control is identical to the Advanced tab for a Text Input control. See Adding a Text Input control — Complete the Cell Properties Panel — Advanced tab.

TipUse these Windows operations to speed development:

Up About Flow Actions

Up About Harnesses

Up About Sections