Installing the DuckDocs (OnBase) Virtual Print Driver for the Unity Client

Overview

Learn how to install the virtual printer driver for the DuckDocs (OnBase) Unity client. The Virtual Print Driver is installed automatically if installing the Unity Client via Software Center. If you have installed the Unity client via software.uoregon.edu and would like to install the Virtual Print Driver, you may do so by following the steps below.

Installation

1. Navigate to the following URL: https://software.uoregon.edu/software-center. (You may be prompted to login with your DuckID)
2. Next to the OnBase Unity Client, click the button labeled 23.1.9.1000. 
3. Click the link for the OnBase 23.1 Virtual Print Driver Installer. 
4. Locate the downloaded file on your computer, right-click and choose Extract All… 
5. Navigate to the extracted folder. 
6. Right-click on both the setup.exe and Hyland Virtual Print Driver (x64), click Properties. If the option is available, check Unblock.
7. Double-click setup to begin the installation. A Welcome screen should appear. Click Next. 
   1. Note: You may be prompted to install prerequisites. To proceed click Install. 
8. The following details explain how to navigate the steps in the installer: 
   1. On the Installation Options screen, accept the default Spool Directory (“C:\OnBase Printer Spool\” and select the Auto-Detect option under the Environment setting. 
   2. Click Next, and then Install 
9. Once the installation is complete, click Finish. 

When using the Virtual Print Driver, it will be necessary to have the Unity Client open and logged in. If the Virtual Print Driver is correctly installed, the Hyland Software Virtual Printer should be available to select from the print menu in other applications. The Virtual Print Driver works successfully if, after choosing Print, the document opens in the Unity Client. (It may take a moment for the document to open in the Unity client.) 

Printing to TIF and Importing into OnBase

1. Open the Unity Client and sign in.
2. When you print a file, you should see Hyland Software Virtual Print Driver as a printer option.
   
3. After clicking Print, a TIF version of the document you print will appear in C:/OnBase Printer Spool folder
   and, if you are logged in to the Unity Client, the document will then appear in a new window allowing
   you to import the document into OnBase.
   
4. Choose an appropriate Document Type and click Import.

Verifying Installation / Troubleshooting

Hyland Virtual Print Driver shows up as a print option, but it doesn’t open Unity client when I try to print. 

• If you installed the Unity Client via software.uoregon.edu, ensure you have copied the appropriate config file into the Unity client program files, as described in the Additional Configuration section of the Unity Client Installation Instructions. 
• Ensure you have installed the correct version of the Virtual Print Driver from software.uoregon.edu. The correct version of the Virtual Print Driver should be labeled 23.1.9.1000 on software.uoregon.edu. 
• If you installed the Unity Client via software.uoregon.edu, Ensure you have installed the prerequisite C++ redistributables as part of the Unity client and Print Driver installation process. You can confirm the appropriate redistributables are installed by following these steps: 
  • Search for Add or Remove Programs in your Windows search bar. Click the Add or Remove Programs result to open the appropriate settings window. 
  • Use the search box in the Add or Remove Programs screen to search for C++. 
  • You should see Microsoft redistributables for 2012 (x86), 2012 (x64), 2015-2022 (x86) and 2015-2022 (x64). 
    • If any of these redistributable packages are missing, you can re-download and install them from software.uoregon.edurusing the redistributables found with the OnBase Unity Client version 23.1.9.1000. 
• If you installed the Unity Client via software.uoregon.edu, ensure you have installed the Virtual Print Driver Listener as part of the Unity Client installation process. You can review the installation status of the listener by following these steps: 
  • Search for Add or Remove Programs in your Windows search bar. Click the Add or Remove Programs result to open the appropriate settings window. 
  • Use the search box in the Add or Remove Programs screen to search for the Unity Client. 
  • Select the program and click Modify. The deployed application Maintenance dialog is displayed. Click Next, then Change. On the Custom Setup screen, ensure both the Unity Client and the Virtual Print Driver Listener are set to be installed on the local hard drive. 
  • If changes were made to the Custom Setup screen, continue with step 7 of the Unity Client installation instructions.