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.

Selecting the property reference for a control

Updated on April 5, 2022

Select a property for the control to determine the data type to include in the list that an application user sees. At run time, the user selects one or more values from the list.

  1. In the Property field on the General tab of the Properties panel, press the Down Arrow key and select a property, the value of which the end user selects at run time.
  2. Click the Open icon 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 is displayed and you can use it to create the property.

  3. For the Label option, select one of two settings:
    • To use the name of the property as the label for the control, select the Use property default check box.
    • To specify a label for the control, clear the Use property default check box and enter the label in the adjacent, unlabeled field.
  4. To select an existing tooltip for the field or to enter a new one, press the Down Arrow key in the Tooltip field.
  5. Set the Visibility option to determine when the property value is displayed.
    • Select Always, If not blank, or Not zero to display or hide the field based on the property value at the time this section or flow action is first presented or refreshed.
    • Select Condition (expression) to make the visibility dependent on an expression. In the field that is displayed, select a condition or click the Open condition builder icon to open the Using the Condition Builder to configure dynamic UI actions..
    • Select Condition (when rule) to make the visibility dependent on a when condition rule. Click the Open icon
      to create a when condition or review an existing one.
  6. To specify when the control is not available to end users, set the Disable option.

    Specify a condition for disabling the text input:

    • Never – Never disabled
    • Always – Always disabled
    • Condition (expression) – The text input is disabled under the specified condition. In the field that is displayed, select a condition or click the Open condition builder icon to open the Using the Condition Builder to configure dynamic UI actions.. You can define a simple expression based on the comparison of a pair of constants, properties, or both, combined by Boolean operators, such as .Color="Red". You can combine the expression with a when condition rule or another expression by using the && and || operators.
    • Condition (when) – The text input is disabled under the specified condition. In the field that is displayed, select a when rule. Click the Open icon to create a when condition or review an existing when condition.
  7. To require application users to enter or select a value for this field to save the form, set the Required option.
  8. To display a text prompt with the control, select the Include placeholder check box. In the adjacent field, press the Down Arrow key to select preset text or click the Open icon to enter new text.
  9. When available, you can add a Tour ID and a Test ID.

  • Creating a rule

    To save time and ensure that your projects adhere to the unique needs of your clients, create rules and data instances using reusable elements of your application. By combining a rule type, name, class, and ruleset, you provide a unique identity for each rule that you create.

  • Creating an action set

    Define an action set to specify what a control does when a user event happens.

  • Control form - Actions tab

    Action sets determine the behavior of a control.

  • Available actions and conditions

    Choose an action from the list, see which options are available for the action and when you can use it. Learn which conditions you can apply.

  • Associating content with a feature in a guided tour

    You can associate content with a feature to create a tour stop in a guided tour.

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