Autocomplete Properties — Presentation tab

Field

Description

Select an edit mode for this control. The edit mode of the control, specified here, takes precedence over section and harness settings.

• Auto — the control uses the edit mode of the section or harness in which it appears. If the section is set to Read Only, then the control is Read Only. If the section is set to Auto, then the control uses the edit mode of the harness. For example, a New harness is editable, while a Review harness is read only.
• Editable — the control is editable, regardless of the edit mode of the enclosing layout.
• Read Only — the property value is presented in read-only mode always, or based on a when condition rule or client-side test, even when the enclosing layout is in read-write mode.

For read-only formats, select to display one of the following:

• Property value— displays the value of the selected property
• Another property's value— displays the value of the property that you specify. In the field that displays, select the property for which you want to display the value.
• Constant— displays the value of the constant that you type in the field that displays

If you want to display a tooltip when the user hovers the mouse pointer over the drop-down list, press the down arrow to select the property that you want to display as a tooltip or type a text string within quotations, for example, "Select to open an item".

This tooltip applies to the entire drop-down list. If the List Source Type is Data page, Clipboard page or Report definition, you can also specify a tooltip that displays when the user hovers the mouse pointer over an item within the drop-down list. To do this, specify the Property for tooltip in the List Source area on the General tab.

Specifies the width of the drop-down list.

Select Auto if you want the layout to determine the width of the control area. This is the default.

If you want to specify a fixed width for the drop-down list and the returned results, select Custom. Specify the width of the Autocomplete input box as the Field width and the width of the returned search results as the Listing width.

Placeholder

Select None if you do not want to display placeholder text.

Select Other if you want to display a hint or instructional text in the field. The text disappears when the user enters a value. If the user does not enter a value, the placeholder text reappears when the field loses focus.

Appears if you select Other in the Placeholder field.

Press the down arrow to select the property that you want to display as a placeholder or type a text string within quotations, for example, "Select to open an item".

You can style Placeholder Text in the Skin. See Skin form — Components tab — Controls — Text inputs.

Specifies the format of the Autocomplete control. You can style Autocomplete controls and create additional formats in the skin rule. To select a custom format, press the down arrow and select Other.

Appears only when you select the Display advanced presentation options check box.

Note: As a best practice, define custom styles in the skin.

• Cell read-write style — Type the name of the custom style, for example, custom_stylename, that you want to apply to this cell when the user form or flow action form appears in read-write mode.
• Cell read-only style — Type the name of the custom style, for example, custom_stylename, that you want to apply to this cell when the user form or flow action form appears in read-only mode.
• Cell inline style — Type CSS code to define an inline style. As a best practice, define custom styles in the skin. See Skin form — Components tab — General — Custom styles.

Select a format (read-only) used with this property. Your selection filters the format options.

Do not confuse format types with property types.

Appears if Type is Date/Time or Date.

Select one of the following:

• A DateTime format (for example: 1/1/01 1:00 AM), or a Date format (for example: 1/1/01). The formats are locale-specific, changing automatically based on the value set on each user's Windows workstation, or the locale of a user, as recorded in the Operator ID data instance.
• The elapsed time format (2 days, 5 hours ago). The system displays the value calculated as the difference between the current system date/time and the date/time value of the property. For example:

Current = 3/21/2011

Property value of 3/20/2011 = 1 day ago

Property value of 3/22/2011 = 1 day from now

The units of measure are minutes, hours, days, and years. If greater than 59 minutes, the value is represented in two units (unless the difference is exactly one unit). For example:

1 hour, 10 minutes

2 days, 20 hours

1 month, 4 days

1 year, 3 months

If less than a minute, the value is displayed as "less than a minute ago" (or from now).

To calculate months and days, the system uses today's numerical day in the previous month(s). For example, if today is March 21, one month ago was February 21, not one month, six days ago.

If the property is a Date type or the format is Date, minutes are excluded.

Appears if Type is Number.

Select left, right, or center alignment.

Appears if Type is Number.

A non-negative integer to control the number of digits presented after the decimal place. The default is Auto, which displays a maximum of three decimal places (placeholder zeroes are not added). Select to remove all digits after the decimal point and round to the nearest integer. Select All to include all digits.

Appears if Type is Number.

Select a label indicating the scaling you wish to apply to the number. The scales are K for thousands, M for millions, B for billions, and T for trillions. For instance, if you select Thousands, a value of 20,000 appears as "20 K." If Percentage, the value appears as a percentage sign (.8 appears as "80%").

Appears if the Type is Number.

Select a format (minus sign or parenthesis) for displaying negative numbers.

You can also specify a CSS class if you select one of the Style Ref options. By default, the class name is NegativeNumber.

Appears if Type is Number. When a symbol is specified an additional character(s) is prepended to the value. Currency automatically uses the localized currency symbol, constant uses a string, and reference uses a property value.

Select an option for representing the number as

• Currency — Formats the number as a currency using the default locale.
• Constant — A text string or character (for example, "%") ASCII character that you enter.
• Reference — A property value.

Appears if Type is Number.

Select to use a thousands' separator. Depending upon the default locale, a comma or period is used.

Appears if the Read-only format Type is Text.

Select Yes if you want the characters entered by the user to appear as a string of bullets. The input characters are initially added to the clipboard as unencrypted, clear text values. The system computes the hashed value only as the page is committed to the PegaRULES database. Thereafter, the hashed value appears in both the clipboard and the database row.

Appears if Type is Text and the control is not obfuscated.

Select a property or constant that you want to add either before the displayed property value. For example, when the user name appears, the system can automatically prepend the user's title.

Appears if Type is Text and the control is not obfuscated.

Select a property or constant that you want to add after the displayed property value. For example, when the user name appears, the system can automatically append the full mail extension to the name.

Appears if the Type is True/False.

Select to label either outcome using Text or an Image.

Appears if the Type is True/False and Show Value As Image is selected.

Select an image to label either outcome. Used with a boolean type.

Appears if the Type is True/False and Show Value As Text is selected.

Enter a text string to label either outcome. Used with a boolean type.

If the Localize? check box is selected on the section's HTML tab, a SmartPrompt Appears in the Constant field in the Parameters dialog. Select a field value rule if you plan to localize the text. If this text is to be localized, enter no more than 64 characters. A field value rule with pyCaption as the second key part and this text as the final key part is needed for each locale.

Harness and Section forms - Adding an Autocomplete control
Autocomplete control - General tab