HomeSite / ColdFusion Studio and this SDK
If you use ColdFusion Studio 4.0 or HomeSite 4.0 for web development, this SDK offers a few convenient "goodies" for working with WDDX. Of course, if you don't use HomeSite or Studio, you can still use everything else in the SDK. Just view the SDK in your web browser.
The WDDX-specific tools provided for HomeSite/Studio are:
· The ability to view the SDK in the integrated help system
(click
picture for full-size screenshot)
Viewing the SDK in the Integrated Help
If you use ColdFusion Studio 4.0 or HomeSite 4.0 for web development, you can view this SDK in the editor's integrated Help system (screenshot).
Just unpack the SDK .zip archive into Studio/HomeSite's Help directory, then click the Help icon in the Resource Tab. A new "book" labeled Wddx SDK will appear. (You may have to hit F5 once to refresh the display.)
To install the WDDX Toolbar:
· If you're using HomeSite/Studio 4.01 (Beta 4 or later), just unzip the WddxToolbar401.zip file into your UserData\Toolbars folder. Doing so should create a new subfolder called WDDXToolbar. Now restart HomeSite/Studio and the toolbar should appear.
· If you're using version 4.0 of HomeSite/Studio, do the same as above except use the WddxToolbar40.zip file. Then you may need to edit the WDDX.tbr file (which you just placed in your Toolbars folder) so that it contains the right paths. It will only be correct "out of the box" if you're using Studio in the default install location. If you're using HomeSite or if you installed to your d:\ drive instead of c:\ or something like that, edit the file accordingly.
The WDDX Toolbar currently includes the following four buttons:
CFWDDX - invokes the CFWDDX Tag Editor.
WDDX Scripts - Inserts a <script> tag
pointing to one of the WDDX JavaScript files (wddx.js, wddxDes.js, or
wddxRsEx.js) into your document.
SCRIPT - invokes the regular SCRIPT
Tag Editor.
Add to Expression Builder - Adds the
properties/methods of the WDDX Objects for JavaScript and COM/ActiveX to the
Expression Builder.
Additions to the Expression Builder
When you click the button in the WDDX Toolbar, all of the
properties/methods of the WDDX Objects for JavaScript (WddxRecordset,
WddxSerializer, and WddxDeserializer), as well as the component classes
provided by the wddx_com object (WDDX.Stuct, WDDX.JSConverter, and so on) are
all added to the Expression Builder.
This makes it easier to work with these objects because you don't have to remember the exact syntax, order of the parameters, etc. Enjoy!