1. Manuals
  2. Brands
  3. Nautilus Hyosung Manuals
  4. Cash Counter
  5. MoniPlus2
  6. Configuration manual

Nautilus Hyosung MoniPlus2 Configuration Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
MoniPlus2 Release 02.03.xx
Voice Guidance Configuration Guide
Ver. 2.0
© 2014 Nautilus Hyosung, Inc. All Rights Reserved.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the MoniPlus2 and is the answer not in the manual?

Questions and answers

Related Manuals for Nautilus Hyosung MoniPlus2

Summary of Contents for Nautilus Hyosung MoniPlus2

  • Page 1 MoniPlus2 Release 02.03.xx Voice Guidance Configuration Guide Ver. 2.0 © 2014 Nautilus Hyosung, Inc. All Rights Reserved.
  • Page 2 All information described in this manual is a licensed product of Nautilus Hyosung Corporation. It is the 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 without notice.

  • Page 3: Table Of Contents

    Introduction ............................1 What’s New ..........................1 Audience ............................1 Additional References ........................1 Required MoniPlus2 Software Version ..................2 Required Tools ..........................2 Overview of a Voice Guidance Session ....................3 Multiple Language Support ......................3 Keyboard Mapping ........................3 VG Volume Controls ........................
  • Page 4 Terminal Response to the Load XML File Message............30 Terminal Status Messages........................31 Specific Command Reject Message .................... 31 MoniPlus2 VG XML File Elements Quick Reference ............... 33 Sample MoniPlus2 VG XML File ...................... 35 Index ..............................44 Revision History...

  • Page 5: Introduction

    Appendix A, MoniPlus2 VG XML File Elements Quick Reference, contains a list and short description of the elements and attributes used in a MoniPlus2 VG XML file. Appendix B, Sample MoniPlus2 VG XML File, contains a sample VG XML file that includes the most commonly used elements.

  • Page 6: Required Moniplus2 Software Version

    MoniPlus2 Voice Guidance Configuration Guide 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.

  • Page 7: Overview Of A Voice Guidance Session

    2.1 Multiple Language Support MoniPlus2 release 02.03.07.xx introduces support for multiple language voice guidance though the use of an add-on, third-party, text-to-speech engine. The currently supported speech engine is AT& T Natural Voice. You order this speech engine through your NH sales representative using NH Software Product ID 9929999911.

  • Page 8: Vg Volume Controls

    The VG volume cannot be adjusted on a 7100T only. For all other models, the volume can be adjusted as explained in this document. Keep these restrictions in mind if you are implementing MoniPlus2 VG on an ATM that has the hardware TTS engine.

  • Page 9: Vg Transaction Processing

    MoniPlus2 Voice Guidance Configuration Guide 3 VG Transaction Processing This section discusses any differences, or possible differences, that can be included in the messages between the ATM and the host for VG transactions. Use this information when planning how to implement VG for your host download.

  • Page 10: Creating The Vg Xml File

    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 valid XML, it will be used. However, a VG XML file written to this MoniPlus2 specification may not work on an APTRA Advance NDC because NCR validates the VG XML file against their schema file and not all elements required by NCR are used by MoniPlus2.

  • Page 11: Config> Element

    <afaOptions>. The NCR VG XML file can contain more child elements that are not currently used by MoniPlus2. If any of these non-supported <Config> child elements are included in the XML file, they will be ignored and no harm will be done.

  • Page 12: Afalang> Element

    The <afaLang> element is used to define the VG languages available and the keys to be used to select the individual languages. Prior the MoniPlus2 release 02.03.xx, this element was used only as a way to inform the host that the transaction request being sent is for a VG session.

  • Page 13: Afaoption> Element

    Yes/No selections. Be sure that you include these new screens in your ScreenLoad.dat file or the file will not play. If you want to include the MoniPlus2 dynamic device orientation information to your VG file, you must define the OrientationScript attribute and its associated screen and audio as explained below. If you do not include the OrientationScript attribute and its associated screen and audio, the dynamic device orientation information will not be added, regardless of whatever else you do to enable it.
  • Page 14 ATM. If this attribute is not present, no orientation script will play to the customer. If you want to include the MoniPlus2 dynamically built and inserted device orientation text, you MUST define this attribute. A link to the device orientation scripts is added to the audioID for the screen associated with this option.

  • Page 15: Config> Element Sample

    MoniPlus2 Voice Guidance Configuration Guide Values Description This default behavior will override the defaults listed in the name attribute section of this table. 4.4.4 <Config> Element Sample In this sample <Config> element, all times have been increased by 30 seconds. Screen 0011 will display when the customer elects to blank the screen and the audio associated with Screen 0028 will play to prompt the customer to insert his card to begin a transaction.

  • Page 16: Adding The Dynamically Built Device Orientation Scripts

    </Config> 4.4.5 Adding the Dynamically Built Device Orientation Scripts MoniPlus2 can automatically add descriptions of the locations of the devices on the ATM (device orientation) to your VG file. To add these descriptions: 1. You must include the OrientationScript attribute and associated screen and audio ID in the <afaOption>...
  • Page 17 </Text> </Audio> In addition to the device entries shown above, the MoniPlus2 application also adds a <Link> element into the <Text> element used for your OrientationScript audioID. This <Link> element ties your own OrientationScript audioID to the MoniPlus2 device orientation. The abbreviated sample below shows the addition of this automatically added <Link>...

  • Page 18: Keyboard> Element

    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 <Key> Element <Key> elements are used to define the code that a particular key should generate within specific <Keyboard>...

  • Page 19: Keyboard> Element Sample

    MoniPlus2 Voice Guidance Configuration Guide Values Description ASCII 2 ASCII 3 ASCII 4 ASCII 5 ASCII 6 ASCII 7 ASCII 8 ASCII 9 Enter Cancel FDK D FDK C FDK B FDK A FDK F FKD G FDK H FDK I Clear 4.6.2 <Keyboard>...

  • Page 20: Audio Attributes

    If an audioID cannot be found, nothing will be voiced. groupID String This attribute can be used by the host to identify different audio elements for different downloads and is ignored by the MoniPlus2 application. keyboardID 100-999 Reference to the Keyboard element that should be used with this screen;...
  • Page 21 MoniPlus2 Voice Guidance Configuration Guide Values Description Sample keyText usage: <Audio audioID="0128" keyboardID="120" keyText="true"><Text lang="en">This machine cannot currently print a receipt for your transaction. Do you want to continue? If yes, press 1. If no, press 2. </Text></Audio> <Audio audioID="0128-1”><Text lang="en"> Yes </Text></Audio>...
  • Page 22 MoniPlus2 Voice Guidance Configuration Guide Values Description </Audio> The audio for the nested screen is not spoken but must be defined. <Audio audioID="0200" groupID=”0001”> <Text lang="en"> This text will not be spoken. </Text> </Audio> Base screen 100 contains the reference to screen 200: 100<ff><si>ABYOUR BALANCE IS<si>CFDO YOU...

  • Page 23: Text> Element

    4.8 <Text> Element A <Text> element contains the actual text to be voiced by the text-to-speech engine. Only one attribute, lang, is currently supported. The inclusion of any other attributes will be ignored by MoniPlus2. 4.8.1 Text Attribute Values...

  • Page 24: Audio Element Samples

    The <Audio> element samples in this section explain to the customer, in both English and Spanish, what session options are available and how to set them. (Defaults are defined in the <afaOption> element.) Refer to the sample VG file in the Sample MoniPlus2 VG XML File section on page 35 for more <Audio> element examples.
  • Page 25 MoniPlus2 Voice Guidance Configuration Guide <Text lang="sp"> Para escuchar todos los mensajes de publicidad durante la sesión, presione 1. Para omitir todos los mensajes de publicidad, presione 2. </Text> </Audio> <Audio audioID="0103" groupID="0001" keyboardID="110" repetitions=“0”> <Text lang="en"> To skip the orientation, please press 1. To listen to the orientation, please press 2.</Text>...

  • Page 26: Sending Vg Data In Authorization Messages

    MoniPlus2 Voice Guidance Configuration Guide 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.

  • Page 27: Printer Data Fields

    MoniPlus2 Voice Guidance Configuration Guide Character Number Description of Bytes Variable Text to be spoken for the Placeholder. The ; and Variable can be repeated as needed to populate multiple placeholders that have been included within an audioID. The speech engine can recognize $ as meaning money and will voice any digits preceded by a $ as an amount.
  • Page 28 MoniPlus2 Voice Guidance Configuration Guide money. Additionally, numbers will be voiced differently depending upon the presentation of the numbers. For example, 1 2 3 will be voiced differently than 123. 5.1.2.1 Using Printer Flag w When using printer flag w, the printer flag can be followed by one audioID and one or more dynamic data fields to be voiced.
  • Page 29 MoniPlus2 Voice Guidance Configuration Guide You can include multiple > printer flags and printer data fields in a printer group in a transaction reply message. If multiple > printer flags and printer data fields are included, the audio data will be voiced in the order in which the printer fields are included in the message.

  • Page 30: Vg Data In Interactive Transaction Response Messages

    MoniPlus2 Voice Guidance Configuration Guide 5.2 VG Data in Interactive Transaction Response Messages The host can use Interactive Transaction Response (ITR) messages to gather additional information from a customer during a VG session, just as it can during a non-VG session. There are two methods that the host can use to gather additional information using the ITR message: •...

  • Page 31: Indirect Audio Id Method

    MoniPlus2 Voice Guidance Configuration Guide When the ITR is processed at the ATM, the customer will hear: “To process this transaction you will be charged a fee of $1.00. To accept this fee press 1. To cancel this transaction press 2 or the cancel key.”...
  • Page 32 MoniPlus2 Voice Guidance Configuration Guide The ITR message that would be sent to the ATM that contains the overlay information for the account selection is shown below. The Active Keys field specifies that the numeric keys, along with the Enter, Clear and Cancel keys, will be active on the keypad.

  • Page 33: Transferring The Voice Guidance Xml File To The Atm

    If you are using the MoniPlus2 dynamic device orientation feature and the devices on the ATM change for any reason, you must either physically reload the VG XML file or download it again from the host, depending upon which method you typically use.

  • Page 34: Terminal Response To The Load Xml File Message

    MoniPlus2 Voice Guidance Configuration Guide Field Name Number of Mandatory or Data Characters Optional Audio Guidance XML Data Field Separator Message Authentication Code Trailer Header Network Protocol dependent Message Class ‘3’ Fixed to ‘3’ for the data load command Response Flag...

  • Page 35: Terminal Status Messages

    MoniPlus2 Voice Guidance Configuration Guide 7 Terminal Status Messages A Specific Command Reject message can be sent in response to the VG XML file download. The details of this message are included in the next section. 7.1 Specific Command Reject Message...
  • Page 36 MoniPlus2 Voice Guidance Configuration Guide Header Network Protocol dependent Message Class ‘2’ Fixed to ‘2’ for a solicited message Message Sub-Class ‘2’ Fixed to ‘2’ for a status message Field Separator Mandatory FS Logical Unit Number LUNO Field Separator Mandatory FS...

  • Page 37: A Moniplus2 Vg Xml File Elements Quick Reference

    MoniPlus2 Voice Guidance Configuration Guide A MoniPlus2 VG XML File Elements Quick Reference This section provides a list and short description of the elements and attributes used in a MoniPlus2 VG XML file. Elements Attributes Description Config Defines parameters required to initialize an audio...
  • Page 38 MoniPlus2 Voice Guidance Configuration Guide Elements Attributes Description Yes key noKeyPos Key the customer will press to select No for the option noAudioID AudioID to play when the customer presses the No key defaultResponse Default selection for the option Keyboard...

  • Page 39: B Sample Moniplus2 Vg Xml File

    MoniPlus2 Voice Guidance Configuration Guide B Sample MoniPlus2 VG XML File This section contains a very minimal multi-language AudioGuidanceData.xml file sample that you can use as a guideline, or starting point, when developing your own file. The device orientation sample included with this file is for the 7600FFL ATM.
  • Page 40 MoniPlus2 Voice Guidance Configuration Guide <Key pos="3" code="F4" /> <Key pos="5" code="F3" /> <Key pos="6" code="FA" /> <Key pos="7" code="F9" /> </Keyboard> <!-- ABCDI --> <Keyboard keyboardID="103"> <Key pos="1" code="F6" /> <Key pos="2" code="F5" /> <Key pos="3" code="F4" /> <Key pos="5" code="F3" />...
  • Page 41 MoniPlus2 Voice Guidance Configuration Guide <Key pos="2" code="F5" /> <Key pos="3" code="F4" /> <Key pos="5" code="F3" /> <Key pos="6" code="F7" /> </Keyboard> <Keyboard keyboardID="111"> <Key pos="3" code="F4" /> <Key pos="5" code="F3" /> <Key pos="6" code="F7" /> </Keyboard> <!-- ADA Option Messages -->...
  • Page 42 MoniPlus2 Voice Guidance Configuration Guide <!-- Reserved Screens --> <Audio audioID="0001" groupID="0000" repetitions="0"> <Text lang="en"> We're sorry, this A.T.M. is off line. </Text> <Text lang="sp"> Estamos apesadumbrados, esta máquina somos actualmente inasequibles. </Text> </Audio> <Audio audioID="0002" groupID="0000" repetitions="0"> <Text lang="en"> We're sorry, this A.T.M. is out of service.</Text>...
  • Page 43 MoniPlus2 Voice Guidance Configuration Guide <Text lang="sp”> Su tarjeta no puede ser leído o se ha insertado incorrectamente. Por favor, inténtelo de nuevo. </Text> </Audio> <Audio audioID="0019" groupID="0000" repetitions="0" keyboardID="106”> <Text lang="en”> Press 1 for English. Press 2 for Spanish. </Text>...
  • Page 44 MoniPlus2 Voice Guidance Configuration Guide <Audio audioID="1000-C" groupID="0000"> <Text lang="sp”> Cancelado, mas tiempo </Text> </Audio> <Audio audioID="1200" groupID="0000" repetitions="0" keyboardID="107" keyText="true"> <Text lang="sp”>E Estado. Presione 1 para continuar o Cancelar para finalizar la transacción. </Text> </Audio> <Audio audioID="1200-1" groupID="0000"> <Text lang="sp”> 1 </Text>...
  • Page 45 MoniPlus2 Voice Guidance Configuration Guide <Audio audioID="0940" groupID="0000" repetitions="0"> <Text lang="en”> Thank you for banking with us. Take your receipt <Link audioID="NHORIENTATIONLINKReceiptPrinter" /> </Text> </Audio> <Audio audioID="0941" groupID="0000" repetitions="0"> <Text lang="en”> Thank you for banking with us. </Text> </Audio> <Audio audioID="0300" groupID="0000" repetitions="0" keyboardID="103" keyText="true">...
  • Page 46 AudioGuidanceData.xml file for device orientation. You can link to these audioIDs for the individual devices for orientation instructions. The audioID names used in this example are the actual values that will be included by MoniPlus2, regardless of the type of ATM.--> <Audio audioID="NHORIENTATIONLINKIntroduction">...
  • Page 47 MoniPlus2 Voice Guidance Configuration Guide <Audio audioID="NHORIENTATIONLINKEnvelopeDepository"> <Text lang="en"> The envelope depository is located at the 5 o'clock position, 14 inches from the keypad. </Text> </Audio> <!—The following audio entry shows the composite audioID that voices the location of all the devices on the ATM.

  • Page 48: C Index

    MoniPlus2 Voice Guidance Configuration Guide C Index < <afaLang> Element, 8 groupID attribute, 7, 14, 16 <afaOption> Element, 9 <Audio> Element, 15 <Config> Element Sample, 11 <Key> Element, 14 Hardware Restrictions, 4 <Keyboard> Element Sample, 15 <LangOption> Element, 8 <Text> Element, 19...
  • Page 49 VG filename, 29 Restrictions, 4 VG Transaction Processing, 5 VG XML File, 6 Volume Control, 4 Sample MoniPlus2 VG XML File, 35 screen attribute, 8, 10 Screen Display Update Field, 20, 22 yesAudioID attribute, 10 screenOffset attribute, 8 yesKeyPos attribute, 10...

Table of Contents