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 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. 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. However, you should not use cfregistry to read ColdFusion settings from the registry, such as the mail root and information about Verity collections and scheduled tasks, because much of this information is no longer stored in the registry, or it is in a different location in the registry. The ColdFusion settings that are stored in the registry are subject to change. Therefore, you should not rely on registry keys that ColdFusion creates to store its system settings. Using ListSort in ColdFusion MX When sorting with textnocase in a descending order, ColdFusion 5 and ColdFusion MX return the results in a different order. However, both are correct because in a textnocase sort, "apple" is equal to "APPLE". [. . . ] ColdFusion MX calculates negative differences correctly, so if your application contains code that adjusts the ColdFusion 5 results, you might need to change it. The w (weekdays) datepart option returns the same value as the ww (weeks) datepart option. DatePart L key of datepart ColdFusion MX 6. 1 parameter Decrypt algorithm and encoding ColdFusion MX 7 parameters DeleteClientVariable Change ColdFusion MX This function returns False when the variable does not exist. ColdFusion 5 ignores the function call. Encrypt algorithm and encoding ColdFusion MX 7 parameters GenerateSecretKey GetBaseTagList All Change ColdFusion MX 7 ColdFusion MX This function returns prefixed custom tags found in the tag stack in the format x:tag, where x is the prefix that you specified. GetGatewayHelper GetAuthUser All All ColdFusion MX 7 ColdFusion MX 52 Chapter 3: Tag and Function Changes Function Parameter, value, or change All All Change Added in this ColdFusion release ColdFusion MX 7 ColdFusion MX ColdFusion MX Comment GetContextRoot GetEncoding GetLocale When the locale has not been explicitly set using SetLocale, GetLocale returns the default locale of the client computer's operating system. In ColdFusion 5, GetLocale returns English (US) when the locale has not been explicitly set. GetLocaleDisplayName GetMetaData GetPageContext GetProfileSections GetSOAPRequest GetSOAPRequestHeader GetSOAPResponse GetSOAPResponseHeader GetTempDirectory All All All All All All All All Change ColdFusion MX 7 ColdFusion MX ColdFusion MX ColdFusion MX ColdFusion MX 7 ColdFusion MX 7 ColdFusion MX 7 ColdFusion MX 7 ColdFusion MX (Windows) This function returns the temporary directory for the embedded Java application server, instead of the temporary directory for the Windows operating system, as in ColdFusion 5. Hash algorithm and ColdFusion MX 7 encoding parameters IsArray Change ColdFusion MX This function returns True with a QueryColumn argument. [. . . ]