Definition of Whitebeam XML Tags |
|
Remarks
The Presentation Engine includes a number of facilities to help integration partners debug their applications. One of these is the provision of a debug output method - rb.debug.write(). Normally this method stores up debug strings and only outputs them if there is an error detected when the page is executed. There are scenarios where a page does not create any errors - just produces 'unexpected results'. In these situations it can be useful to dump the contents of working values while the page is being generated. The <rb:insertdebug/> tag does just this. It replaces itself with the accumulated set of debug output generated by calls to rb.debug.write(). Although
the tag replaces itself with accumulated output - that output is NOT discarded.
Instead subsequent calls to <rb:insertdebug/> will duplicate the entire
output. The most common way to use this is to place the <rb:insertdebug/>
tag at the end of the page.
Example:
This example will build the correct HTML table and then will output the contents of the accumulated debug information.
By default the presentation engine only collects debug output if the page is running
on the test site. In the operational site all calls to rb.debug.write are ignored.
There are however situations where there are problems that may only occur in
the operational site. In this case the collection of debug output in the operations
site can be enabled by calling
rb.debug.mode(true).
|