Creating a New Admin Setting
Admin Settings are system properties that have different values, and you can use them for different purposes. You must configure admin settings to meet the business objectives of your implementation along with Custom Settings.
The APTS_RLPInstanceSettings custom setting in Salesforce is used to define environment-specific URLs required for integrating with Conga services on Conga Advantage Platform. This configuration ensures that Salesforce connects to the correct endpoints based on the deployment region such as North America (NA), Australia (AU), or the European Union (EU). Refer to the Region Specific Admin Entry Valuestopic for detailed admin setting values.
|
Field |
Description |
|---|---|
|
SPAClientId |
A single-page application ID. Enter the SPAClientId that you generated after configuring the UI to API configuration. |
|
UserId (optional) |
Enter the user ID that is created on the Conga Platform. To view the user ID on the Conga Platform, log in to Conga Platform as administrator, then go to Admin Console > Users > Click on the desired username. |
|
InstanceURL |
Conga organization instance URL. Use any of the following URLs per your Conga instance: For production instance:For Preview instance: |
|
UIInstanceURL |
Conga Organization UI instance URL. Use any of the following URLs per your Conga instance: For production instance:
For preview instance:
|
|
UpsertQuotesEndpointURL |
The upsert quotes URL. For production instance:
For preview instance:
|
| MyApprovalsPageURL |
For production instance:
For preview instance:
Note: Hide Conga OneShell Navigation in Approvals UI You can hide the Conga OneShell top page header and global navigation in the Approvals for Advantage Platform UI when accessing it from the Conga CPQ on Salesforce. To do this, add the query string parameter Example:"MyApprovalsPageURL": "https://<domain name>/approvals/my-approvals/?hideNav=true" |
| ApprovalCenterPageURL | For production instance:
For preview instance:
Add the query parameter |
|
LoginURL |
Your Conga Platform login URL.
|
CollaborationRequestURL | Production: NA, EU, and AU regions: https://<instanceURL>/api/cart/v1/carts/collaboration-request Preview: NA, EU, and AU regions: https://<instanceURL>/api/cart/v1/carts/collaboration-request |
Forward-SyncURL | Production: NA, EU, and AU regions: https://<instanceURL>/api/datasync/v1/forward-sync Preview: NA, EU, and AU regions: https://<instanceURL>/api/datasync/v1/forward-sync |
AcceptQuoteEndpointURL | Enter this URL to create custom accept quote button in the Salesforce to accept the quote in the Conga Advantage Platform. Production: NA, EU, and AU regions: https://<instanceURL>/api/datasync/v1/forward-sync Preview: NA, EU, and AU regions: https://<instanceURL>/api/datasync/v1/forward-sync |
| ActivateOrderEndpointURL | Production: NA, EU, and AU regions: https://<instanceURL>/api/order/v1/orders/{order-id}/activate Preview: NA, EU, and AU regions: https://<instanceURL>/api/order/v1/orders/{order-id}/activate |
|
Enter the following endpoints only when you use X-Author for Excel, Conga Sign, and Composer applications along with CPQ. These endpoints are specific to the connected environment. Reach out to the Conga CloudOps team for the endpoints. | |
| Coreapps | Production: NA: https://coreapps-rlsprod.congacloud.com EU: https://coreapps.congacloud.eu AU: https://coreapps.congacloud.au Preview: NA: https://coreapps-rlspreview.congacloud.com EU: https://coreapps-preview.congacloud.eu AU: https://coreapps-preview.congacloud.au |
|
XAEndpoint | Production: NA: https://xauthor-prod-rls10.congacloud.com EU: https://xauthor.congacloud.eu AU: https://xauthor.congacloud.au Preview NA: https://xauthor-prod-rls10.congacloud.com EU: https://xauthor-preview.congacloud.eu AU: https://xauthor-preview.congacloud.au |
|
SignEndpoint |
Production: NA: https://coreapas-rls10.congacloud.com EU: https://coreapps.congacloud.eu AU: https://coreapps.congacloud.au Preview NA: https://coreapps-rlspreview.congacloud.com EU: https://coreapps-preview.congacloud.eu AU: https://coreapps-preview.congacloud.au |
|
ComposerEndpoint |
Production: NA: https://coreapps-rls10.congacloud.com EU: https://coreapps.congacloud.eu AU: https://coreapps.congacloud.au Preview NA: https://coreapps-rlspreview.congacloud.com EU: https://coreapps-preview.congacloud.eu AU: https://coreapps-preview.congacloud.au |
| To use the Okta SSO for logging into the Salesforce, you must add the following along with previous values. The login URL and following admin key values are privided by the admin who configures the auth. provider. Admin must Admin must whitelist (Salesforce trusted urls, Salesforce trusted redirect urls) the auth provider url (Okta) and conga login url (https://login-rlsqa.congacloud.io) | |
| AuthorizeEndpointURL | Authorization end point url of the tenant. For example, https://login-rlsqa.congacloud.io/api/v1/auth/External/Login/Challenge |
| IDPScheme | SamI2P |
| IDPEntityID | Enter the authentication provider name. This is provided by the admin who setup the auth. provider.http://www.okta.com/exklse92w4HEZEhmn5d7 |
| UID | Enter the Platform user Id. |
Configuring a New Admin Entry
Admin Settings in CPQ
The following content provides information about various admin settings available in CPQ along with their values and purposes.
APTS_RLPInstanceSettings
|
Name |
Enter APTS_RLPInstanceSettings. |
|
Value |
Leave this field blank. |
|
Code |
Enter the code. Below is an example of a code whose values are specific to the connected/preview environment. |
APTS_RLPAutoSyncRenewalQuote
|
Name |
Enter APTS_RLPAutoSyncRenewalQuote . |
|
Value |
Enter True or False. |
|
Code |
Leave this field blank. |
Region Specific Admin Entry Values
Region Specific URL Configuration
This document describes configuration of region-specific
URLs for the APTS_RLPInstanceSettings Admin setting across North America (NA), Australia (AU), and European Union (EU).
APTS_RLPInstanceSettings for the production environment.| Admin Setting Entry | Description | ||
|---|---|---|---|
| SPAClientId | A single-page application ID. Enter the SPAClientId that you generated after configuring the UI to API configuration. | ||
| URLs | URL for NA region | URL for AU region | URL for EU region |
| InstanceURL | https://prod-rls10.congacloud.com | https://rls.congacloud.au | https://rls.congacloud.eu |
| UIInstanceURL | https://<instanceURL>/ecpqui | https://<instanceURL>/ecpqui | https://<instanceURL>/ecpqui |
| UpsertQuotesEndpointURL | https://<instanceURL>/api/quote/vi/quotes/upsert-quote | https://<instanceURL>/api/quote/vi/quotes/upsert-quote | https://<instanceURL>/api/quote/vi/quotes/upsert-quote |
| AcceptQuoteEndpointURL | https://<instanceURL>/api/quote/v1/quotes/{quote-id}/accept | https://<instanceURL>/api/quote/v1/quotes/{quote-id}/accept | https://<instanceURL>/api/quote/v1/quotes/{quote-id}/accept |
| ActivateOrderEndpointURL | https://<instanceURL>/api/order/v1/orders/{order-id}/activate | https://<instanceURL>/api/order/v1/orders/{order-id}/activate | https://<instanceURL>/api/order/v1/orders/{order-id}/activate |
| DataURL | https://<instanceURL>/api/data/v1/objects/ | https://<instanceURL>/api/data/v1/objects/ | https://<instanceURL>/api/data/v1/objects/ |
| QuoteURL | https://<instanceURL>/cpq/quotes/{quote-id}/ | https://<instanceURL>/cpq/quotes/{quote-id}/ | https://<instanceURL>/cpq/quotes/{quote-id}/ |
| CollaborationRequestURL | https://<instanceURL>/api/cart/v1/carts/collaboration-request | https://<instanceURL>/api/cart/v1/carts/collaboration-request | https://<instanceURL>/api/cart/v1/carts/collaboration-request |
| LoginURL | https://login-rls.congacloud.com | https://login.congacloud.au | https://login.congacloud.eu |
| Coreapps | https://coreapps-rlsprod.congacloud.com | https://coreapps.congacloud.au | https://coreapps.congacloud.eu |
| XAEndpoint | https://xauthor-prod-rls10.congacloud.com | https://xauthor.congacloud.au | https://xauthor.congacloud.eu |
| SignEndpoint | https://coreapas-rls10.congacloud.com | https://coreapps.congacloud.au | https://coreapps.congacloud.eu |
| ComposerEndpoint | https://coreapps-rls10.congacloud.com | https://coreapps.congacloud.au | https://coreapps.congacloud.eu |
| MyApprovalsPageURL | https://<instanceURL>/approvals/my-approvals/?hideNav=true | https://<instanceURL>/approvals/my-approvals/?hideNav=true | https://<instanceURL>/approvals/my-approvals/?hideNav=true |
| Forward-SyncURL | https://<instanceURL>/api/datasync/v1/forward-sync | htpps://<instanceURL>/api/datasync/v1/forward-sync | htpps://<instanceURL>/api/datasync/v1/forward-sync |
APTS_RLPInstanceSettings for the Preview environment.| Admin Setting Entries | Description | ||
|---|---|---|---|
| SPAClientId | A single-page application ID. Enter the SPAClientId that you generated after configuring the UI to API configuration. | ||
| URLs | URL for NA region | URL for AU region | URL for EU region |
| InstanceURL | https://preview-rls09.congacloud.com | https://rls-preview.congacloud.au | https://rls-preview.congacloud.eu |
| UIInstanceURL | https://<instanceURL>/ecpqui | https://<instanceURL>/ecpqui | https://<instanceURL>/ecpqui |
| UpsertQuotesEndpointURL | https://<instanceURL>/api/quote/vi/quotes/upsert-quote | https://<instanceURL>/api/quote/vi/quotes/upsert-quote | https://<instanceURL>/api/quote/vi/quotes/upsert-quote |
| AcceptQuoteEndpointURL | https://<instanceURL>/api/quote/v1/quotes/{quote-id}/accept | https://<instanceURL>/api/quote/v1/quotes/{quote-id}/accept | https://<instanceURL>/api/quote/v1/quotes/{quote-id}/accept |
| ActivateOrderEndpointURL | https://<instanceURL>/api/order/v1/orders/{order-id}/activate | https://<instanceURL>/api/order/v1/orders/{order-id}/activate | https://<instanceURL>/api/order/v1/orders/{order-id}/activate |
| DataURL | https://<instanceURL>/api/data/v1/objects/ | https://<instanceURL>/api/data/v1/objects/ | https://<instanceURL>/api/data/v1/objects/ |
| QuoteURL | https://<instanceURL>/cpq/quotes/{quote-id}/ | https://<instanceURL>/cpq/quotes/{quote-id}/ | https://<instanceURL>/cpq/quotes/{quote-id}/ |
| CollaborationRequestURL | https://<instanceURL>/api/cart/v1/carts/collaboration-request | https://<instanceURL>/api/cart/v1/carts/collaboration-request | https://<instanceURL>/api/cart/v1/carts/collaboration-request |
| LoginURL | https://login-rlspreview.congacloud.com | https://login-preview.congacloud.au | https://login-preview.congacloud.eu |
| Coreapps | https://coreapps-rlspreview.congacloud.com | https://coreapps-preview.congacloud.au | https://coreapps-preview.congacloud.eu |
| XAEndpoint | https://xauthor-preview-rls09.congacloud.com | https://xauthor-preview.congacloud.au | https://xauthor-preview.congacloud.eu |
| SignEndpoint | https://coreapps-rlspreview.congacloud.com | https://coreapps-preview.congacloud.au | https://coreapps-preview.congacloud.eu |
| ComposerEndpoint | https://coreapps-rlspreview.congacloud.com | https://coreapps-preview.congacloud.au | https://coreapps-preview.congacloud.eu |
| MyApprovalsPageURL | https://<instanceURL>/approvals/my-approvals/?hideNav=true | https://<instanceURL>/approvals/my-approvals/?hideNav=true | https://<instanceURL>/approvals/my-approvals/?hideNav=true |
| Forward-SyncURL | htpps://<instanceURL>/api/datasync/v1/forward-sync | htpps://<instanceURL>/api/datasync/v1/forward-sync | htpps://<instanceURL>/api/datasync/v1/forward-sync |
