MoniPlus2 Voice Guidance Configuration Guide
April 29, 2014
6
4 Creating the VG XML File
The VG XML file,
AudioGuidanceData.xml,
used with MoniPlus2 is similar to the VG XML file used
with NCR APTRA Advance NDC, although MoniPlus2 does not use all of the functions of the NCR
implementation. MoniPlus2 has tried to minimize the complexity and, therefore, has simplified the file.
This section describes the elements and attributes from the AudioGuidanceData.xml file that are used by
the MoniPlus2 application. Additional elements and attributes may be added in the future. The
VG XML File Elements Quick Reference
section on page 33 provides a full list and short descriptions of
these elements and attributes for your reference. The
section on page 35
includes a sample of a full VG XML file.
This section also explains how device orientation instructions are automatically included in the
orientation portion of your VG file and how you can add device orientation information into any of your
instructions that involve devices, such as “Please take your cash.”
Note:
The NCR APTRA Advance NDC VG XML file can be used ‘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 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. Refer to your NCR documentation for a list of their required elements.
4.1 Declaration Tag
The VG XML file is XML 1.0 and requires the following declaration as the first line in the file.
<?xml version="1.0" encoding="ISO-8859-1"?>
The encoding declaration is optional, but its inclusion is highly recommended.
4.2 Start and End Tags
The beginning of the VG XML document is identified by the start tag:
<x:NCRAudioGuidance xmlns:x="urn:xsdNCRAudioGuidance">
The end of the document is identified by the end tag:
</x:NCRAudioGuidance>
These tags were mandatory in previous releases, but are now optional.
4.3 VG XML File Elements
The MoniPlus2 VG XML file contains 3 types of elements:
•
<Config>
− defines options for the VG session.
•
<Keyboard>
− defines the FDK to numeric keyboard mapping.
•
<Audio>
− defines the audio messages associated with the screens.
Each of these elements is described in detail in the remainder of this section.
