The New Books ListThe New Books List

Michael Doran, Systems Librarian

Ex Libris Southwest Users GroupFebruary 6, 2008 – Santa Ana College

Michael Doran, Systems Librarian doran@uta.edu

An unofficial WebVoyáge add-on

Michael Doran, Systems Librarian doran@uta.edu

The “New Books” tab

Michael Doran, Systems Librarian doran@uta.edu

New Books search results

Michael Doran, Systems Librarian doran@uta.edu

Link into WebVoyáge record

Michael Doran, Systems Librarian doran@uta.edu

New Books search results

Michael Doran, Systems Librarian doran@uta.edu

Why implement it?

Provides a useful service Easy to install Fully automated Maintenance-free after initial setup Integrates into WebVoyáge Many built-in configuration options Open source software, so it’s customizable It’s free…

Michael Doran, Systems Librarian doran@uta.edu

Can’t beat free…

Michael Doran, Systems Librarian doran@uta.edu

Can you implement it?

Why not? Over 300 current users, many of them

small and/or special libraries Extensive documentation

Detailed installation instructions Helpful commenting in Perl scripts Website with “About” pages

(Limited) support from developer

Michael Doran, Systems Librarian doran@uta.edu

Can you implement it?

Why not? Over 300 current users, many of them

small and/or special libraries Extensive documentation

Detailed installation instructions Helpful commenting in Perl scripts Website with “About” pages

(Limited) support from developer

Michael Doran, Systems Librarian doran@uta.edu

Installation in a nutshell Download “tarball” and put on server Uncompress/extract files Copy files to proper locations Test newbooks.cgi

works “out of the box” Configure newbooks.pl

To generate your own newbooks.txt Edit configuration parameters in:

newbooks.ini newbooks.English

Set up a cron job to run newbooks.pl (or a “Scheduled Task” on Windows)

Add “New Books” tab via opac.ini

Michael Doran, Systems Librarian doran@uta.edu

Download…

Michael Doran, Systems Librarian doran@uta.edu

Download the “tarball”

Michael Doran, Systems Librarian doran@uta.edu

Uncompress/extract files (on server)rocky: /tmp => gzip -d -c newbooks-6.1.tar.gz | tar xvf -x newbooks-6.1, 0 bytes, 0 tape blocksx newbooks-6.1/CHANGES, 18390 bytes, 36 tape blocksx newbooks-6.1/English-alt.gif, 855 bytes, 2 tape blocksx newbooks-6.1/English.gif, 889 bytes, 2 tape blocksx newbooks-6.1/Finnish.gif, 551 bytes, 2 tape blocksx newbooks-6.1/INSTALL, 14795 bytes, 29 tape blocksx newbooks-6.1/dope.sh, 3512 bytes, 7 tape blocksx newbooks-6.1/README.unicode, 2202 bytes, 5 tape blocksx newbooks-6.1/Swedish.gif, 898 bytes, 2 tape blocksx newbooks-6.1/Welsh.gif, 967 bytes, 2 tape blocksx newbooks-6.1/newbooks.English, 10210 bytes, 20 tape blocksx newbooks-6.1/newbooks.Finnish, 10391 bytes, 21 tape blocksx newbooks-6.1/newbooks.Language, 9350 bytes, 19 tape blocksx newbooks-6.1/newbooks.Swedish, 10280 bytes, 21 tape blocksx newbooks-6.1/newbooks.Welsh, 10465 bytes, 21 tape blocksx newbooks-6.1/newbooks.cgi, 45364 bytes, 89 tape blocksx newbooks-6.1/newbooks.ini, 13972 bytes, 28 tape blocksx newbooks-6.1/newbooks.pl, 27142 bytes, 54 tape blocksx newbooks-6.1/newbooks.txt, 126550 bytes, 248 tape blocksrocky: /tmp =>

Michael Doran, Systems Librarian doran@uta.edu

