Print Server for Check-In
=========================
To print labels for Check-In, you will need one or more label printers
connected to a PC and the TouchPoint Check-In Print Server installed on that
PC. Check-In stations will communicate with the print server by matching the
station's assigned kiosk name to one of the print services running on the PC.

.. note::
    The current version of the TouchPoint Check-In Print Server is **1.2.1**. You will find the version number in the titlebar of the print server application.

Setting Up the TouchPoint Check-In Print Server
-----------------------------------------------
To prepare the print server, follow these steps:

Step 1
    Install one or more label printers on the PC and test them to make sure they
    are printing correctly. See the article on :doc:`PrinterSettings` for instructions
    on configuring the printer settings for the size of labels you will use.

Step 2
    Install the TouchPoint print server software. Go to https://www.touchpointsoftware.com/checkinprinter.
    Click the green **Download Now** button to download the installer. 

    .. figure:: https://i.tpsdb.com/104DownloadInstaller.png
        :target: #

    |

    Once the installer is downloaded, double-click to run it and click **Yes** to allow the app to make changes on your computer.

    .. important::
        Older versions of the Check-In Print Server relied on Oracle 32-bit Java 1.8, which is outdated. Beginning with version 1.2.1, the Check-In Print Server now relies on OpenJDK Java 19. This is automatically installed with the Print Server when you run the installer. If you do not have any other applications that rely on the outdated Oracle 32-bit Java 1.8 version, you can uninstall it.

Step 3
    During installation you will be prompted to **Install as a service**. This will allow the print server to run 
    in the background, even when no user is logged onto the PC. To enable this feature, you will need to enter login 
    credentials. By default, your username will be preselected and you will need to enter the password. This should be the username and password used to log onto the PC where Check-In is happening.

    .. figure:: https://i.tpsdb.com/113InstallAsService.png
        :target: #

    .. important::
        Do not use the credentials of a domain admin account for this. As prompted on the installation screen, use the credentials that will be used when logging on to configure the print servers and where Check-In is being launched and used. If you are using a restricted Windows account to run Check-In, those are the credentials that should be entered for the service.

    .. admonition:: Running as a Service versus Manually

        When you run the print server as a service, you do not leave the print server application open. Instead it runs in 
        the background. Open the application only when you need to adjust settings, then promptly close it. However, if you prefer, you can decline to run it as a service and instead manually open the application when it is needed.

Step 4
    If a previous version of the TouchPoint Print Server has been used on this PC, the settings will be auto-populated. 
    Otherwise, you will need to configure your server (your TouchPoint database name), log in, and set up the print services. 
    To log in, you must enter the credentials for an account with the Checkin role. Additionally, you may select 
    **Remember login info** if you would like to remain logged in on this device until you select **sign out.** This will keep 
    you logged in even when the machine is restarted.

    .. figure:: https://i.tpsdb.com/Hayley-Login.png
        :target: #

    To add a print server, click the **Add Server** button.
    Select one of the installed printers from the top drop down list, set the label format
    to the desired size (1-inch or 2-inch), and enter the kiosk name(s) this server will print
    labels for. Optionally (if the labels you have are oversized), enter margins for the four
    sides. Usually these should remain blank. Finally, click the **Add** button.

    .. figure:: https://i.tpsdb.com/AddServer.png
        :target: #

    |

    After the installation completes, you will see a dialog box pop up that says "Setup complete!".
    
    .. figure:: https://i.tpsdb.com/SetupComplete.png
        :target: #

    |
    
    Once you click the "OK" button, a shortcut icon for the print server will be created on the PC's desktop and you will be presented with a login prompt.

    .. figure:: https://i.tpsdb.com/104Shortcut.png
        :target: #

Running Print Servers
---------------------
If you are running the print server as a system service, it will run in the background even if no user is logged onto the PC. If you have chosen to run the print server interactively, click the print server shortcut to start it.

.. figure:: https://i.tpsdb.com/113PrinterSetup.png
    :target: #

|

Modifying a Print Server's Configuration
----------------------------------------
Should you need to change a print server's settings, double click the print server's entry in the
TouchPoint Check-In Print Server panel. Make the desired modifications to the setting, then click the
**Update** button.

Removing a Print Server
-----------------------
To delete a print server, click on the target server to highlight it. Then click the **Remove Server** button.

Automatically Launching
-----------------------
If you are not running the print server as a system service and would like the print server to automatically launch when you log in to Windows, add the TouchPoint Check-In Print Server
shortcut to your Windows Startup/Start folder.

.. note::
    If you are running the print server as a system service, there is no need for automatically launching the application.
    While we recommend running the print server as a service, there may be circumstances where you cannot do so (for example,
    if you do not have administrator privileges on the PC) and might want to have the print server launched automatically
    when you log into the PC.

Step 1
    Right-click on the TouchPoint Check-In Print Server shortcut on your desktop and select **Copy**.

Step 2
    Click the **Start** button in Windows.

Step 3
    Paste the following text into the search box and press **Enter**
    ``%appdata%\Microsoft\Windows\Start Menu\Programs\Startup``

Step 4
    In the Startup folder, right-click and select **Paste**.

|
|

+--------------------+------------------+
| **Latest Update**  |   **2/27/2023**  |
+--------------------+------------------+

Updated for v1.2.1