User manual MACROMEDIA COLDFUSION MX 61-CFML REFERENCE

[. . . ] CFML Reference Trademarks Afterburner, AppletAce, Attain, Attain Enterprise Learning System, Attain Essentials, Attain Objects for Dreamweaver, Authorware, Authorware Attain, Authorware Interactive Studio, Authorware Star, Authorware Synergy, Backstage, Backstage Designer, Backstage Desktop Studio, Backstage Enterprise Studio, Backstage Internet Studio, ColdFusion, Design in Motion, Director, Director Multimedia Studio, Doc Around the Clock, Dreamweaver, Dreamweaver Attain, Drumbeat, Drumbeat 2000, Extreme 3D, Fireworks, Flash, Fontographer, FreeHand, FreeHand Graphics Studio, Generator, Generator Developer's Studio, Generator Dynamic Graphics Server, JRun, Knowledge Objects, Knowledge Stream, Knowledge Track, Lingo, Live Effects, Macromedia, Macromedia M Logo & Design, Macromedia Flash, Macromedia Xres, Macromind, Macromind Action, MAGIC, Mediamaker, Object Authoring, Power Applets, Priority Access, Roundtrip HTML, Scriptlets, SoundEdit, ShockRave, Shockmachine, Shockwave, Shockwave Remote, Shockwave Internet Studio, Showcase, Tools to Power Your Ideas, Universal Media, Virtuoso, Web Design 101, Whirlwind and Xtra are trademarks of Macromedia, Inc. and may be registered in the United States or in other jurisdictions including internationally. Other product names, logos, designs, titles, words or phrases mentioned within this publication may be trademarks, servicemarks, or tradenames of Macromedia, Inc. or other entities and may be registered in certain jurisdictions including internationally. [. . . ] <p>Your string value was: <b><I>#StringVar#</i></b></cfoutput> <cfelse> 306 Chapter 2: ColdFusion Tags cfsearch Description Searches Verity collections using ColdFusion or K2Server, whichever search engine a collection is registered by. (ColdFusion can also search collections that have not been registered, with the cfcollection tag. ) A collection must be created and indexed before this tag can return search results. A collection can be created in these ways: · With the cfcollection tag · In the ColdFusion Administrator, which calls the cfcollection tag · Externally, using a native Verity indexing tool, such as Vspider or MKVDK A collection can be registered with ColdFusion in the following ways: · With the cfcollection tag · In the ColdFusion Administrator, which calls the cfcollection tag A collection can be registered with K2Server by editing the k2server. ini file. A collection can be indexed in the following ways: · In ColdFusion, with the cfindex tag · In the ColdFusion Administrator, which calls the cfindex tag · Using a native Verity indexing tool, such as Vspider or MKVDK For more information, see Chapter 24, "Building a Search Interface, " in Developing ColdFusion MX Applications. Category Extensibility tags Syntax <cfsearch name = "search_name" collection = "collection_name" type = "criteria" criteria = "search_expression" maxRows = "number" startRow = "row_number" language = "language"> See also cfcollection, cfexecute, cfindex, cfobject, cfreport, cfwddx History ColdFusion MX: · Deprecated the external attribute. (ColdFusion stores this information about each collection; it automatically detects whether a collection is internal or external. ) This tag supports absolute (also known as fully qualified) collection pathnames and mapped collection names. Changed query result behavior: the cfindex tag can index the query results from a cfsearch operation. · cfsearch 307 · Changed Verity operations behavior: ColdFusion supports Verity operations on Acrobat PDF files. · Changed multiple collection behavior: this tag can search multiple collections. In a multiple · · · collection search, you cannot combine collections that are registered with K2Server and registered in another way. Changed acceptable collection naming: this tag accepts collection names that include spaces. Changed the following support: this tag supports Verity 2. 6. 1 and the LinguistX and ICU locales. Changed thrown exceptions: this tag can throw the SEARCHENGINE exception. Attributes Attribute Req/Opt name Required Default Description Name of the search query. Registered names are listed in the ColdFusion Administrator, Verity Collections and Verity Server pages. For example: "CFUSER, e:\collections\personnel" If you specify multiple collections, you cannot include a combination of collections that are registered by K2Server and registered by Verity. See Chapter 25, "Using Verity Search Expressions, " in Developing ColdFusion MX Applications. · explicit: operators must be invoked explicitly Search criteria. If you pass a mixed-case entry in this attribute, the search is casesensitive. If you pass all uppercase or all lowercase, the search is case-insensitive. Follow Verity syntax and delimiter character rules; see Chapter 25, "Using Verity Search Expressions, " in Developing ColdFusion MX Applications. First row number to get. collection Required type Optional criteria Optional maxRows Optional startRow language Usage Optional Optional english For options, see cfcollection on page 80. Requires the ColdFusion International Search Pack. To permit application users to search Verity collections for non-standard strings, words or characters (for example, "AB23. 45. 67" or "--->") that would otherwise cause an error, you can create a text file that lists these elements and defines their formats for Verity. Name the file style. lex and put copies of the file in these directories: · Windows: cf_root\lib\common\style (typically, cf_root = c:\cfusionmx) cf_root\lib\common\style\custom 308 Chapter 2: ColdFusion Tags · 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. [. . . ] · post: sends information to the server page or CGI program for processing. Required The absolute URL of the host name or IP address of the server on which the file resides. For GET and POST operations, if Yes, the page reference that is returned into the Filecontent property has its internal URLs fully resolved, including port number, so that links remain intact. The following HTML tags, which can contain links, are resolved: - img src - a href - form action - applet code - script src - embed src - embed pluginspace - body background - frame src - bgsound src - object data - object classid - object codebase - object usemap HTTP parameters passed as an array of objects. [. . . ]