The getvox function retrieves a single value from the EDU's name/value pair stored in the VOX Server's value cache.
Because getvox retrieves the information from the VOX Server's value cache rather than from the EDU Server, it results in faster response time and less network traffic than using getvdu.
Use getvox only when you are certain that the cache holds the field's most recent value. This will always be the case if only the CONVERSANT or Avaya IR application can cause the EDU's value to change. For example, if a field can be set only by the tr2setaccnt function and not by any other Avaya Computer Telephony software, both the VOX Server cache and the EDU will contain the same field values.
getvox is best suited for accessing stable information such as account numbers and ANI (Automatic Number Identification). For information about getvox and the value cache, see the VOX Server Programmer's Guide.
Note:
Always issue the getvdu function instead of getvox if there is any risk of other software running in parallel with your CONVERSANT or Avaya IR application; otherwise, pertinent EDU values may differ.
Use the Node Inspector to assign and edit the following attributes.
Attribute |
Value |
Description |
Put Return Code In |
|
Select the variable in which to store the return code. |
VESP Function Name |
getvox |
Gets a value from the VOX Server value cache. |
Arg 1 |
|
Select the variable in which to store the EDUID, which is passed to Avaya Computer Telephony to identify the call. The variable must have Length set to 34 and Type set to character. |
Arg 2 |
|
Select the variable that contains the name of the database field to query. The variable must have Length set to 256 and Type set to character. |
Arg 3 |
|
Select the variable in which to store the returned value of the database field; empty if the field does not exist. The variable must have Length set to 256 and Type set to character. |
Arg 4 |
|
Select a Dummy variable. The variable must have Length set to 256 and Type set to character. |