Pipelet Search
This pipelet executes either a product or content search, as specified by the configuration parameters, and returns a corresponding ProductSearchModel or ContentSearchModel. The SearchPhrase parameter can be used with either search. The FolderID and ContentID parameters are specific to the content search. All other parameters are specific to the product search. Product search refinements are filtered by session currency.
Group:
Search
Configuration Properties
DisallowOfflineCategory
:
Boolean
(Optional)
If set to true, the pipelet checks if the passed cgid parameter represents an offline category. In this case, it is treated like an invalid cgid. If set to false, the pipelet will execute the search also in offline categories.
Permissible Values:
false
true
RecursiveCategorySearch
:
String
(Optional)
If set to true, the pipelet will execute a recursive category search. Otherwise, the pipelet will only search within the selected category. Default is 'false'.
Permissible Values:
false
true
RecursiveFolderSearch
:
String
(Optional)
If set to true, the pipelet will execute a recursive folder search. Otherwise, the pipelet will only search within the selected folder. Default is 'false'.
Permissible Values:
false
true
SearchContent
:
String
(Optional)
If set to true, the pipelet will execute a content search and returns the ContentSearchModel. Default is 'true'.
Permissible Values:
false
true
SearchProduct
:
String
(Optional)
If set to true, the pipelet will execute a product search and returns the ProductSearchModel. Default is 'true'.
Permissible Values:
false
true
Input Parameters
SearchPhrase
:
String
(Optional)
The search phrase used in this search. The search query parser uses the following operators:
- PHRASE operator (""), e.g. "cream cheese", "John Lennon"
- NOT operator (-), e.g. -cargo (will not return results containing "cargo")
- WILDCARD operator (*), e.g. sho* (will return results containing "shoulder", "shoes" and "shoot")
SortBy1
:
String
(Optional)
If specified, the search result is sorted by the specified criteria. The supplied value can either be the id of a defined sorting attribute, e.g. "name" or "brand". To sort by price, value "price" must be specified. For backward compatibility, names of search index sort fields can still be specified, such as "price-sort" or "name-sort".
SortBy3
:
String
(Optional)
If specified, the search result is additionally sorted by the specified criteria. The supplied value can either be the id of a defined sorting attribute, e.g. "name" or "brand". To sort by price, value "price" must be specified. For backward compatibility, names of search index sort fields can still be specified, such as "price-sort" or "name-sort".
SortBy2
:
String
(Optional)
If specified, the search result is additionally sorted by the specified criteria. The supplied value can either be the id of a defined sorting attribute, e.g. "name" or "brand". To sort by price, value "price" must be specified. For backward compatibility, names of search index sort fields can still be specified, such as "price-sort" or "name-sort".
SortBy1Direction
:
Number
(Optional)
Sort ascending (1) or descending (2).
SortBy2Direction
:
Number
(Optional)
Sort ascending (1) or descending (2).
SortBy3Direction
:
Number
(Optional)
Sort ascending (1) or descending (2).
PriceMax
:
Number
(Optional)
Maximum price condition. Only products whose price is less than this value are included in the result. Products whose prices are equal to or above this value are excluded from the result.
PriceMin
:
Number
(Optional)
Minimum product price condition.
RefineBy1Name
:
String
(Optional)
RefineBy1Phrase
:
String
(Optional)
RefineBy1Min
:
String
(Optional)
RefineBy1Max
:
String
(Optional)
RefineBy2Name
:
String
(Optional)
RefineBy2Phrase
:
String
(Optional)
RefineBy2Min
:
String
(Optional)
RefineBy2Max
:
String
(Optional)
RefineBy3Name
:
String
(Optional)
RefineBy3Phrase
:
String
(Optional)
RefineBy3Min
:
String
(Optional)
RefineBy3Max
:
String
(Optional)
RefineBy4Name
:
String
(Optional)
RefineBy4Phrase
:
String
(Optional)
RefineBy4Min
:
String
(Optional)
RefineBy4Max
:
String
(Optional)
RefineBy5Name
:
String
(Optional)
RefineBy5Phrase
:
String
(Optional)
RefineBy5Min
:
String
(Optional)
RefineBy5Max
:
String
(Optional)
CategoryID
:
String
(Optional)
ProductID
:
String
(Optional)
FolderID
:
String
(Optional)
ContentID
:
String
(Optional)
RefineByNamePrefix
:
String
(Optional)
The URL parameter prefix used to provide names of refinement attributes. The prefix is followed by a running number to connect it to the value of the attribute to refine on (e.g. prefn1=myAttribute&prefv1=myValue).
RefineByPhrasePrefix
:
String
(Optional)
The URL parameter prefix used to provide values for a search refinement. The prefix is followed by a running number to connect it to the name of the attribute to refine on (e.g. prefn1=myAttribute&prefv1=myValue).
RefineByMinPrefix
:
String
(Optional)
RefineByMaxPrefix
:
String
(Optional)
OrderableProductsOnly
:
Boolean
(Optional)
Optional control flag which determines if unorderable products (i.e products with ATS = 0) should be excluded from search results. Pass a value of true in order to exclude unorderable products, and false to include them. If no value is passed, then the default search preference controls the behavior.
SortingRuleID
:
String
(Optional)
The ID of a sorting rule to use to sort the products in the search results. If no ID is provided, the default sorting rule is used for the given category, or the root category if no category is provided. This property is ignored for a content search.
PromotionID
:
String
(Optional)
Optional promotion id to filter products in the search results. Multiple promotion id's must be encoded by the pipe symbol ('|'). Note: The search supports up to 30 promotion id's. If the value string contains more than 30 id's only the first 30 will be considered.
PromotionProductType
:
String
(Optional)
The type of product to filter by when searching by promotion ID. Allowed values are ProductSearchModel.PROMOTION_PRODUCT_TYPE_ALL, ProductSearchModel.PROMOTION_PRODUCT_TYPE_QUALIFYING, and ProductSearchModel.PROMOTION_PRODUCT_TYPE_DISCOUNTED. If null is passed, or an invalid value is passed, the search will use ProductSearchModel.PROMOTION_PRODUCT_TYPE_ALL.
TrackingEmptySearchesEnabled
:
Boolean
(Optional)
Set it to be true or null to enable tracking empty searches for predictive intelligence use. Set it to be false to disable tracking empty searches.
SortingOptionID
:
String
(Optional)
The ID of a sorting option to use to sort the products in the search results. Will not be used if a sorting rule is set.
Output Parameters
ProductSearchModel
:
ProductSearchModel
:
(Required)
ContentSearchModel
:
ContentSearchModel
:
(Optional)