MoniPlus2 Voice Guidance Configuration Guide
April 29, 2014
22
5 Sending VG Data in Authorization Messages
The host can include VG data in the transaction reply and interactive transaction response messages. The
data in these messages can simply instruct the ATM to speak one or more audioIDs, or these messages
can include dynamic data to be spoken with an audioID.
5.1 VG Data in Transaction Reply Messages
The host can use the following fields in the transaction reply message for VG data:
•
Screen Display Update field – can be used for dynamic data only
•
Any printer data fields using printer flag
w
or
>
– can be used to voice audioIDs or to voice dynamic
data with an audioID
An audioID that should be populated with dynamic data must include a placeholder tag, <PlaceHolder/>,
for each place the dynamic data should be inserted and voiced. Multiple placeholder tags may be included
in an audioID when needed, which would be populated by multiple VG data entries in the transaction
reply message.
5.1.1 Using the Screen Display Update Field
The Screen Display Update field is only used to send dynamic data to be voiced; it cannot be used to
cause an audioID to be voiced. Dynamic data is any data that is not predefined within the ATM screen
flow that needs to be displayed to the customer and, therefore, voiced for voice guidance. The dynamic
data in the transaction reply message must be identified by the escape sequence
[ESC]P0000;1;
placeholderdata
[ESC]\. Multiple ;
placeholderdata
entries must be included if the related
audio message contains multiple <PlaceHolder/> tags to be populated. There is a one-to-one relationship
between the ;
placeholderdata
entries in the Screen Display Update field and the <PlaceHolder/> tags in
the audio message, meaning the first ;
placeholderdata
entry will populate the first <PlaceHolder/> tag,
the second ;
placeholderdata
entry will populate the second <PlaceHolder/> tag, etc. Any <PlaceHolder/>
tags that do not have corresponding ;
placeholderdata
entries in the Screen Display Update field will be
ignored.
The escape sequence used in the Screen Display Update field for dynamic data is explained in the
following table.
Character
Number
of Bytes
Description
ECS P
2
ESC control sequence introducer
0
1
Control string ID
Variable
Var (2-3)
Audio message number in the range 00 to 999. This number is ignored but
must be present. The screen number in the message will be used as the
indicator of the audioID message to voice.
;
1
Semicolon used as a separator
Parameter
Flag
1
Range: 1-9. This flag is ignored but must be present. This value does not
have to the match the number of parameters included.
;
1
Semicolon used as a separator
