leg collectdigits consumedigit behaviour

Version 1
    This document was generated from CDN thread

    Created by: Yuriy Shafirin on 26-03-2010 10:58:20 AM
    Hi All,
     
    In command reference it is writen about consumeDigits parameter:
    ===
    param (consumeDigit)¿ Allows the application to prevent the digits dialed by the user from
    being relayed to a remote end point after the incoming and outgoing call legs are bridged.
    ===
    So I guess the default behaviour is to relay dialed digits to a remote end.
     
    Who knows how it works?
     
    Thanks.
     
    Yuriy.

    Subject: RE: leg collectdigits consumedigit behaviour
    Replied by: Vijay Prasad Neelamegam on 26-03-2010 11:24:57 AM
    Hi Yuriy,
     
    If param(consumeDigit) is true,it wont send the collected digits to TGW,we need to send using legsend API.
    Yes,the default behaviour of leg collectdigits is to send collected digits to TGW.
     
    Thanks
    Vijay
     
     

    Subject: RE: leg collectdigits consumedigit behaviour
    Replied by: Yuriy Shafirin on 01-04-2010 11:29:45 AM
    Hi Vijay,
     
    So how it works in details?
     
    Let's say I've got a call which triggered the application. I've sent setupack to incoming leg and collected some digits. Then ev_collectdigits_done event fired. What should be next to relay digits?
     
    Yuriy.

    Subject: RE: leg collectdigits consumedigit behaviour
    Replied by: Yuriy Shafirin on 01-04-2010 01:10:34 PM
    Hi Anusha,
     
    Yes, I understand how to collect digits to variable and how to setup call using this variable.
     
    I wanted to know what does it mean "relay after the incoming and outgoing call legs are bridged". See consumeDigit param description -
    ===
    param (consumeDigit)¿ Allows the application to prevent the digits dialed by the user from
    being relayed to a remote end point after the incoming and outgoing call legs are bridged.
    ===
     
    Thanks,
    Yuriy.

    Subject: RE: leg collectdigits consumedigit behaviour
    Replied by: Anusha Kannappan on 01-04-2010 12:56:17 PM
    Hi Yuriy,
     
    You can write a procedure say act_gotdest(), where you can check for the status of the digit collection and then collect the digit in any variable and use the leg setup to relay the digits.
     
    Thanks,
    Anusha

    Subject: RE: leg collectdigits consumedigit behaviour
    Replied by: Anusha Kannappan on 01-04-2010 01:40:57 PM
    Hi Yuriy,
     
    Yeah using the consumeDigit parameter prevents digit relay to a remote end point. The TCL application will be receiving an ev_digit_end event for every dialed digit. None of these digits will be relayed to the other call leg.
    Few more things to be noted while using the parameter consumeDigit
    \
    The consumeDigit parameter can be set to true or false (default).
    ¿Setting the consumeDigit parameter to true or false does not affect digit collection when the call leg is not bridged.
    ¿Setting the consumeDigit parameter to true does not prevent dialed digits from being passed to a remote end point if the negotiated DTMF relay is rtp-nte, cisco-rtp, or in-band voice.
     
    Thanks,
    Anusha

    Subject: RE: leg collectdigits consumedigit behaviour
    Replied by: Yuriy Shafirin on 01-04-2010 02:45:34 PM
    Yeah, that is good. But I still can't see the explanation when and how this relay can occur.