Search Expression

Definition

Expression type in the Business Rule Framework (BRF) for CRM that supports the definition of search expressions for CRM cases, CRM transactions, and transaction items.

Note Note

Search expressions are identified by the icon in the BRF.

End of the note.

Structure

Search Object

In addition to the BRF expression types in the standard SAP system, the expression type Search Expression (implementing class 0CRM_SEARCH_EXP) enables you to define searches for CRM cases, transactions, and transaction items in CRM. The following search objects are provided for this purpose:

Case (CASE)
Transaction header (ORDER_H)
Transaction item (ORDER_I)

You can also combine the individual search objects with one another by defining a predecessor search expression. A predecessor search expression is not supported for the search object CASE.

Search Attribute

For each search object, you can select search attributes that can be used to filter the result selection. The result of a search expression comprises object keys that can be processed further in the Business Rule Framework.

You can combine the search attributes using “AND” and “OR” operations. If you combine several expressions for a search attribute with one another as individual values or an interval using the Multiple Selection function, you get a totaling of the individual values, in other words, an “OR” operation. When you combine several search attributes for a search expression, you get a result filtering. With this “AND” operation, the result of the search expression is the intersection of the results of all of the search attributes. The search attributes of the product constitute an exception to the “AND” operation (see table below).

Note Note

If you created customer enhancements to the transaction header, the transaction item, or to Case Management in the Easy Enhancement Workbench ( EEW ), you can also select the associated customer fields as search attributes.

End of the note.

Particular Features of Various Search Attributes

Search Attribute	Particular Features
Case Management: Status	For an overview of the values for the system status, see Case Management Extended Customizing Create Status Profile in Customizing for CRM.
Case Management: Reference Category	Specify the category ID that is used in multilevel categorization .
Transaction: Status	An overview of the system statuses is provided in transaction BS23.
Transaction: Timestamp From / Timestamp To	Note that the values transferred can be different and depend on the respective business object of the transaction. You can check which values these are for the respective business object using the module CRM_ORDER_INDEX_DATES_GET.
Transaction: Partner and 2nd Partner	Make sure that when both business partners are selected in a search expression, unique values are output for both partners. Multiple selection is not supported.
Transaction: Partner Function	To improve system performance, determination is based on the partner function category. You can also activate the search selectively for the partner function (see SAP Note 580479).
Product: Product Name , Product GUID, Category Hierarchy ID, Category ID	The search attributes Category Hierarchy ID and Category ID must always be selected together for a search expression. Note that the search attributes of the product cannot be combined using an “AND” operation. For a category ID, the system searches for all products or their items that are assigned to this category.

Integration

The Business Add-In CRM_BRF_SEARCH enables you to add search attributes to the search structure, or to influence the search result at runtime. For more information, see Business Rule Framework Business Add-Ins (BAdIs) BAdI: Enhance Search in Search Expression in BRF Customizing for the respective application.
The tag class CL_CRM_BRF_TAG_GET_EXPRESSION is provided for defining tags that read their result values from search expressions.