Skip to main content

Creating an application setting

Pega Community logo

Note: The following content, referenced from Pega Community, is included here to help you better achieve the module learning objectives.

Create an application settings rule for all deployments of your system, customized by production level.

For example, you can define a time-out interval that is consistent for all production deployments and another time-out interval that is consistent for all test deployments.

  1. In the header of Dev Studio, click Create SysAdmin Application Settings .

  2. On the Create form, enter values in the fields to define the context of the application setting.

    1. In the Label field, enter text that describes the purpose of the setting. The label that you enter is used as the default name for the setting, with spaces and special characters removed. This default name can be overridden as described below.

    2. Optional:

      To change the default name for the application setting, click Edit, and then provide a unique value in the Identifier field. The name must start with a letter and use only numbers and letters, without spaces.

    3. In the Owning Ruleset field, enter the name of your application as the domain for the application setting. Despite the field label, this value does not have to equal a ruleset name; it functions as a namespace.

    4. If you are using branches, in the Context section, in the Development branch field, select the branch in which you want to introduce the application setting.

      For more information, see Branches and branch rulesets.

    5. In the Add to ruleset field, select the ruleset of the production application that stores the application setting.

  3. Click Create and open to open the application settings form.

  4. Optional:

    In the Category field, press the Down arrow key, and then select a category from the list.

    Note: If you do not specify a category, the application setting does not display in the Application settings landing page in App Studio.
    For more information, see Categorizing application settings.
  5. In the Value type field, select a value type from the list. The value type you select defines how the application setting is rendered in the Application settings landing page in App Studio. For example, if you choose Boolean, the application setting displays as a Boolean value.

  6. Define application settings values by production level. For more information, see Defining values for an application setting.

  7. Optional:

    On the Display tab, perform one of the following actions:

    • Select the Hide the setting in landing page check box to hide the application setting from the Application settings landing page in App Studio. If you leave this check box unselected, the application setting renders in the landing page when you save the rule.
    • By default, every application setting uses the pzSettingDefaultViewInLP section to render the application setting in the landing page in App Studio. In the View for landing page field, press the Down arrow key to override the default section and select a new section.
  8. Click Save.

  • Reference application settings in rules

    The pzsettingsORA UI control is a reusable control that you can use to reference application settings in any rule in your application. The control defines how the application settings appear in your rules. For example, you can configure the control to display only categories or remove the option to create a new application setting.

  • Categorizing application settings

    Create categories to organize your application settings to make it easier for users to search for application settings and understand their purpose. For example, if you create a category called Integration, you can apply this category to application settings that relate to integrating with customer data.

  • Defining values for an application setting

    Configure separate values for different production levels. At runtime, the system uses the application setting value that corresponds with the current production level.

  • Configuring application settings

    Application settings rules define run-time settings that can differ based on a system's production level, and which are resolved at run time through rule resolution. Application settings are identified by name and owning ruleset. The owning ruleset functions as a namespace and does not have to equal the ruleset that contains the rule.

  • Viewing application settings

    You can view, search for, and edit application settings by using the Application settings landing page in App Studio. The landing page displays the application settings that correspond to the current production environment that you are using.

  • Copying a rule or data instance

    Use the Save As form to copy an existing record's functionality to a new record with unique key parts. This form is pre-populated with the original record's key parts and creates default values for the new record's context.

  • Creating a rule specialized by circumstance

    Create a rule specialized by circumstance to provide a variant of the rule that your application triggers only conditionally under specified conditions. By creating specialized or circumstance rules, you address dynamic business requirements without changing the core logic of your application.

If you are having problems with your training, please review the Pega Academy Support FAQs.

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 Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice