background image

MoniPlus2 Voice Guidance Configuration Guide

 

April 29, 2014 

 

 

 

 

 

 

 

1.4  Required MoniPlus2 Software Version  

Your ATMs must be running MoniPlus2 

version 02.03.07.xx

 or higher to support Voice Guidance as 

explained in this document. Use the 

Version Info 

function in Supervisor to verify the version of software 

running on the ATMs. The application version will be the first entry displayed in the versions list and will 
be listed on the screen as shown below: 

AP : V 02.03.xx.xx 

 

The application version number is also listed on the ATM Status window as shown in the circled area on 
the sample screen below.  

 

 

 

1.5  Required Tools 

Although not required, an XML editor will make creating your VG file easier.  

 

 

 

Summary of Contents for MoniPlus2

Page 1: ...MoniPlus2 Release 02 03 xx Voice Guidance Configuration Guide Ver 2 0 2014 Nautilus Hyosung Inc All Rights Reserved...

Page 2: ...he policy of Nautilus Hyosung Corporation to improve products as new technology components software and firmware become available Therefore Nautilus Hyosung reserves the right to change specifications...

Page 3: ...n Screens VG Support 4 3 VG Transaction Processing 5 3 1 Transaction Request Messages 5 3 2 Transaction Reply Messages 5 3 3 Interactive Transaction Response Messages 5 4 Creating the VG XML File 6 4...

Page 4: ...2 1 Load VG XML File Message with Identifier V 29 6 2 2 Terminal Response to the Load XML File Message 30 7 Terminal Status Messages 31 7 1 Specific Command Reject Message 31 A MoniPlus2 VG XML File...

Page 5: ...ost the VG XML file to an ATM Section 7 Terminal Status Message includes the VG related status messages that the ATM can send to the host Appendix A MoniPlus2 VG XML File Elements Quick Reference cont...

Page 6: ...function in Supervisor to verify the version of software running on the ATMs The application version will be the first entry displayed in the versions list and will be listed on the screen as shown b...

Page 7: ...selected his session options he is instructed to insert his card to begin a transaction Each screen displayed to the customer should have an audio instruction associated with it to guide the customer...

Page 8: ...s needing an extended timer value A parameter in the VG XML file can be included that will add additional time to these particular timers See the Config Element on page 7 for more information this tim...

Page 9: ...ost Refer to the LangOption Element on page 8 for more information on this option Verify that your host application can support the option you select before you implement either addition to the transa...

Page 10: ...d as is on MoniPlus2 ATMs and any NCR VG features not supported by MoniPlus2 will simply be ignored No schema file is currently associated with the MoniPlus2 VG XML file so as long as the file is vali...

Page 11: ...upID String This attribute can be used by the host to identify different Config elements for different downloads It is ignored by the MoniPlus2 application timersAdjust Numeric seconds Adds the define...

Page 12: ...LangOption element 4 4 2 LangOption Element Each language offered must have an LangOption element Three attributes are currently supported for this element 4 4 2 1 LangOption Attributes Tag Values De...

Page 13: ...ssage You will need to use the decimal equivalent for characters that have a predefined use in XML files For example to include a character at the end of the NDC message you would need to include 60 i...

Page 14: ...the audioID for the screen associated with this option Detailed information about this added link is included in the Adding the Dynamically Built Device Orientation Scripts section on page 12 screen...

Page 15: ...press 1 on the keypad to hear ads Yes and 2 on the keypad to skip ads No AudioID YestoAds will play when the customer presses 1 and audioID NotoAds will play when the customer presses 2 The default be...

Page 16: ...od you typically use to distribute the file A new device orientation list is only generated when the VG XML file is reloaded onto the ATM so if you do not reload the file when the devices change the c...

Page 17: ...Reader groupID 0000 Link audioID NHORIENTATIONLINKCashDispenser groupID 0000 Link audioID NHORIENTATIONLINKReceiptPrinter groupID 0000 Link audioID NHORIENTATIONLINKCashAcceptor groupID 0000 Link audi...

Page 18: ...cific portion of the transaction groupID String This attribute can be used by the host to identify different keyboard elements for different downloads and is ignored by the MoniPlus2 application 4 6 K...

Page 19: ...mapping layout is for a screen that has all eight FDKs populated Keyboard keyboardID 120 groupID 0001 Key pos 1 code F6 maps FDK A to key 1 Key pos 2 code F5 maps FDK B to key 2 Key pos 3 code F4 maps...

Page 20: ...want to use has any extension other than wav you need to use the entire filename as the audioID For example if your wav file is called test wav1 you would call the corresponding audioID text wav1 inc...

Page 21: ...of the base screen or in the audioID of the nested screen depending upon which is voiced See Embedded Text Elements in the next section for more information on the Placeholder tag The dynamic data to...

Page 22: ...ed screen with placeholder tags both screens 100 and 200 will be displayed but only audioID 0100 will be spoken The audio of the nested screen contains the placeholder tag and the ParamSourceID refere...

Page 23: ...Text Elements Within the text that you define for the audio you can embed the following elements Tag Description Link Allows the nesting of an audioID within the text of an audio message The Link ele...

Page 24: ...for a short pause in the speech Placeholder Specifies that dynamic data that should be voiced in this location within the audio message Multiple placeholders can be specified in the audio message and...

