Skip to main content


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

Adopting new settings (Pega Customer Service)

Updated on February 27, 2023

Pega Customer Service uses a requestor-scoped Declare_CAApplicationSettings data page to store feature settings that are referenced extensively in the application. The data page is sourced from a series of cascading data transforms that originate in the ApplicationSettings data transform. After an update, it is strongly recommended that you compare data transforms in your implementation application with data transforms in the built-on application to ensure that your implementation application has the latest feature settings.

When a new version of the application is released, the Declare_CAApplicationSettings data page in the built-on application is updated with any new settings, but the copy of the data page in your implementation application does not include the new settings. Missing settings in the implementation application can lead to errors or unexpected behaviors in the application.

Note: If you are using an industry version of Pega Customer Service, run this tool from the industry application, and not from the base application.
Pega CRM for Communications 8.6 Feature Adoption for Pega Cloud
Before you begin: Update your built-on application as described inUpdating your built-on application .

    Check for missing data transforms

  1. Check whether your implementation application is missing any of the data transforms that contain application settings.
    1. In the header of Dev Studio, search for and open these two data transforms:
      • The ApplicationSettings data transform for your implementation layer.
      • The ApplicationSettings data transform for the locked PegaAppCA class in the built-on application.
    2. Compare the the number of rows in each of the open data transforms.
      Each row in the ApplicationSettings data transform identifies a data transform that contain the settings for the application. If your implementation data transform contains less rows than the PegaAppCA data transform, then copy the missing data transforms to your implementation layer.

      The following figure shows the ApplicationSettings data transform with 19 rows:

      ApplicationSettings data transform
      Update your ApplicationSettings data transform with any missing rows
  2. Copy the missing data transforms to your implementation layer.
    1. In the header of Dev Studio, search for and open the missing data transform, in the PegaAppCA class.
    2. Copy the missing data transform to your implementation layer.
    3. Repeat the above steps for all missing data transforms.
    4. Open the ApplicationSettings data transform for your implementation layer, and add the data transforms that you just copied to your implementation layer.
  3. Check for missing properties

  4. Check whether your existing data transforms are missing any properties.
    1. In the header of Dev Studio, search for and open these two data transforms:
      • The ApplicationSettings data transform for your implementation layer.
      • The ApplicationSettings data transform for the locked PegaAppCA class in the built-on application.
    2. Starting with the first row, click the Open icon to the right of the data transform name to view the data transform.
    3. Repeat the above step for the same row in the data transform for the PegaAppCA class.
    4. Compare the number of rows in each of the open data transforms.
      Each row in the data transform identifies a property that controls a setting for the application. If your implementation data transform contains less rows than the PegaAppCA data transform, then add the missing properties to the data transform that is in your implementation layer.

      The following figure shows the CSExpressSettings data transform with 40 rows:

      Example of settings properties in a data transform
      Shows the properties for the CSExpressSettings data transform
    5. Repeat the above steps for all of the settings data transforms that were present in your ApplicationSettings data transform before the update.

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