Atlas — Standard control rules accepting parameters

Purpose

Description

Presents a dynamically assembled list of text-matched candidates, constructed by an activity or from an existing clipboard page. For details and parameters, see Harness, Section, and Flow Action rules — Adding an Autocomplete control. 5.4 PROJ-890

Formats a number as currency using the default locale. Complete two parameters plus the CalculatedValue parameter:

• NegativeNumberFormat — Red or Parenthesis
• Size — A positive integer to control the display width of the text box

See Concepts — Internationalization.

For new development, use the auto-generated control pxCurrency.

Implements a flexible, powerful control to review or edit Page List or Value List properties. See Harness, Section, and Flow Action forms — Adding a DataGrid control.GRP-234

C-2413Presents a localizable date in one of several formats depending on parameters. Accepts six input parameters:

For new development use pxDateTime.

C-2413Presents a localizable DateTime value in one of five formats depending on parameters. Accepts seven input parameters, all optional. PROJ-183 BUG-3520

For new development use pxDateTime.

Formats a numeric value on output with a thousands separator and specified precision locale, for example 1,234.567. Enter up to five parameters:

• ThousandsSeparator — Include a thousands separator
• Precision — A non-negative integer to control the number of digits presented after the decimal place
• NegativeNumberFormat — To Red or Parenthesis
• Size — Positive integer to control the display width of the text box for both input and output
• CalculatedValue — As described above

Purpose

Description

Formats a numeric value on output with a thousands separator and specified precision and locale. Enter values for up to four parameters: KHATV 5/5/06 remove Locale

• ThousandsSeparator — Include a thousands separator
• NegativeNumberFormat — To Red or Parenthesis
• Size — Positive integer to control the display width of the text box for both input and output
• CalculatedValue — As described above

Allows a user to select one or more items from a short list. For an example, see the standard section rule PegaAccel-Task-CircumstanceSearch. FindByCircumstance_Circumstances.

Formats a numeric value on output as a percentage value, for example the value 0.043 can be presented as 4.31 %. C-2413Set three parameters:

• Precision — Zero or positive integer, number or decimal places.
• Convert decimal to percent — If true, input value is to be divided by 100.0 before presentation
• Size — Positive integer to control the display width of the text box for both input and output
• CalculatedValue — As described above

Presents a list of two-character state codes for the states of the United States. Set the Width parameter to a positive integer to control the width of the field. PROJ-163PROJ-163.

On input, presents a drop-down selection list of values determined by the Table Type area of the General tab of a property rule. The Table Type field can specify a Local List, Field Values, Prompt List, or Class Key Value. OTHER choices also?C-2413

This allows users to select from a familiar or easy-to-understand list of values, while a hidden value corresponding to a user selection becomes the property value.

If the Class Key Value is specified, set the DisplayProperty parameter to the name of a property (with no leading period) that is to be the source of user-visible values.

Set the Width parameter to a positive integer to control the width of the field. PROJ-163

Entries on the list can be localized at runtime through field value rules.

When specified as a control rule for a text field or a field in a display, truncates the displayed text and adds an ellipsis ("...") when the text exceeds a stated width. The full value appears in the tooltip for the field.

The property takes as a parameter the maximum width of the field in pixels.v 6.1

Similar to PromptSelect, but presents the values determined by the Table Type area of the General tab of a property rule as a group of radio buttons. The choices for Table Type are Local List, Field Values, Prompt List, and Class Key Value. PROJ-183XXXXXXXXXX 2011-02-11 kowal: What about the Remote List choice of the Table Type?

Complete two parameter values to control the appearance of the radio buttons:

• Direction — Select Horizontal or Vertical to control the layout of radio buttons in sequence in the group.
• NumItemsBeforeWrap — Enter a small positive integer to limit the number of buttons in a row (if you selected the Horizontal direction) or the number of buttons in a column (if you selected the Vertical direction).

