XSLT Parameter Usage

ColdFusion MX 7 introduced the ability to include parameters to the transform. Parameters allow you to pass in values to be rendered by the XSLT that are not included in the original XML. Following is an example of how an external parameter might be used with the following XML and XSLT:

Injecting a Parameter

According to the documentation at the Adobe Knowledge Base, parameters are "a structure containing XSL template parameter name-value pairs to use in transforming the document. The XSL transform defined in the xslString parameter uses these parameter values in processing the XML."

Usually when I create structures in ColdFusion, I use the familiar dot shorthand notation:

Using this method, my code would consistently fail to pass in any of the parameters. Careful reading of the ColdFusion 7 comments for the XmlTransform function reveals to us that we must use associative array notation for parameters to work properly. It's as easy as switching the assignation of keys in the structure from dot notation above, to the associative array notation below:

Structure Notation Reasoning

Why is this the case? Why should it make a difference? Quite likely, as the commentor noted in the documentation, it is due to the syntax of ColdFusion. XML and XSLT allows for the "-" character to be included in variable names. Instead of baseWebUrl, I could have named the parameter base-web-url. Using ColdFusion and dot object notation would have resulted in <cfset parameters.base-web-url = application.webBase />, which obviously would result in an attempted mathematically equation and a ColdFusion error.

So, just remember, don't use dot notation! Use associative array notation, or if you wish, the StructInsert() function to add your structure keys.

I hope this saves you at least half of the hair-tearing-out that I endured.

if str has zero characters, len(str) will return 0, mimicking behaviour of false. Cool!

The CDSource inspired ColdFusion site is for the ColdFusion course I am taking. Feel free to play around with it, but the cart isn't working yet so don't do that.

The admin section has no policing yet, so you can check that out too. Go ahead and add products.

I had fun writing the CSS for it. I am not a designer, but I like bringing design to reality. This was one of the cleanest stylesheet that I have written, although it was not difficult considering that there really isn't that much to style.

I'm slowing getting into this JavaScript filled Web2.0 world before me. I avoided JavaScript like the plague before. Now it's fun to make little things dynamic, such as the field on the product-type change to CD. So so very simple, but it makes me inexplicably giddy.

Congratulations, Josh! Wahoo!