Introduction
Author: Bradley Wagner
As server-side scripting technologies such as JSP, ASP, .NET, etc. become more prevalent, there is in increased demand for Cascade Server to support embedding of these types of code into published files or pages.
The problem is that much of this code would not pass through an XML validator. For example, the JSP tags <% and %> used to evaluate a JSP scriptlet are not valid XML and so could not be directly embedded in an XML/XHTML Block, Template, or Page within the system.
The solution is to embed this code inside specialized XML comments that go through some string processing during the rewrite phase of file and page rendering. These blocks of XML comments will be called " Code Sections." Currently, there are two types of code sections supported in the application: Passthrough Code Sections, and Root Code Sections.
These code sections could be included in any type of asset that eventually makes it into a file or page because pages and files are the only publishable assets in the system. This means that they could be embedded in a block, template, stylesheet, the default region of a page, or in the text of file.
Additional Notes
In order to hide this code from business users, it is generally best to embed this code at the template level or in an included block.