Turbo Asset-Based Ordering Specific Settings Configuration

This section provides information for setting up the Turbo Asset-Based Ordering in the org.

You must configure the Turbo service URL, admin settings and a CSP Trusted Site entry so SFDC can communicate with an external server. For more information, see Configuring Asset-Based Ordering.

Configuring service URL

Go to Setup > Custom Settings.
Go to Turbo Engine Admin Properties.
Click Manage.
Click New.
Enter the following required properties:
- Name: LightsaberServiceUrl
- TurboEngines service Endpoint: Endpoint URL provided by Conga CloudOps. For example, https://<tenant code>.congacloud.io.
Click Save.
Note:
- The endpoint URL is provided by Conga Cloud Ops.
- Do not enter the '/' symbol at the end of the TurboEngines service Endpoint URL.

Configuring admin settings

Log in to Salesforce.
Click

and click Admin.
All the standard admin settings are displayed on the Admin home page.
Open the following admin settings and ensure that the Value fields are updated with the TurboEngine service Endpoint URL.
1. APTS_PricingServiceOverrideURI (without https://)
2. APTS_PricingServiceUrl (with https://)
  
  Note:
  Do not enter the '/' symbol at the end of the TurboEngines service Endpoint URL.
Click Save.

Configuring CSP Trusted Site

Go to Setup > CSP Trusted Sites.
Click New Trusted Site.
Enter the following required properties:
1. Enter a Trusted Site Name for the trusted site (for example, "TurboEngineAdminService").
2. Enter the Trusted Site URL (this is the service URL from the previous task (To configure the service URL)).
Click Save.

After completing all configurations, you must perform a health check and synchronization for all objects in the available consumer profiles using the TurboEngines Data Sync User Interface or the following APIs and ensure that the synchronization is successful.

Performing manual synchronization

Before performing manual synchronization, ensure that you have the necessary permissions to access the TurboEngines Admin UI and the Data Integration tab in Salesforce.

It is recommended to familiarize yourself with the TurboEngines Data Sync User Interface to effectively manage synchronization settings.

Login to Salesforce.
Go to Salesforce App Launcher > TurboEngines Admin.
Go to the Data Integration tab. From the list of Consumers, click Manage Sync to open the Admin UI. For more information on Admin UI, see TurboEngines Data Sync User Interface.
Go to the Sync Settings page.
Click Sync Now.
The data sync process is begun and you are redirected to the Run History tab.
Data Sync Run History Overview to view sync details and any associated errors.

Health Checks Using REST APIs

Before performing the synchronization, you must perform a health check for the onboarded tenant.


API	Swagger Link
Pricing	https://<TenantCode>.congacloud.io/pricing/swagger/index.html
Data Integration	https://<TenantCode>.congacloud.io/ds/api/dataintegration/swagger/index_html
Scheduler	https://<TenantCode>.congacloud.io/pricing/scheduler/swagger/index.html
Data Admin	https://<TenantCode>.congacloud.io/pricing/dataadmin/swagger/index.html

Asset Line Item Synchronization with Turbo Using REST APIs

Whenever you create a new asset line item, you must synchronize that with Turbo.

Invoke the following API to perform the real-time synchronization using data integration swagger.

API Details

RealtimeSync

/ds/api/dataintegration/v1/RealtimeSync/{consumerName}/{entityName}

Parameters


Parameter	Required?
consumerName	Yes. The name of the consumer is to be synced. The consumerName depends on what you need to sync and the consumerName is the master data for ALI synchronization. For custom settings sync, the consumerName is the actor.
entityName	Yes. The entityName value depends on the object you want to sync to the tenant. You need to pass the API name. For example, If you are trying to sync newly updated custom settings, you must pass the API name of that custom setting and its Id in the request body.

Request Body

The following example describes the synchronization of a custom setting called Installed Product Settings.

Request Body:

[
<object ID>
]

Response Body

Response Body:

You must get the following response after the successful synchronization.

"syncStatus": 6, // The Sync Status '6' indicates the Synchronization is successful.
"dataPullSummary": { 
<a1234567891": { 
recordsPulled": { 
"npttns_confiv__InstallednroductsSettings_c": [ 
"a1234567891"
]
}, 
"errorDetails': null,
"warningDetil": null
}
}, 
"consumePushSumnary": { 
recordsPushed": [ 
"a1234567891" 
], 
"errorDetails": null 
}, 
"errornetails": null 
}

Conga Product Documentation

Welcome to the new doc site. Some of your old bookmarks will no longer work. Please use the search bar to find your desired topic.