Download PDF
Download page Creating Search Filters (Approvals).
Creating Search Filters (Approvals)
The two Filter Type options (Child Filter and Entry Criteria) serve two different purposes.
Filter Type | Purpose |
---|---|
Entry Criteria | This is required for approvals to be initiated from the shopping cart. To improve performance, the system checks if any entry criteria search filters match the attributes in the shopping cart and sets the approval status to Approval Required. You can use the entry criteria at the line item to set the approval status to Approval Required or Approval Triggered. |
Child Filter | This is required for a header-level approval step entry criterion that uses line-item fields for products in the shopping cart. After you create a child filter, you must create a step entry criterion using child filters that mirror the expression used in the child filter. |
Configuring Search Filters
Entry criteria-type search filters check whether a shopping cart's contents require approval before it can be finalized.
To trigger approvals at the shopping cart header level, configure the search filters based on the Product Configuration context object. To trigger approvals at a specific cart line-item level, configure search filters for the line item context object. For consolidated approvals for the whole cart/product configuration, create both.
Configuring Search Filters: This adds product configuration to the search filter object's picklist, so you can create search filters that use these objects for their entry criteria.
To create Search Filters (Approvals): Search filters determine if products in the shopping cart require approval.
To configure Search Filters (Approvals)
- Go to Setup > Build > Create > Objects and select Search Filter (Approvals).
- Select Business Object from the Custom Fields & Relationships section.
- From Picklist Values, click New and enter the API names for the cart and the line items: Apttus_Config2__ProductConfiguration__c for header-level approvals, and Apttus_Config2__LineItem__c for line-item-level approvals.
- Click Save. The values are added to the Picklist Values list.
- Click Back to Search Filter (Approvals) and select Filter Type from the Custom Fields & Relationships section.
- From Picklist Values, click New and enter
Child Filter
andEntry Criteria
. - Click Save.
The values are added to the picklists, which are required to create search filters.
You can create Search Filters (Approvals) to control which carts to check if they need approval.
The search filter field size accommodates 16,000 characters.
To create Search Filters (Approvals)
- Click the plus-sign icon (
) and select Search Filter (Approvals).
- Click New Search Filter (Approvals) and select either of:
- Product Configuration: Select this to set the filter to the Product Configuration/Shopping Cart (Header) context object level.
- Line Item: Select this to set the filter to the line-item context object level, filtering individual line items within the cart.
- Click Next, raising the Configure Filter page.
- From Filter Type, select one of:
- Child Filter: This enables step entry criteria in your approval process that reference the main context object's child record fields. This enables you to use line-item fields with your product configuration approval process. The line-item child filters you create here make them available for approval step entry criteria.
- Entry Criteria: This indicates that the search filter will be used for the Approval Required check, which checks whether the quote or quote line-item values require the shopping cart to be approved. This adds a level of entry criteria for approvals before the system searches for matching approval processes. At least one of these must be set for approvals to be available from the shopping cart.
- Enter a required filter name and sequence. The sequence sets the order in which the search filters will check if approvals are required.
- Enter a filter criterion, which is used to determine if the quote requires approval.
- Click Save.
The search filter is now active. If it is of the entry criteria filter type, the system will use it to determine if a shopping cart requires approval.
You must create an approval process that can be used with the shopping cart.