Configuring the DataSplice .NET Printer Plug-in
Now that the plug-in has been successfully installed, you need to configure it appropriately. The steps detailed in this page assume that you installed the plug-in to the default root directory, C:\Program Files\DataSplice.
In the C:\Program Files\DataSplice\Plugins\Server\DotNetModules folder, there is a printer configuration file titled DataSplice.Printing.dll.config. This printer configuration file specifies the following information:
- Resource Path - The directory in the DataSplice root path where all of the resource files get placed (such as
C:\Program Files\DataSplice\Resources). - Label Template File Path - The path where DataSplice stores the XML barcode templates to be able to print the barcode (such as
C:\Program Files\DataSplice\Plugins\Server\DotNetModules\BarcodeLabels). For more information, please see the Creating Template Files for Label Formatting section. - Available Barcode Printers
Each barcode printer has a name and a type. The printer name that you choose in the configuration file is used to reference the printer from the DataSplice plug-in event. The printer type specifies what printer language to use when the plug-in is sending commands to the printer. The available printer types are:
- DPLDriver - network printer
- EPLDriver - network printer
- IPLDriver - network printer
- ZPLDriver - network printer
- PL4Driver - serial/Bluetooth printer
Network printers have an IP address location and port. The PL4 printer does not reside on the network. As such, it uses other unique tags as seen below to specify its configuration information.
You will want to edit the DataSplice.Printing.dll.config file and configure the paths and other information as described in the following example XML code, where {Printer IP Address} is the IP address of the network printer:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="barcodePrinters" type="System.Configuration.IgnoreSectionHandler"/>
</configSections>
<appSettings>
<add key="ResourcePath" value="C:\Program Files\DataSplice\Resources"/>
<add key="LabelPath" value="C:\Program Files\DataSplice\Plugins\Server\DotNetModules\BarcodeLabels"/>
</appSettings>
<barcodePrinters>
<printer name="DPL Barcode Printer" type="DPLDriver">
<location>{Printer IP Address}</location>
<port>9100</port>
</printer>
<printer name="EPL Barcode Printer" type="EPLDriver">
<location>{Printer IP Address}</location>
<port>9100</port>
</printer>
<printer name="IPL Barcode Printer" type="IPLDriver">
<location>{Printer IP Address}</location>
<port>9100</port>
</printer>
<printer name="ZPL Barcode Printer" type="ZPLDriver">
<location>{Printer IP Address}</location>
<port>9100</port>
</printer>
<printer name="PL4 Barcode Printer" type="PL4Driver">
<serialPort>com4</serialPort>
<!-- The following tags configure the serial port printing. -->
<!-- They are optional, with default values as shown below. -->
<baudRate>19200</baudRate>
<byteSize>8</byteSize>
<stopBits>1</stopBits>
<parity>None</parity>
</printer>
</barcodePrinters>
</configuration>