- 23 Sep 2024
- 1 Minute to read
- Print
- DarkLight
Additional Approval Action
- Updated on 23 Sep 2024
- 1 Minute to read
- Print
- DarkLight
Purpose
Allows you to run a script to enable custom capabilities in the quote approval process, such as transfer the approval process to an external system.
Setup
To set up the extension point, follow these steps:
- Create a Groovy script in Zilliant CPQ.
- Set up the approval workflow.
Create a Groovy script
Create a Groovy script in Zilliant CPQ. Select Additional Approval Action as the script type.
For details about creating and configuring Groovy scripts, read Upload a Groovy script.
Set up the approval workflow
From the application left navigation area, select Administration.
From the top navigation bar, select Master Data Management.
Scroll or search to locate Approval Gate and select it from the list.
Select +.
Select the newly added, empty row. On the Configuration tab, enter or select values to create an approval workflow:
- Name—Approval workflow name.
- Script to Execute—Select the script of the Additional Approval Action type.
Select Save.
Binding variables
In addition to the common binding variables, the following binding variables are available for this extension point.
Variable name | Class | Description |
---|---|---|
salesItemsTree | SalesItemsTree | Represents the quote. Contains functions you can use to query and modify the quote and its line items. |
approvalGate | ApprovalGate | Approval gate that triggers the script. |
Expected output
The script should return string objects.
Script execution
The script of the Additional Approval Action type is run when all the following conditions are met:
- A user submits an open quote.
- The defined approval gate is applicable to the quote based on the approval rules.
- The script of the Additional Approval Action type is assigned to the approval gate.
The script output automatically displays as a note in the quote.