Lucee Tag Reference

<cfsearch>

Executes searches against data indexed

Body

This tag can't have a 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]>
This tag is also supported within cfscript
<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

The attributes for this tag are fixed. Except for the following attributes no other attributes are allowed.
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.