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. [. . . ] If you omit this attribute, cfregistry creates default value, as follows: · string: creates an empty string: "" · dWord: creates a value of 0 (zero) value Optional Usage If it does not exist, cfregistry creates the key or value. Example <!--- This example uses cfregistry Set Action to modify registry value data --> <!--- Normally you pass in a file name instead of setting one here. ---> <cfset FileName = "dummy. cfm"> <cfregistry action = "set" branch = "HKEY_LOCAL_MACHINE\Software\cflangref" entry = "LastCFM01" type = "String" value = "#FileName#"> <h1>cfregistry action = "set"</h1> cfregistry 293 cfregistry action = "delete" Description Deletes a registry key or value. Syntax <cfregistry action = "delete" branch = "branch" entry = "keyorvalue"> Attributes Attribute action branch Req/Opt Required Required Default Description delete · For key deletion: name of registry key to delete. · For value deletion: name of registry branch that contains value to delete. Value to delete entry Usage Required for value deletion If you delete a key, cfregistry also deletes values and subkeys defined beneath it. Example <cfregistry action = "delete" branch = "HKEY_LOCAL_MACHINE\Software\cflangref\tempkey" entry = "LastCFM01"> <h1>cfregistry action = "delete"</h1> 294 Chapter 2: ColdFusion Tags cfreport Description Runs a predefined Crystal Reports report. Uses the CFCRYSTAL. exe file to generate reports. Sets parameters in the Crystal Reports engine according to its attribute values. Category Extensibility tags Syntax <cfreport report = "report_path" dataSource = "ds_name" type = "type" timeout = "number of seconds" orderBy = "result_order" username = "username" password = "password" formula = "formula"> </cfreport> See also cfcollection, cfexecute, cfindex, cfobject, cfsearch, cfwddx History ColdFusion MX: Changed data source connection behavior: Crystal Reports now establishes an independent connection to the data source. The connection is not subject to any ColdFusion data source-specific restrictions. For example, the Crystal Reports server can access a data source, regardless of whether it is disabled in the ColdFusion Administrator. Attributes Attribute Req/Opt Default Description Name of registered or native data source. datasource Optional type Optional standard · standard (not valid for Crystal Reports 8. 0) · netscape · microsoft Optional Required Optional Optional Maximum time, in seconds, in which a connection must be made to a Crystal Report. Store Crystal Reports files in the same directories as ColdFusion page files. Orders results according to your specifications. Username required for entry into database from which report is created. Overrides default settings for data source in ColdFusion Administrator. timeout report orderBy username cfreport 295 Attribute password Req/Opt Default Description Optional Password that corresponds to username required for database access. Overrides default settings for data source in ColdFusion Administrator. Terminate each formula with a semicolon. Use the format: formula = "formulaname1 = 'formula1';formulaname2 = 'formula2';" If you use a semicolon in a formula, you must escape it by typing it twice (;;). For example: formula = "Name1 = 'Val_1a;;Val_1b';Name2 = 'Val2';" formula Optional Usage This tag requires an end tag. Example <!--- This view-only example shows the use of cfreport ---> <h3>cfreport Tag<h3> <p>cfreport lets reports from the Crystal Reports Professional report writer display through a ColdFusion interface. To run, the tag requires the name of the report. cfreport can also pass information to the report file displayed, to change the output conditions. <p>This example would run a report called "monthlysales. rpt " and pass it an optional filter condition to show only the information for a subset of the report. <cfreport report = '/reports/monthlysales. rpt'> {Departments. Department} = `International' </cfreport> <p>Substitute your report files and filters for this code. cfreport can put Crystal Reports into web pages. 296 Chapter 2: ColdFusion Tags cfrethrow Description Rethrows the currently active exception. Preserves the exception's cfcatch. type and cfcatch. tagContext variable values. Category Exception handling tags, Extensibility tags Syntax <cfrethrow> See also cferror, cfthrow, cftry Usage Use this tag within a cfcatch block. [. . . ] Supports the following parameter types: · name · type · value CF. http params are passed as an array of objects. The params argument is required for POST operations. url username password resolveurl params Optional 802 Chapter 7: ColdFusion ActionScript Functions Arguments path file Req/Opt Description Optional Optional The path to the directory in which to store files. When using the path argument, the file argument is required. For GET operations, defaults to the name specified in the url argument. [. . . ]