log element
log element
Writes a message to the debug log. When you use Tellme Studio to execute your VoiceXML applications, you can use the Debug Log Viewer to view these messages.
Syntax
<log
label = "string"
labelexpr = "ECMAScript_Expression"
/>
Attributes
label |
A string that may be used to categorize the log message. |
labelexpr |
An ECMAScript expression that evaluates to the string used to categorize the log message. This attribute is a Tellme extension. |
Parents
block, catch, error, filled, foreach, help, if, noinput, nomatch, prompt
Children
Remarks
The label and labelexpr attributes are mutually exclusive.
To write to the Log within a script element, use the vxmllog function. The vxmllog function does not currently support the ability to specify a label.
A single log message is limited to 1000 characters. A longer message will be truncated.
Examples
The following example writes some simple text to the log.
<?xml version="1.0"?>
<vxml version="2.1"
xmlns="http://www.w3.org/2001/vxml">
<form>
<block>
<log>Hello, world.</log>
</block>
</form>
</vxml>
The following example writes the contents of a variable to the log.
<?xml version="1.0"?>
<vxml version="2.1"
xmlns="http://www.w3.org/2001/vxml">
<form>
<var name="uid" expr="12345"/>
<block>
<log><value expr="uid"/></log>
</block>
</form>
</vxml>
The following example writes simple text and the contents of a variable to the log.
<?xml version="1.0"?>
<vxml version="2.1"
xmlns="http://www.w3.org/2001/vxml">
<form>
<var name="uid" expr="12345"/>
<block>
<log>uid is <value expr="uid"/></log>
</block>
</form>
</vxml>