MACROMEDIA COLDFUSION MX 61-CFML, Reference

Page: 309 / 806

cfsearch 309
■
cf_root \lib\common\style\file
•
Unix:
■
cf_root /lib/common/style (typically, cf_root = /opt/coldfusionmx)
■
cf_root /lib/common/style/custom
■
cf_root
/lib/common/style/file
Note: To search for a character such as an angle bracket (< or >), you must use a criteria attribute
value such as "&lt:" or "&lt:" . The bracket characters are reserved in Verity, and using a
backslash to escape the character (
criteria="\<"
) does not work in this context. For more
information, see Chapter 25, “Using Verity Search Expressions,” in Developing ColdFusion MX
Applications.
Macromedia does not recommend using the
cflock
tag with this tag; Verity provides the locking
function. Using the
cflock
tag slows search performance.
This tag returns a record set whose columns you can reference in a
cfoutput
tag. For example,
the following code specifies a search for the exact terms "filming" or "filmed":
<cfsearch
name = "mySearch"
collection = "myCollection"
criteria = '<WILDCARD>`film{ing,ed}`'
type="explicit"
startrow=1>
<cfdump var = "#mySearch#>
In this example, the single quotation mark (
'
) and backtick (
`
) characters are used as delimiters;
for more information, see Chapter 25, “Using Verity Search Expressions,” in Developing
ColdFusion MX Applications .
cfsearch result columns
Variable Description
url Value of URLpath attribute in the
cfindex
tag used to populate a collection. If
type = "custom"
, the value is always empty when you populate a collection.
key
Value of the attribute in the
cfindex
tag used to populate collection
title
Value of
title
attribute in
cfindex
operation used to populate the collection,
including PDF and Office document titles. If title is not provided, the tag uses
the
cfindex title
attribute value for each row.
score
Relevancy score of document based on search criteria
custom1, custom2
Value of custom fields in
cfindex
operation used to populate collection.
summary
Contents of automatic summary generated by
cfindex
.
Default: best three matching sentences, up to 500 characters.
recordCount
Number of records returned in record set
currentRow
Current row that
cfoutput
is processing
columnList
List of column names within record set
recordsSearched
Number of records searched