Download PDF
Download page Creating Search Filters.
Creating Search Filters
The two filter type options (Child Filter and Entry Criteria) serve two different purposes.
Filter Type | Purpose |
---|---|
Entry Criteria | This filter type is required to initiate approvals from the shopping cart. To improve performance, the system checks for entry criteria search filters that match attributes in the shopping cart and sets the approval status to Approval Required. Entry criteria at the line item can set the approval status to Approval Required or Approval Triggered. |
Child Filter | This filter type is required for header-level approval step entry criteria that use line-item fields for products in the shopping cart. After creating a child filter, you must create step-entry criteria with child filters that mirror the expression in the child filter. |
Configuring Search Filters
Adding "Product Configuration" to the Search Filter object picklist enables you to create search filters that use these objects as entry criteria.
Entry criteria-type search filters are used to check whether the contents of a shopping cart require approval before the cart can be finalized.
To trigger approvals at the shopping cart header level, you must configure search filters based on the Product Configuration context object. To trigger approvals at a specific cart line-item level, you must configure search filters for the line item context object. To consolidate approvals for the entire cart/product configuration, you must create both.
To configure Search Filters (Approvals)
Search Filters are used to determine if the products in the Shopping Cart require approval.
- Go to Setup > Build > Create > Objects and select Search Filter (Approvals).
- From the Custom Fields & Relationships section, select Business Object.
- 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 andApttus_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) for controlling which carts are checked to see if they need approval.
The search filter field accommodates 16,000 characters.
To create Search Filters (Approvals)
- Click the plus icon () and select Search Filter (Approvals).
- Click New Search Filter (Approvals) and select either:
- Product Configuration to set the filter to the Header (product configuration/shopping cart ) context object level.
- Line Item to set the filter to the line-item context object level, filtering individual line items within the cart.
- Click Next to display the Configure Filter page.
- From Filter Type, select either:
- Child Filter, which enables you to have step entry criteria in your approval process that reference the main context object's child record fields. Typically this enables you to use line-item fields with your product configuration approval process. Line item child filters created are available for approval step entry criteria.
- Entry Criteria, indicating that the search filter will be used for the Approval Required check. This checks to see whether the quote or quote line-item values require the shopping cart to undergo approval. This effectively adds a level of entry criteria for approvals before the system searches for matching approval processes. There must be at least one of these for approvals to be available from the shopping cart.
- Enter a required Filter Name and Sequence. The sequence is used to determine the order in which the search filters check if approvals are required.
- Enter the filter criteria, which are used to determine if a quote requires approval.
- Click Save.
The Search Filter is now active and if it is an 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.