Adding a Configuration Item

Configuration project items are added at the project level in the solution. To add a configuration, perform the following steps:

  1. In Solution Explorer, right-click the Project and select Add > New Item. The Add New Item window is displayed.

  2. Select the Configuration item from the General templates.

  3. Enter the name for the configuration and click OK. The Configuration item is displayed in Solution Explorer and opens in the Designer.

  4. In the example shown below, Configurations named HelpDeskRegionNE and HelpDeskRegionNE were added to the project. Continue by Defining the Configuration.


Defining the Configuration

After adding a configuration project item, define the configuration item by selecting components (or controls) and property-value pairs. Each combination of component-property-value is a profile. A configuration item may contain multiple profiles. These steps show how to define configurations for the Form Text for a Windows form.

  1. Open the Windows form in the Designer and select the Text property for the form. Right-click the property and select Configure. The Property Configuration dialog is displayed.

  2. Set the value for the property in the New 'Text' property value box. In this example the HelpDeskRegionMW configuration uses the Windows Form Text value of Midwest Region.

  3. Click Apply to set the property value for the selected configuration.

  4. In the Configuration box, select the next configuration (HelpDeskRegionNE) and then set the Form text value for this configuration. An example is shown here:

  5. Click Apply to set the property value for the selected Configuration and then click OK. The configurations are updated in the Designer with the component-property-value profiles. See the example below:

These steps show how to set a single component-property-value profile for a configuration. You can add more than one profiles to a configuration.

Once you finish defining the configurations, you can run the project with a specific configuration or deploy the project with one or more configurations. For more information, see Project Properties.


Related information

Configuration Item Functions

Project Deployment Overview


Privacy | Trademarks | Terms of Use | Feedback

Updated: 18 June 2020

© 2016 - 2020 Pegasystems Inc.  Cambridge, MA All rights reserved.


OpenSpan data classification label