Skip to main content

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

Upgrading REST connectors sourced from a Global Resource Setting

Updated on April 6, 2022

Take advantage of all available configuration options for a URL by upgrading REST connectors with URLs that are sourced from a Global Resource Setting (GRS), for example, =D_GRSDemoProject.URL.

Note: Pega Platform version 8.5 and later no longer support using GRS syntax directly in a connector. Connectors created in earlier Pega Platform versions continue to function properly. However, saving a connector with a GRS results in an error.

As a best practice, use an application setting to control the values of the URL and the authentication profile of a REST connector. Application settings allow explicit configuration that takes into account the production levels, and if required, you can use GRS as part of the application setting configuration. For more information, see Creating an application setting.

  1. In Dev Studio, click RecordsSysAdminIntegration-ConnectorsConnect REST.
  2. Click on the REST connector that you want to upgrade.
  3. On the Service tab, click Upgrade to new endpoint configuration.
  4. In the Create application setting(s) window, create a new application setting:
    1. In the Owning ruleset field, enter the domain for the application setting. This value does not have to equal a ruleset name; it functions as a namespace.
    2. In the Name field, enter a name for the application setting.
    3. In the Short description field, enter text that describes the purpose of the application setting.
  5. Optional: Specify a category in the Category field.
    By default, the Value fields in the Value per production level section are populated with the GRS resource path.
  6. Click Submit. The Base URL field is populated with the application setting that you created.
  7. Click Save.
  • Previous topic Upgrading REST connectors with URLs not sourced from a Global Resource Setting
  • Next topic Upgrading REST connectors with URLs that only contain parameters

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. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us