For example, if the Table Type's fields specify the 24 text values Alpha, Beta, Gamma through Omega, and you select Horizontal as the Direction value and 3 as the wrap interval, the resulting work object form presents eight rows of three buttons each, with Alpha, Beta, and Gamma in the top row.

Using field value rules, your application can localize button labels can be localized at runtime.

Allows a clickable image to appear in report cell. Create and reference in parameters an activity that executes upon click. Parameters are:

• ImageSourceName — reference a binary file rule as a SRC= value for example /desktopimages/back.png.
• ActivityName — Second key part of an activity that executes upon clicking the image. Typically, this activity uses the Show-HTML method to present an HMTL rule display in a new window.
• ActivityClassName — Applies To key part of the activity
• Target — Name of the window, for example "_blank"
• Height — Optional. Height of the window in pixels
• Width — Optional. Width of the window in pixels
• ShowScrollbar — Boolean
• ShowToolbar — Boolean
• Resizable — Boolean.

Allows a clickable link to appear in a report cell. Create and reference in parameters an activity that executes upon click. Parameters are:

• ActivityName — Second key part of an activity that executes upon clicking the link. Typically, this activity uses the Show-HTML method to present an HMTL rule display in a new window.
• ActivityClassName — Applies To key part of the activity
• Target — Name of the window, for example "_blank"
• Height — Optional. Height of the window in pixels
• Width — Optional. Width of the window in pixels
• ShowScrollbar — Boolean
• ShowToolbar — Boolean
• Resizable — Boolean.

Purpose

Description

Supports multi-criteria search. NO EXAMPLES 5.5

Used with read-only property values. Presents a pop-up window displaying a read-only section when the user hovers the mouse pointer over the field value. The user can click the window or press any key to close the window.

The window contents can explain the significance of the selected value or provide other guidance. For example, if the read-only value is a state code such as CA for California, text in the pop-up window can explain how California regulations affect what the user can enter in other fields. C-2563 5.2

Complete three parameters:

• SectionName — The Stream Name — the second key part — of the section rule to appear in the SmartInfo pop-up window. The system determines the Applies To key part of the section rule from the primary page, or from the UsingPage parameter.
• UsingPage — Optional. Name of the clipboard page that is the source of values for any JSP tags in the section rule. If omitted, the primary page is used by default. Include the name and class of this page in the Pages & Classes tab of the harness, section, flow action, or other stream rule that references this control rule.
• HeaderText — A phrase that appears as the window title.

By design, the pop-up window does not appear when the mouse pointer hovers over a blank value.

The pop-up is for display, not user input. Don't identify a section that contains input (read-write) fields.

Allows you to present a pop-up window when a user clicks on a specially styled label, normally presented in red font. Parameters for the SmartLabel rule are the same as for the SmartInfo rule. See Harness, Section, and Flow Action forms   — Adding a SmartLabel control. PROJ-1019 5.4

Presents a button but allows access to a drop-down list of alternatives. See Split button. GRP-223

DeprecatedPresents an HTML text box with a specified display size and a maximum input length, both in characters. Set values for three parameters: SR-9297 BUG-3020

• Size — A positive integer to control the width of the text box.
• MaxLength parameter to a positive that limits user input.
• CalculatedValue — As described above.

Processing other than input processing is unaffected by the MaxLength parameter, and may set a longer value to the property.

Spell checking is enabled by default.

For new development, use the auto-generated control rule pxTextInput.

DeprecatedPresents an HTML <INPUT TYPE="textarea" ...> with specified size and expansion. Set the Rows parameter to a positive integer to control the number of lines initially displayed. See Harness, Section, and Flow Action rules — Adding a TextArea.

For new development, use the auto-generated control rule pxTextArea.

Present a TimeofDay property in one of two formats. Set the TimeFormat parameter to one of these values:

• 1 to include minutes but not seconds, such as 3:15 P.M.
• 2 to include seconds, such as 12:22:53 A.M.

Supports display of work object forms in a composite portal. See Harness and Section rules — Adding a Work Area control. GRP-264