RvGet
Returns value of the specified Result Variable.
Syntax
sValue = object.RvGet(iLineId, sRv)
| Part | Description |
| object | VoiceGuide object |
| iLineId | Identification number of the line |
| sRv | Result Variable who's value is to be returned. The leading dollar sign can be omitted. eg. in case of
$RV[GetCardDetails] just the RV[GetCardDetails]
can be specified, and in case of a system RV like $RV_CALLLENGTH
just the RV_CALLLENGTH can be specified. Omitting the dollar sign is necessary if RvGet() is used from within VoiceGuide, as any fully specified RVs will be replaced with their value before the script is ran. |
| sValue | Value of the specified Result Variable. If this Result Variable is not currently defined on the line then an empty string is returned. |
Notes
Result Variables are reset at the beginning of a new call. Hence they are available for querying after the call has finished, but before a new call has begun on the same line.
RvGet() should only really be used from VoiceGuide's VB Script if that VB script polls for a value of a particular Result Variable in a loop. If the value of the Result Variable is not expected to change during the running of the script then the actual Result Variable should be used directly in the script, without the need of a RvGet function.
Example 1
Running from an external application.
set vg =
CreateObject("vgServices.CommandLink")
'see how long the call on line who's LineID is 6 has been going on for:
sReturnValue = vg.RvGet(6, "$RV_CALLLENGTH")
set vg = Nothing
MsgBox sReturnValue
Example 2
Running from an external application.
set vg =
CreateObject("vgServices.CommandLink")
'get the RV [GetCardDetails] defined on LineID 6:
sReturnValue = vg.RvGet(6, "$RV[GetCardDetails]")
set vg = Nothing
MsgBox sReturnValue
Example 3
Running from VoiceGuide's VB Script module. Note that the $ has been omitted in the $RV, as if it is included then the $RV will be replaced with value of $RV[GetCardDetails] on the current line, before the VBScript is ran.
Example below will read $RV_CALLLENGTH from a call on another line:
set vg = CreateObject("vgServices.CommandLink")
sReturnValue = vg.RvGet($RV[SecondLineId], "RV_CALLLENGTH")
vg.Run_ResultReturn $RV_LINEID, "[OtherLineCallLength]{" & sReturnValue & "}"
set vg = Nothing
Example 4
Running from VoiceGuide's VB Script module. Note that the $ has been omitted in the $RV, as if it is included then the $RV will be replaced with value of $RV[GetCardDetails] on the current line, before the VBScript is ran.
Example below will read $RV[GetCardDetails] from a call on another line:
set vg = CreateObject("vgServices.CommandLink")
sReturnValue = vg.RvGet($RV[SecondLineId] "RV[GetCardDetails]")
vg.Run_ResultReturn $RV_LINEID, "[OtherLineCardDetails]{" & sReturnValue & "}"
set vg = Nothing
