Lucee Tag Reference

<cfsearch>

Body

Example

<cfsearch
	[category=string]
	[categorytree=string]
	collection=string
	[contextbytes=number]
	[contexthighlightbegin=string]
	[contexthighlightend=string]
	[contextpassages=number]
	[criteria=string]
	[external=boolean]
	[language=string]
	[maxrows=number]
	name=string
	[previouscriteria=string]
	[startrow=number]
	[status=string]
	[suggestions=string]
	[type=string]>

<cfscript>
	search
		[category=string]
		[categorytree=string]
		collection=string
		[contextbytes=number]
		[contexthighlightbegin=string]
		[contexthighlightend=string]
		[contextpassages=number]
		[criteria=string]
		[external=boolean]
		[language=string]
		[maxrows=number]
		name=string
		[previouscriteria=string]
		[startrow=number]
		[status=string]
		[suggestions=string]
		[type=string];
</cfscript>

Attributes

Name	Type	Required	Description
category	string	No	A list of categories, separated by commas, to which the search is limited. If specified, and the collection does not have categories enabled, Lucee throws an exception.
categorytree	string	No	The location in a hierarchical category tree at which to start the search. Lucee searches at and below this level. If specified, and the collection does not have categories enabled, Lucee throws an exception. Can be used in addition to category attribute.
collection	string	Yes	The logical collection name that is the target of the search operation or an external collection with fully qualified path.
contextbytes	number	No	The maximum number of bytes Lucene returns in the context summary. Default: 300
contexthighlightbegin	string	No	The HTML to prepend to search terms in the context summary. Use this attribute in conjunction with contextHighlightEnd to highlight search terms in the context summary. Default:
contexthighlightend	string	No	The HTML to prepend to search terms in the context summary. Use this attribute in conjunction with contextHighlightEnd to highlight search terms in the context summary. Default:
contextpassages	number	No	The number of passages/sentences Lucene returns in the context summary (that is, the context column of the results). Default: 3
criteria	string	No	Specifies the criteria for the search following the syntactic rules specified by type.
external	boolean	No	This Attribute is deprecated
language	string	No	This Attribute is deprecated
maxrows	number	No	Specifies the maximum number of entries for index queries. If omitted, all rows are returned.
name	string	Yes	A name for the search query.
previouscriteria	string	No	The name of a result set from an existing set of search results. Lucene searches the result set for criteria without regard to the previous search score or rank. Use this attribute to implement searching within result sets.
startrow	number	No	Specifies the first row number to be retrieved. Default is 1.
status	string	No	Specifies the name of the structure variable into which Lucee places search information, including alternative criteria suggestions (spelling corrections).
suggestions	string	No	Specifies whether Lucene returns spelling suggestions for possibly misspelled words.
type	string	No	Specifies the criteria type for the search.