Using Evergreen’s Tools Module

Documentation Interest Group


Table of Contents

I. Introduction
1. About this Documentation
2. About Evergreen
II. Introduction
III. ISBNs
IV. Records
3. Record formats
4. Retrieve records
5. Recent records
Filtering by Org Unit
V. Adding OpenSearch to Firefox browser
VI. Adding Parameters
VII. Output
VIII. Holds
IX. Overdues
X. Skipping patrons with email notification of holds
XI. Using the ws_ou parameter
XII. Automating the download
XIII. Simple search form
XIV. Advanced search form
XV. Encoding
XVI. Setting the document type
XVII. Setting the library
XVIII. SIP Server
6. Installing the SIP Server
Getting the code
Configuring the Server
Adding SIP Users
Running the server
Logging-SIP
Testing Your SIP Connection
More Testing
7. SIP Communication
01 Block Patron
09/10 Checkin
11/12 Checkout
15/16 Hold
17/18 Item Information
19/20 Item Status Update
23/24 Patron Status
25/26 Patron Enable
29/30 Renew
35/36 End Session
37/38 Fee Paid
63/64 Patron Information
65/66 Renew All
93/94 Login
97/96 Resend
99/98 SC and ACS Status
Fields
A. Attributions
B. Adomonitions
Index

List of Tables

1. Parameters for the phonelist program:
2. Columns in the holds CSV file:
3. Columns in the overdues CSV file:

Evergreen’s unAPI support includes access to many record types. For example, the following URL would fetch bib 267 in MODS32 along with holdings, volume, copy, and record attribute information:

https://example.org/opac/extras/unapi?id=tag::U2@bre/267{holdings_xml,acn,acp,mra}&format=mods32

To access the new unAPI features, the unAPI ID should have the following form:

PhoneList.pm is a mod_perl module for Apache that works with Evergreen to generate callings lists for patron holds or overdues. It outputs a csv file that can be fed into an auto-dialer script to call patrons with little or no staff intervention. It is accessed and configured via a special URL and passing any parameters as a “Query String” on the URL. The parameters are listed in the table below.

Table 1. Parameters for the phonelist program:

user

Your Evergreen login. Typically your library’s circ account. If you leave this off, you will be prompted to login.

passwd

The password for your Evergreen login. If you leave this off you will be prompted to login.

ws_ou

The ID of the system or branch you want to generate the list for (optional). If your account does not have the appropriate permissions for the location whose ID number you have entered, you will get an error.

skipemail

If present, skip patrons with email notification (optional).

addcount

Add a count of items on hold (optional). Only makes sense for holds.

overdue

Makes a list of patrons with overdues instead of holds. If an additional, numeric parameter is supplied, it will be used as the number of days overdue. If no such extra parameter is supplied, then the default of 14 days is used.


The URL is

https://your.evergreen-server.tld/phonelist

A couple of examples follow:

`https://your.evergreen-server.tld/phonelist?user=circuser&passwd=password&skipemail

The above example would sign in as user circuser with password of “password” and get a list of patrons with holds to call who do not have email notification turned on. It would run at whatever branch is normally associated with circuser.

https://your.evergreen-server.tld/phonelist?skipemail

The above example would do more or less the same, but you would be prompted by your browser for the user name and password.

If your browser or download script support it, you may also use conventional HTTP authentication parameters.

https://user:password@your.evergreen-server.tld/phonelist?overdue&ws_ou=2

The above logs in as “user” with “password” and runs overdues for location ID 2.

The following sections provide more information on getting what you want in your output.

To enable users to quickly search your Evergreen catalog, you can add a simple search form to any HTML page. The following code demonstrates how to create a quick search box suitable for the header of your web site: