Configuring the Printer

Configuration files
  • ..\parameter\client\hal.properties
  • ..\parameter\client\jpos.xml
  • ..\parameter\client\report.properties
  • ..\parameter\flowService\client\flow\selectDeviceConfigs.properties
  • ..\parameter\server\flowService.properties

Printer Activation

To configure a printer, proceed as follows:

  1. Enable the printer in the configuration file hal.properties: 
     DeviceEntryTypes.pr_ibm_4610_TF6_com2.id=pr_ibm_4610_TF6_com2
DeviceEntryTypes.pr_ibm_4610_TF6_com2.deviceCategory=PRINTER
DeviceEntryTypes.pr_ibm_4610_TF6_com2.enabled=true
DeviceEntryTypes.pr_ibm_4610_TF6_com2.active=true
 DeviceEntryTypes.pr_ibm_4610_TF6_com2.className=com.gk_software.pos.hal.device.printer.JPosPrinterImpl
  2. Set the printer as the default printer: 
    DeviceMappingEntryTypes.DefaultPrinter.id=DefaultPrinter
 DeviceMappingEntryTypes.DefaultPrinter.deviceCategory=PRINTER
 DeviceMappingEntryTypes.DefaultPrinter.mappedTo=pr_ibm_4610_TF6_com2
  3. Configure the port in the file jpos.xml, if necessary:
    <JposEntry logicalName="pr_ibm_4610_TF6_com2">
...
<prop name="portName" value="COM2" type="String"/>
...
</JposEntry>
Note:
A corresponding entry must exist in the file jpos.xml. The logicalName corresponds to the ID of the printer entry from the file hal.properties.

Defining the Printer Directory

The configuration is set in the file report.properties:

To define the printer directory, proceed as follows:

  • Enter the desired report directory depending on the printer type.

    Use the report directory reports_ibm_wnfor IBM, HP and Wincor printers.

    ReportTemplateProviderConfig.reportsSubDirectory=client/reports_ibm_wn
For all other printers (e.g. Epson), use the report directory reports by default.
 ReportTemplateProviderConfig.reportsSubDirectory=client/reports

Document Logo

The path to the receipt logo file is defined in the configuration file report.properties:
CommonPrintoutConfig.logoFile=client/logo.bmp

This means that the receipt logo file is saved here:

../parameter/client/logo.bmp

Mobile POS

Printer Selection in User Menu

To enable the selection of a POS printer in the user menu proceed as follows:
 FlowServiceConfig.workstationDeviceCategories.MOB.entries.0.enabled=true
 FlowServiceConfig.workstationDeviceCategories.MOB.entries.0.deviceCategory=PRINTER
To enable the selection of a graphical printer in the user menu proceed as follows:
 FlowServiceConfig.workstationDeviceCategories.MOB.entries.1.enabled=true
 FlowServiceConfig.workstationDeviceCategories.MOB.entries.1.deviceCategory=GRAPHICAL_PRINTER

Visibility of Printers in the Printer Selection Function

All printers enabled in hal.propertiesare visible in the Printer Selection function. Some of these devices should only be available for the POS Full Client.

To hide them in the Printer Selection function, proceed as follows:

  1. In hal.properties, set a subcategory for all printers that should not be available in the Printer Selection function, for example: 
    DeviceEntryTypes.JPOSPrinter.subCategory=FATPOS_PRINTER
  2. In selectDeviceConfigs.properties, set this subcategory as hidden:
    SelectDeviceConfigs.Printer.hideSubCategoryDevices.0=FATPOS_PRINTER