HomeAdministration Manual for LibrariesClient & Workstation Setup and AdministrationIf You Use Hatch

3.4. If You Use Hatch

Why Hatch?

As it is now, the Evergreen web client for 3.1 stores some of your settings and customizations temporarily in the web browser’s “cache.” This is sort of like the short term memory of your web browser. Occasionally, you may need to clear the cache (like when you clear your cookies or browsing history), which results in your customizations for the Evergreen web client disappearing. When you clear the cache, you’ll need to re-register your workstation, your receipt printer customizations will revert to stock and any column configurations you’ve changed (order, sorting, size, etc.) will go back to their default settings.

Hatch To The Rescue

Hatch is a browser plug in that is designed to allow you to save your settings for things like workstation setting, receipt templates and column configurations on your local machine and restore them if needed.

How to Install, Activate and Enable Hatch

Ensure that you have the up to date Java Runtime Environment. Hatch requires the Java Runtime Environment (JRE) version 1.8 or higher. If you are unsure which version you have, view your computer's list of programs. You can download the latest version at: https://www.java.com/en/download/help/windows_manual_download.xml


Download and Install the Hatch browser plug in. https://evergreen-ils.org/egdownloads/ Look for: Web Staff Client Extension (“Hatch”) 


When you open Chrome, it should recognize that you have the new Hatch Extension installed and prompt you to enable it, but if it does not, you may need to manually enable it:

  1. Go to: the Menu > More Tools > Extensions
  2. Click on the checkbox next to Hatch Native Messenger to enable it.

When the Hatch extension is enabled for your browser, you will see a small yellow icon in the top-right corner of the browser.



Enable Hatch in Evergreen: Administration > Work Station > Print / Storage Service ("Hatch")

Use Hatch For Printing

When you use Hatch for printing, it allows you to save your configurations for how you want receipt printing handled. 


Store Local Settings in Hatch


Copy Local Storage Settings to Hatch: 

Copy Hatch Settings to Local Storage: Once you have your receipt printers configured and columns adjusted, you can click this button to save these settings to your local machine. 


Store Offline Transaction Data in Hatch


Setting Up Your Printers After Installing Hatch

(For more details on setting up your receipt printers, see: http://nccardinalsupport.org/index.php?pg=kb.page&id=329 )

Go to Administration > Workstation > Printer Settings…

Default Tab

  1. Set Printer to go to your laser printer.
  2. Ensure that Paper Type is set correctly.
  3. Adjust any other settings as you wish.
  4. Click Apply Changes.

Receipt Tab

  1. Set Printer to go to your receipt printer.
  2. Ensure that your Paper Type is set to Roll Paper 80 x 297 mm (or whichever roll size your receipt printer uses).
  3. Set Automatic Margins to HARDWARE_MINIMUM.
  4. Click Apply Changes.

Label Tab 
(Most staff will not have a label printer, so this step can be skipped.)

  1. Set Printer to go to your label printer.
  2. Ensure that your Paper Type is set to the appropriate type.
  3. Set Automatic Margins to HARDWARE MINIMUM.
  4. Click Apply Changes.

Mail Tab

  1. Set Printer to go to whichever printer you wish to print mailing addresses to (this may be a laser printer, label printer, or receipt printer, depending on your local configuration).
  2. Set Paper Source appropriately (ie, if using envelopes in a laser printer, choose Manual).
  3. Set the Paper Type appropriately.
  4. Set the Page Orientation appropriately (relevant if printing to something such as an envelope.
  5. Click Apply Changes.

Offline Tab

  1. Set Printer to go to your receipt printer.
  2. Ensure that your Paper Type is set to Roll Paper 80 x 297 mm (or whichever roll size your receipt printer uses).
  3. Set Automatic Margins to HARDWARE_MINIMUM.
  4. Click Apply Changes.

 Force Printer Context

If your receipts appear to be printing to the default printer even though you have the receipt printer configured, you may need to do this step as well.

  1. Go to Administration > Workstation > Print Templates.
  2. Select the first template type.
  3. Choose the desired printer from the Force Printer Context (ie, Default or Receipt) dropdown.
  4. Click Save Locally.
  5. Repeat for each of the other templates.

If you export your print templates, the export will contain these printer context settings as well.


How to Reconnect Hatch if You Clear Your Cookies

If you clear your browser cookies without having Hatch installed, any local settings you have stored will be lost. However, if you have Hatch installed, you should be able to reconnect to Hatch using these steps and retrieve your settings.

  1. Log in with a LibraryManager or LocalAdmin account.
  2. Create a workstation and click Use Now to log in again.
  3. Navigate to Administration > Workstation > Print/Storage Service (“Hatch”).
  4. Check all three boxes.
  5. Click on the Home icon.
  6. You will be returned to the workstation registration screen again - click Use Now to log in again.
  7. Your local settings should now be restored.


This Too Shall Pass

Hatch isn’t expected to be necessary when we upgrade to Evergreen 3.2. Rather than these sorts of settings being stored in the local cache, they’ll be stored on the server and available to you when you login.


Presentations from the 2018 Evergreen Conference

Print Templates in the Web Client by Terran McCanna

What’s HATCH-ing? by Bill Erickson, Jason Boyer, Blake Graham-Henderson, and Chris Sharp



This document incorporates elements of documentation from Georgia Pines: https://pines.georgialibraries.org/dokuwiki/doku.php?id=circ:workstations:hatch shared under Creative Commons Attribution Share-Alike 4.0 License (https://creativecommons.org/licenses/by-sa/3.0/legalcode) and is available to share under the same license. 


Knowledge Tags

This page was: Helpful | Not Helpful