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.

Refer to the following topics for step-by-step instructions to complete the setup and configuration of Turbo Asset-Based Ordering:

To configure the service URL

  1. Go to Setup > Custom Settings.
  2. Go to Turbo Engine Admin Properties.
  3. Click Manage.
  4. Click New.
  5. Enter the following required properties:
    • Name: LightsaberServiceUrl
    • TurboEngines service Endpoint: Endpoint URL provided by Conga CloudOps. For example, https://<tenant code>.congacloud.io.
  6. Click Save.

  • The endpoint URL is provided by Conga Cloud Ops.
  • Do not enter the '/' symbol at the end of the TurboEngines service Endpoint URL. 

To configure admin settings

  1. Log in to Salesforce.
  2. Click and click Admin. All the standard admin settings are displayed on the Admin home page. 
  3. 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://)

      Do not enter the '/' symbol at the end of the TurboEngines service Endpoint URL. 

  4. Click Save.

To configure the CSP Trusted Site

  1. Go to Setup > CSP Trusted Sites.
  2. Click New Trusted Site.
  3. 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)).
  4. 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. 

To perform manual synchronization

  1. Login to Salesforce.
  2. Go to Salesforce App Launcher > TurboEngines Admin
  3. 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
  4. Go to the Sync Settings page.
  5. Click Sync Now. The data sync process is begun and you are redirected to the Run History tab.
  6. Review Run History to view sync details and any associated errors. 

To perform health checks using REST APIs 

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

APISwagger Link
Pricing
Data Integration
Scheduler
Data Admin

To perform Synchronization 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

ParameterRequired?
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>
]
CODE

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 
}
CODE