Salesforce CPQ Plugins
jJavascript Quote Calculator Plugins
| Available in: Salesforce CPQ Winter ’16 and later |
When you develop a plugin for the Javascript Quote Calculator, consider key guidelines.
Promises
A Promise is a built-in JavaScript object that allows for asynchronous programming in the browser. Promises let you delay a certain action until another one has completed. Promises support a .then(success, failure) method, where success is a function called when the promise resolves successfully, and failure is a function called when the promise is rejected. If you want to do any asynchronous programming in the plugin, such as a server callout, you must return a promise that resolves once that action is completed. This guarantees that calculation steps occur in the proper order. If a method doesn’t require asynchronous behavior, you can return a promise that resolves immediately as return Promise.resolve();. Promises can resolve to a value, which passes as a parameter to the .then() callbacks. You can use this fact in your own code, but remember that the promises that these methods return don’t need to resolve to a value. Always directly modify the quote and line models provided in the parameters.
QuoteModel and QuoteLineModel Types
The JavaScript calculator represents Quote__c and QuoteLine__c objects as QuoteModel and QuoteLineModel objects respectively. You can access the underlying SObject through the .record property on both objects, which lets you reference fields by using their API name. For example, you can reference a custom field SBQQ__MyCustomField__c on a given QuoteLineModel by accessing the attribute record [”SBQQ__MyCustomField__c”]. You can also reference fields on related records. For example, if you want to reference the field MyField__c on an account associated with a quote, access the record ["Account__r"]["MyField__c"].
Salesforce Field Types
You can change records stored in JavaScript Object Notation, or JSON. These records are serialized from your org. Number, Text, and Boolean fields are all stored without any conversion, but you can convert any other type. For example, dates are represented as strings of the format "YYYY-MM-DD." If you reference or change a field containing a date, you have to preserve that format.
JSForce
JSForce is a third-party library that provides a unified way to perform queries, execute Apex REST calls, use theMetadata API, or make HTTP requests remotely. Methods access jsforce through the optional parameter conn.