Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Autocomplete Properties – Presentation tab

Updated on April 5, 2022

Click the View properties icon of an autocomplete control to display the properties panel, and then click the Presentation tab to configure the display of the autocomplete control.

FieldDescription
Edit optionsSelect an edit mode for this control. This setting takes precedence over section and harness settings.
  • Auto – the control edit mode depends on the edit mode of the enclosing section or harness. If the section is set to Read Only, then the control cannot be modified. If the section is set to Auto, then the control uses the edit mode of the harness.
  • Editable – Control is editable, regardless of the edit mode of the enclosing layout.
  • Read-only – Control presents a read-only property value always, or based on a when condition rule or client-side test, even when the enclosing layout is in read-write mode.
Read-only valueFor 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.
  • Localize property value – Displays the localized value of the property.
Display as combo box (field and button)Select this check box to configure the autocomplete control as a combo box.
Specify sizeSpecifies the width of the autocomplete field.
  • Auto – the layout determines the width of the control area. This is the default option.
  • Custom – you specify a fixed width for the control area. Enter the width in pixels or as a percentage in the Field width field.
Results displaySelect a display format for the autocomplete search results.
  • In a table – Results are displayed in a table where the first column contains the primary field values and the next columns contain the additional field values.
  • In a list – Results are displayed as a list of primary field values. Additional field values are displayed as secondary text under their primary values in the list separated by a semicolon.
Note:

When you select In a list display mode, the following options are not applied to the primary fields:

  • Categorize search results
  • Display best bets
  • Search using a data page or report definition parameter

The following options are not applied to the additional fields:

  • Read-Only Format options
  • Obfuscated when

Select the Display results full screen on phone check box if you want the search results to cover the full screen of your mobile device.

Select the Allow free-form input check box so that users on mobile devices can enter values that are not part of the autocomplete source list.

Control formatPress the Down arrow key to specify a format for the autocomplete control. You can style autocomplete controls and create additional formats in the skin rule.
Label formatPress the Down arrow key to specify a format for the label of the autocomplete control.

Read-Only Format

FieldDescription
TypeSelect a read-only format used with this property. Your selection filters the format options.
  • None – The property is not formatted.
  • Date – Renders DateTime and Text property types in date-only format (hours and minutes are not displayed).

    Specify the format in the Date format field.

  • Date/Time – Renders DateTime and Text property types in date and time format.

    Specify the format in the DateTime format field.

  • Number – Numeric properties on output.
  • Text – Unedited text, which may contain spaces, tabs, line break characters, and other control characters.
  • True/False – Boolean values.

    Enter the text to appear when the value evaluates to true or false in the True and False text fields.

DateTime or Date formatAvailable when the Type option is set to DateTime or Date.

Select left, right, or center alignment.

  • A DateTime format (for example: 1/1/01 1:00 AM), or a Date format (for example: 1/1/01).
  • The elapsed time format (2 days, 5 hours ago or 2d, 5h ago). The system displays the value calculated as the difference between the current system date/time and the date/time value of the property.
Note: You cannot apply a format when you select As a list option for results display and the DateTime property is an additional property.
Note: 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.
Text alignmentAvailable when the Type option is set to Number.

Select left, right, or center alignment.

Decimal placesAvailable when the Type option is set to 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. Select 0 to remove all digits after the decimal point and round to the nearest integer.

ScaleAvailable when the Type option is set to 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 (0.8 appears as "80%").

Negative formatAvailable when the Type option is set to Number.

Select a format 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.

SymbolAvailable when the Type option is set to Number.

Select an additional character to be added to a number:

  • Currency – The currency symbol based on the default locale.
  • Constant – A text string or ASCII character (for example: "%") that you enter.
  • Reference – A property value.
SeparatorsAvailable when the Type option is set to Number.

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

Obfuscated

Available when the Read-only format Type option is set to Text.

Select Yes to mask the password. 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.

Auto prependAvailable when the Type option is set to Text and the control is not obfuscated.

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

Auto appendAppears if Type is Text option 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.

Show value asAvailable when the Type option is set to True/False.

Select to label either outcome using Text or an Image.

True image and False image

Available when the Type option is set to True/False and Show value as is set to Image.

Select an image to label either outcome.

True text and False text

Available when the Type option is set to True/False and Show value as is set to Text.

Enter a text string to label either outcome.

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.

  • Adding an Autocomplete control

    Use an Autocomplete control to allow the user to select a value from a possibly large set of searched text values, based on a partial string match. Pega Platform dynamically assembles and displays a list of candidate matching values after the user types one or a few characters of input.

  • Skin form — Components tab — Controls — Autocomplete

    Styles set on the Search Results tab apply to the filtered list of results that is displayed after the user types one or more characters in the autocomplete input field. The styles apply to both the standard and legacy autocomplete control.

  • Understanding the Date, Time of Day, and DateTime property types.

    A single application can be deployed worldwide. To support varied needs for time zones and locales, three different property types are available: Date, TimeofDay, and DateTime.

  • Source of autocomplete field values

    Autocomplete controls save time and ensure accuracy by supplying a list of possible values for an input field, based on characters that the user enters.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us