Configuring the Device Manager File
This task uses the following file.
File name | Folder |
---|---|
DeviceManager.xml | Configuration folder
|
To configure the devices and peripherals in the DeviceManager.xml file, follow these steps:
- Open the DeviceManager.xml file.
- Scroll through the file and browse for the list of devices. The following table lists the default devices listed in the DeviceManager.xml file.
Device name Default oposDeviceName Scanner NCRScanner.0 Printer AS.Printer.2 Windows Printer AS.Windows.Printer Msr NCRMSR.0 PinPad No description LineDisplay NCRLineDisplay.0 Micr NCRMicr.0 CashDrawer NCRCashDrawer.0 Storage NCRHardTotals.0 Tone NCRToneIndicator.0 NoteThe default oposDeviceName represents the initial POS configurations in the DeviceManager.xml file after the POS application is installed.
- Use the following table to configure the attribute values.
Attribute Description Name Indicates the name of the device referenced by the application. Type Identifies the type of device. Use one of the following valid values:
- Proxy
- Opos
- Simulate
- SimpleFilePrinter
oposDeviceName Identifies the name of the configured OPOS device.
Ensure that this name matches the profile name for the device in the RSM tool.
NoteEnsure that this name matches the profile name for the device in the RSM tool.
ExampleIf the printer profile created in the RSM Tool uses the Profile Name NCRScanner.7872, modify the default value of the oposDeviceName of the printer device into NCRScanner.7872.
Terminator Defines the name of the termination key that is returned with any input data from the device. Enabled By default, the value is set to true. This value indicates that the device is set to be enabled when opened. Enabling the device permits input to be received from that device. If the device is not enabled but its termination key is valid for the current view, the device becomes enabled while at the current view. optionalDevice By default, the value is set to true. This value indicates that this device is not needed in order to run the application. If a device is not optional and it is not successfully opened, the platform throws an exception. runOnMainThread By default, the value is set to false. This value indicates that this control runs only if it is started on the main application thread. This should only be set to true if the Service Object control requires this control; otherwise, the application performance can be affected. allowBuffering By default, the value is set to true. This value indicates that date for this device can be stored in the input manager until such a time that it is required. - Configure the attribute values as required.
- To enable a Windows printer for HTML reports, remove the comments from the line for the AS.Windows.Printer device, as in the following example:Example
<!-- ** Printer - Windows Printer ** -->
<Device name="AS.Windows.Printer" ofmCreationClassName="AsWindowsPrinter" terminator="SlipIn"/>NoteThe Use Default Printer for Reports parameter determines if the Windows default printer will always be used to print HTML reports. For more information, refer to Local Customization.
- Save the file.
Simulated Devices
The POS application can be configured to enable simulated devices for the peripherals, such as the printer, scanner, or cash drawer. The DeviceSimulator.xml file configures the Device Simulator application. To configure the simulated devices, open the DeviceSimulator.xml file.
This task uses the following file.
File name | Folder |
---|---|
DeviceSimulator.xml | Configuration folder
|