User manual MACROMEDIA COLFUSION MX 7-MIGRATING APPLICATIONS TO COLDFUSION MX 7

[. . . ] COLDFUSION MX 7 ® Migrating Applications to ColdFusion MX 7 Trademarks 1 Step RoboPDF, ActiveEdit, ActiveTest, Authorware, Blue Sky Software, Blue Sky, Breeze, Breezo, Captivate, Central, ColdFusion, Contribute, Database Explorer, Director, Dreamweaver, Fireworks, Flash, FlashCast, FlashHelp, Flash Lite, FlashPaper, Flex, Flex Builder, Fontographer, FreeHand, Generator, HomeSite, JRun, MacRecorder, Macromedia, MXML, RoboEngine, RoboHelp, RoboInfo, RoboPDF, Roundtrip, Roundtrip HTML, Shockwave, SoundEdit, Studio MX, UltraDev, and WebHelp are either registered trademarks or 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, service marks, or trade names of Macromedia, Inc. or other entities and may be registered in certain jurisdictions including internationally. [. . . ] For pages expecting the RequestTimeout attribute in the URL, add the following tag: <cfsetting RequestTimeout = "#URL. RequestTimeout#"> For more information, see the "Reserved Words and Variables" chapter in CFML Reference. Definition of pi ColdFusion MX and ColdFusion 5 define pi with slightly different precision. Therefore, you might obtain slightly different results between the two for trigonometric functions such as sin, cos, and tan at the boundaries (0, 90, 180, 270, . . . Null values ColdFusion 5 converted all null values to an empty string (""). For queries, ColdFusion MX preserves null values, but converts them to an empty string when you use them as simple values. However, when you call a Java method that returns a null value, ColdFusion MX destroys the variable to which the null value was returned. The thisTag scope In ColdFusion 5, you can change system values in the thisTag scope that persist throughout the execution of the tag. This is fixed in ColdFusion MX; it throws an exception if you try to set thisTag. hasendtag or thisTag. executionmode. Caching In ColdFusion MX, in the Caching page of the ColdFusion MX Administrator, the Template cache size (number of templates) option displays the number of templates in the cache. In ColdFusion 5, it displays the size of the cached templates in kilobytes. Other changes 19 Log files ColdFusion MX does not support the following ColdFusion 5 log files: · · · · · · · executive. log remote. log proxy. log cfadmin. log install. log server. stdout rdsservice. stdout Using cfform in a multihomed environment In ColdFusion 5, the cfform tag used inline JavaScript code for validation. In ColdFusion MX, cfform includes the CFIDE/scripts/cfform. js file, which contains all JavaScript. However, if your application runs in a hosted environment with multiple virtual websites, your virtual website may not contain a CFIDE directory, which causes JavaScript errors when using cfform. If you encounter this problem, use one of the following solutions: · Use the Default CFFORM ScriptSrc Directory field on the ColdFusion MX Administrator to specify the default path (relative to the web root) of the directory containing the cfform. js file. · Ask your hosting provider to provide a copy of cfform. js and change your cfform tags to use the scriptsrc attribute, specifying the location of this file. · Ask , your hosting provide to modify your virtual website to include a virtual mapping for the CFIDE directory. Moving to IBM WebSphere IBM WebSphere does not use web server virtual mappings to locate CFM pages. If you are migrating a ColdFusion 5 application to ColdFusion MX running on WebSphere using the J2EE configuration and your application stores CFM pages in directories that use virtual mappings, you must reconfigure your application and move these pages to a nonvirtual directory. For more information, see the WebSphere pages on www. macromedia. com/go/cfmxj2ee-cert. The application. cfc file The updated application framework in ColdFusion MX 7 lets you use a file named Application. cfc to control your application and keep track of application events. You use Application. cfc instead of Application. cfm. Application. cfc methods are triggered when application, sessions, and requests start or stop, and when the application encounters an exception. If your application already uses a file named Application. cfc, you must rename it. 20 Chapter 1: Migrating Applications from ColdFusion 5 Tag and function examples This section provides remedies for some of the compatibility issues listed in Chapter 3, "Tag and Function Changes. " Using cfregistry in ColdFusion MX The cfregistry tag is deprecated for UNIX and Linux platforms. Therefore, you must remove it on UNIX to avoid compatibility problems when migrating to a later version of ColdFusion MX. As an alternative, you can store variables in the following scopes: · · · · · Client Text file Encoded text file Database LDAP server In Windows, you can continue to store client variables in the registry as in ColdFusion 5. [. . . ] ColdFusion MX and ColdFusion 5 accept a basic value, such as a string, number, logical value, or date and time value. IsXML IsXmlAttribute IsXmlDoc IsXmlElem IsXmlNode IsXmlRoot Len All All All All All All Change ColdFusion MX 7 ColdFusion MX 7 ColdFusion MX ColdFusion MX ColdFusion MX 7 ColdFusion MX ColdFusion MX When calculating a length, a string-processing function processes an ASCII 0 (NUL) character and continues to process subsequent characters of the string, if any. In ColdFusion 5, these functions did not process any subsequent characters of the string after processing the ASCII 0 (NUL) character. This function no longer changes the first delimiter in the list to the first delimiter specified in the function. In a descending sort with textnocase, ListSort returns ListSetAt Change ColdFusion MX ListSort Change ColdFusion MX elements in a different order than in ColdFusion 5. 54 Chapter 3: Tag and Function Changes Function Parameter, value, or change Changes Added in this ColdFusion release ColdFusion MX Comment LSCurrencyFormat This function returns a negative number when passed a negative number. [. . . ]