Virtual Printer Setup

This Ethernet-based virtual Zebra Label Printer can be used to test applications that produce bar code labels.

1. Install the ZPL printer found at GitHub: https://github.com/porrey/Virtual-ZPL-Printer
   
   
   
   
2. Download the file and then open it.
   
   
3. Click Edit in the upper-right corner to view printer settings.
   
   
   
   
4. Set the desired label size and file type, then set the network settings listed below and click Save.
   1. IP Address = 127.0.0.1
   2. TCP Port = 9100
      
      
      
      
5. Open the Printers & scanners system settings to install this as a network printer in Windows.
   
   
6. Click Add device.
   
   
   
   
7. The system will scan for available printers. Let it search for 10 seconds, then click Add manually next to "The printer that I want isn't listed."
   
   
   
   
   
8. Select the Add a printer using an IP address or hostname option and click Next.
   
   
   
   
9. Enter the settings listed below and click Next.
   1. Device type = TCP/IP Device
   2. Hostname or IP address = 127.0.0.1
   3. Port name = 9100
   4. Select the Query the printer and automatically select the driver to use checkbox
      
      
      
      
10. These settings match the ZPL printer configured in Step 4. Return to the Virtual ZPL Printer app and click Start.
    
    
    
    
11. When the Additional port information required page opens on the printer configuration pop-up, leave all settings on their defaults, check that the Generic Network Card option is selected, and then click Next.
    
    
    
    
12. The Install the printer driver page should default to Generic under Manufacturer and Generic/Text Only under Printers.
    
    If not, select these options, then click Next.
    
    
    
    
13. Enter a name for the printer and click Next.
    
    
    
    
14. You should see a message that you have successfully added the printer. Click Finish.
    
    
15. The virtual printer should now be listed in your in available printers and scanners.
    
    

Document Routing Agent

The Document routing agent (DRA) is used by D365 to process user print requests and send them to the correct printer.

This must be installed in order to test printing on your personal computer. Your computer essentially becomes a print server, giving you the ability to print on your desired printers.

1. Navigate to Organization administration > Setup > Network Printers and click Download document routing agent installer.
   
   
   
   
2. Open the download file and install the DRA on your computer.
   
   
3. Open after installation and click Settings to add connection details and click OK.
   
   1. Azure AD authentication endpoint: https://login.microsoftonline.com
   2. Application ID: N/A (this will be auto-populated)

   3. Dynamics 365 F&O URL: environment URL

      Note

      • Make sure there is no backslash at the end of the URL.
      • You must update this if you are using different environments (URLs). If so, you must first sign out and then open Settings because once the connection is established, the DRA will be signed in automatically when opened.

      
      
      

4. Click Sign In and enter your Microsoft credentials.

   Note

   If you change your settings, close the DRA app, then reopen, to ensure the new settings are saved.

5. Click Printers, select your printer, and click Register to register your ZPL printer with the D365 environment.
   
   
6. Open the Network printers form again, select your record, edit, and change Active to Yes.
   
   

Usage

1. Add the printer in Document routing in your D365 environment.
   
   
   
   
2. Start the Document Routing Agent on your computer. Leave it open to push the labels to the correct printer.
   
   
3. Start the Virtual ZPL Printer app on your computer. Leave it open to receive labels.

Troubleshooting