debug action can be used to insert additional information into the debug output of FIT if debugging is enabled.
debug action has the following attributes:
channel="user|request|foo|bar..." defines the channel used for the message. Defaults to
level="verbose|debug|info|warning|error|..." defines the log level of the message. Defaults to
xpath="..." defines the subject to be dumped to the message text.
Refer to the debugging documentation for information on how to enable and select debug output, and which levels are valid.
debug action dumps the current internal representation of the subject (usually XML in UTF-8 encoding). This may differ from both the content received from the source as well as the final result sent to the client. The output of the
debug action will always be converted to UTF-8 encoding.
<debug level="error" channel="bar" xpath="string('Error')" if="contains(request/url, '/error')"/><debug level="info" channel="dc" in="fit://request/dc" />
<!-- Sometimes the XML declaration line will be added to the output, e.g.: --><?xml version="1.0" encoding="iso-8859-1"?><!-- There is an output difference between the XML and HTML on empty elements: --><div class="myDiv"/><!-- instead of --><div class="myDiv"></div>
Note that there is a difference between the following two examples. If the main URL
http://www.example.com/ is given:
<debug xpath="fit-document('fit://request/content/main/response')/response/@url" /><!-- Output is: url="http://www.example.com/" --><debug xpath="string(fit-document('fit://request/content/main/response')/response/@url)" /><!-- Output is: http://www.example.com/ -->
The debug action will terminate the flow with an error message if not exactly one of the attributes
in is given, if the XPath is invalid or cannot be evaluated, or if the
in attribute does not provide a valid URL.