Uncompress/extract files (on server)rocky: /tmp => gzip -d -c newbooks-6.1.tar.gz | tar xvf -x newbooks-6.1, 0 bytes, 0 tape blocksx newbooks-6.1/CHANGES, 18390 bytes, 36 tape blocksx newbooks-6.1/English-alt.gif, 855 bytes, 2 tape blocksx newbooks-6.1/English.gif, 889 bytes, 2 tape blocksx newbooks-6.1/Finnish.gif, 551 bytes, 2 tape blocksx newbooks-6.1/INSTALL, 14795 bytes, 29 tape blocksx newbooks-6.1/dope.sh, 3512 bytes, 7 tape blocksx newbooks-6.1/README.unicode, 2202 bytes, 5 tape blocksx newbooks-6.1/Swedish.gif, 898 bytes, 2 tape blocksx newbooks-6.1/Welsh.gif, 967 bytes, 2 tape blocksx newbooks-6.1/newbooks.English, 10210 bytes, 20 tape blocksx newbooks-6.1/newbooks.Finnish, 10391 bytes, 21 tape blocksx newbooks-6.1/newbooks.Language, 9350 bytes, 19 tape blocksx newbooks-6.1/newbooks.Swedish, 10280 bytes, 21 tape blocksx newbooks-6.1/newbooks.Welsh, 10465 bytes, 21 tape blocksx newbooks-6.1/newbooks.cgi, 45364 bytes, 89 tape blocksx newbooks-6.1/newbooks.ini, 13972 bytes, 28 tape blocksx newbooks-6.1/newbooks.pl, 27142 bytes, 54 tape blocksx newbooks-6.1/newbooks.txt, 126550 bytes, 248 tape blocksrocky: /tmp =>

Michael Doran, Systems Librarian doran@uta.edu

Perl scripts + a “database”

Main programs (Perl scripts) newbooks.pl => extraction program newbooks.cgi => web interface

Configuration files (also Perl scripts) newbooks.ini newbooks.English (etc…)

Flat-file “database” newbooks.txt

Installation instructions and other help files

Michael Doran, Systems Librarian doran@uta.edu

Version 6.1

Michael Doran, Systems Librarian doran@uta.edu

A quick test of newbooks.cgi

Michael Doran, Systems Librarian doran@uta.edu

Version 6.1

Copy these files to this directory on your WebVoyáge server:

/m1/voyager/xxxdb/webvoyage/cgi-bin/

(your db name, natch)

Michael Doran, Systems Librarian doran@uta.edu

Type New Books URL into browserhttp://your-server.univ.edu/cgi-bin/newbooks.cgi

Michael Doran, Systems Librarian doran@uta.edu

Version 6.1

Copy newbooks.pl to this directory on your Voyager database server:

/m1/voyager/xxxdb/sbin/

(your db name, natch)

Michael Doran, Systems Librarian doran@uta.edu

Edit the newbooks.pl script

Required … Your Oracle read-only username & password Your “xxxdb” database name

Optional … Intervals (weeks or months) Lag time File transfer etc…

Michael Doran, Systems Librarian doran@uta.edu

Version 6.1

Michael Doran, Systems Librarian doran@uta.edu

Configure search interface

Michael Doran, Systems Librarian doran@uta.edu

Configure search interface, cont.

For examples, see:http://rocky.uta.edu/doran/autolist/configexamples.html

Michael Doran, Systems Librarian doran@uta.edu

Version 6.1

Michael Doran, Systems Librarian doran@uta.edu

The “New Books” tab

http://your-server.univ.edu/cgi-bin/newbooks.cgihttp://your-server.univ.edu/cgi-bin/Pwebrecon.cgi

Michael Doran, Systems Librarian doran@uta.edu

Version 6.1Add extra HTML code to “Tab_Text=Course Reserves”

in the Course_Reserve_Search_Page stanza

A tip o’ the hat toAlan Keely

Michael Doran, Systems Librarian doran@uta.edu

Common installation pitfalls newbooks.pl script

Finding the DBI/DBD modules Solution: using the right Perl path Run the “dope.sh” script to troubleshoot

Transfer of newbooks.txt file Small libraries usually don’t have this problem

because they have a single Voyager server Not (really) a New Books List script issue

newbooks.ini configuration file Location matching “fragments”

Look at how others have done it (view source)

Michael Doran, Systems Librarian doran@uta.edu

Prerequisites

On Voyager database server Perl Perl DBI module Perl DBD::Oracle module

On WebVoyáge server Perl

This stuff is already on your system!

Michael Doran, Systems Librarian doran@uta.edu

What’s a “new” book?

item.create_date between (sysdate - 35) and (sysdate - 7) and(mfhd_master.create_date between (sysdate - 35) and (sysdate - 7) or mfhd_master.update_date between (sysdate - 35) and (sysdate - 7))

SQL query 1 (in newbooks.pl) retrieves physical items

Michael Doran, Systems Librarian doran@uta.edu

What’s a “new” book?

mfhd_master.create_date between (sysdate - 35) and (sysdate - 7) andelink_index.record_type in ('M') and elink_index.link is not null

SQL query 2 (in newbooks.pl) retrieves electronic-only items

For more info see:http://rocky.uta.edu/doran/autolist/secure/sql.htm

Michael Doran, Systems Librarian doran@uta.edu

Installation best practices Read the documentation Make copies of files before editing

For more information...

Go to the New Books List website:

http://rocky.uta.edu/doran/autolist/

Known issues Dupe 856’s => dupe new book listings

Michael Doran, Systems Librarian doran@uta.edu

Questions?