Page 25: ...1 Text Audio Audio audioID 0105 groupID 0001 keyboardID 110 repetitions 0 Text lang en These audio messages allow a visually impaired person to use an A T M You use the numeric keypad to make selectio...

Page 26: ...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...

Page 27: ...CE EXAMPLE lf UPDATE WITH TWO lf PLACEHOLDERS audioID 0345 should be formatted with two placeholders as shown below Audio audioID 0345 Text lang en Thank you for banking with us Your PlaceHolder accou...

Page 28: ...ceHolder tag in the audio message and the balance amount 128 45 dollars will populate the second PlaceHolder tag Printer Flag w VG Sample This sample shows the use of printer flag w and dynamic data i...

Page 29: ...e Printer Flag VG Sample This sample shows the use of two audioIDs and two data fields to be directly voiced The first audioID Current wav will voice the text in the Current audioID in the XML file 4...

Page 30: ...extend the ITR Screen Timer field value for VG transactions The text to be voiced cannot include audioIDs nor can it include any screen control characters This means that the same messages cannot be...

Page 31: ...any FDKs are defined as active in the Active Keys field the FDKs will be mapped to the numeric keypad as follows FDK Numeric Key A 1 B 2 C 3 D 4 F 8 G 7 H 6 I 5 When the FDKs are mapped to the numeri...

Page 32: ...e numeric keys along with the Enter Clear and Cancel keys will be active on the keypad 3 fs fs fs 201100010000 fs 040 fs so 125 si EC1 SAVINGS 1 si GC2 SAVINGS 2 si IA When the ITR is processed at the...

Page 33: ...work Host A reboot is required after you copy this file onto the ATM 6 2 Downloading the VG XML File to the ATM The host can use the Configuration Data Load Command Load VG XML File message with Ident...

Page 34: ...Identifier V Fixed to V for VG XML configuration load 11 Field Separator Mandatory FS 12 Audio Guidance XML Data This field contains variable length sections of the AudioGuidanceData xml file 13 Field...

Page 35: ...ilable on this ATM when a customer inserts a head jack Note If the terminal receives a Go In Service message before it receives the final XML message all newly downloaded XML file messages will be del...

Page 36: ...Status Descriptor C This field is fixed to C for a Specific Command Reject 11 Field Separator Mandatory FS 12 1 Status Value This field contains the reason for rejecting the command A Message format...

Page 37: ...screen Screen that displays to allow language selection or its substitute opCodePos Opcode position to be populated for a VG session LangOption Language and key parameter pairs that allow a customer...

Page 38: ...generate when the key is pressed Audio Defines the audio messages voiced to the customer ad Identifies an audio message as an advertisement audioID Identifier for the audio element groupID Used by the...

Page 39: ...ID 60 afaLang 1 to 4 questions for options the OrientationScript option must be included to use the dynamic device orientation afaOption name blankScreen screen 0211 yesKeyPos 1 yesAudioID blankYes no...

Page 40: ...oard ABC Keyboard keyboardID 105 Key pos 1 code F6 Key pos 2 code F5 Key pos 3 code F4 Keyboard AB Keyboard keyboardID 106 Key pos 1 code F6 Key pos 2 code F5 Keyboard A Keyboard keyboardID 107 Key po...

Page 41: ...titions 0 Text lang en Do you wish to blank the screen for privacy To blank the screen please press 1 To display screen please press 2 Text Text lang sp La sesi n de audio permite ocultar las pantalla...

Page 42: ...0000 groupID 0000 keyboardID 106 keyText true repetitions 0 Text lang en If you need more time please press 1 for yes press 2 for no Text Text lang sp Necesita mas tiempo para realizar la opercion Par...

Page 43: ...en Please wait Text Audio Audio audioID 0400 groupID 0000 repetitions 0 Text lang en THANK YOU FOR BANKING WITH us TAKE YOUR RECEIPT TRANSACTION COMPLETE Text Audio Audio audioID 0401 groupID 0000 rep...

Page 44: ...osotros SU TARJETA se ha mantenido transacci n completa Text Audio Audio audioID 1403 groupID 0000 repetitions 0 Text lang sp GRACIAS POR bancarias con nosotros Tomar sus notas Transacci n completa Te...

Page 45: ...t Audio Audio audioID 0300 C groupID 0000 Text lang en Cancel Text Audio Audio audioID 0808 groupID 0000 repetitions 0 Text lang en Please insert your deposit Link audioID NHORIENTATIONLINKCashandChec...

Page 46: ...as 16 keys arranged in four columns The three left hand columns of keys are arranged like a standard telephone keypad The fourth column contains four function keys Enter is the top key of this column...

Page 47: ...pt screen Audio audioID NHORIENTATIONLINKMAIN groupID 0000 Text lang en Link audioID NHORIENTATIONLINKIntroduction groupID 0000 Link audioID NHORIENTATIONLINKPinpad groupID 0000 Link audioID NHORIENTA...

Page 48: ...e Orientation 10 12 35 Direct Audio Text Method 26 Downloading the VG XML File to the ATM 29 dynamic data definition 22 E Element List 6 Elements Quick Reference 33 Embedded Text Elements 19 escape se...

Page 49: ...lay Update Field 20 22 screenOffset attribute 8 Software Version 2 Specific Command Reject Message 31 Start and End Tags 6 Supervisor 2 T Terminal Response to the Load XML File Message 30 Terminal Sta...

Reviews: