VoiceXML 2.1 Development Guide

<voxeo:logcontrol> element

Allows you to control logging, for example turning off logging temporarily when you collect a credit card number. Please remember that you want to use this sparingly, as disabling logging does limit Voxeo Supports ability to troubleshoot any application issues.

usage

<voxeo:logcontrol mode="(string)">

attributes

mode	Data Type: (string)	Default: Optional
	The mode attribute specifies the mode of the voxeo:logcontrol element. Acceptable values are either enable, disable, or sensitive. When the mode attribute is set to: enable - VoiceXML logging is not limited. This is the default setting, or when the property is not set. disable - VoiceXML logging is disabled on the MRCP server. In addition, the VSP `behavior.calllog.ConfidentialUtterance=true` is sent for every `set param` MRCP message before a recognize MRCP message is sent to Nuance. sensitive - VoiceXML logging is limited and ALL sensitive data is masked. In addition, the VSP `behavior.calllog.ConfidentialUtterance=true` is sent for every `set param` MRCP message before a recognize MRCP message is sent to Nuance.

shadow variables

none

parents

<block>

children

none

code samples

Example showing how to hide your lucky number from logging, as well as from prying eyes =)

<?xml version="1.0" encoding="UTF-8"?>
<vxml version="2.1" xmlns="http://www.w3.org/2001/vxml"
xmlns:voxeo="http://community.voxeo.com/xmlns/vxml">
<form>
<block>
<voxeo:logcontrol mode="disable"/>
</block>
<field name="luckyNumber" type="digits">

<prompt>
Please say your lucky number.
</prompt>
</field>

<filled>

<prompt>
You said <value expr="luckyNumber"/>
</prompt>
</filled>
</form>
</vxml>

additional links

none

ANNOTATIONS: EXISTING POSTS

moshe

12/16/2010 1:32 PM (EST)

The documentation says "enabled" and "disabled," the code sample says "enable" (without the final "d").

In my code "disable" works, but I'm not certain if "enable" works, and I'm about to test "enabled."

voxeoTonyT

12/16/2010 6:48 PM (EST)

Hello,

You are absolutely correct, that documentation contains incorrect information. The acceptable values should be "enable or disable", the present tense. I will have our documentation folks correct this. If you would like to be notified of when this gets corrected let us know.

Regards,

Tony Taveras
Customer Engineer
Voxeo Support

Voxeo.Van

12/17/2010 9:32 AM (EST)

Hi Moshe,

I wanted to thank you for taking the time to bring this issue up with our Support team. We value customer feedback very highly.

I've updated the VoiceXML documentation and published it today at

http://www.vxml.org/frame.jsp?page=voxeo-logcontrol.htm

If you feel the problem is solved, we would appreciate if you would close the ticket, otherwise, feel free to contact us for any other questions.

Van Vanslette
Technical Writer
Voxeo Support

interactionsrgenter

4/21/2011 11:01 AM (EDT)

I'd like to see some more details about this feature:

1) In the example, is logging only disabled for the form, or is it disabled until a subsequent call to <voxeo:logcontrol mode="enable"/>?

2) Is it possible to disable logging for just the sensitive part of the prompt? For example, could I do the following:

<filled>
<prompt>
You said
</prompt>
<block>
<voxeo:logcontrol mode="disable"/>
</block>
<prompt>
<value expr="luckyNumber"/>
</prompt>
<block>
<voxeo:logcontrol mode="enable"/>
<block>
<prompt>
That's a very lucky number!
</prompt>
</filled>

Voxeo.Van

8/18/2011 12:49 PM (EDT)

Regarding your two questions:

1) Yes the script written does disable logs through the rest of the application run. This is assuming you do not re-enable the logcontrol later in the application. This leads to the second question:

2) Yes it is possible to turn the logcontrol off during a given period and then it is completely possible to re-enable it later in your application. The premise for your code will therefore fully work.

If there are any other questions that you may have please let us know.

Regards,
Van Vanslette
Support Team
Technical Writer