The New Books List Michael Doran, Systems Librarian Ex Libris Southwest Users Group February 6, 2008 – Santa Ana College

Michael Doran, Systems Librarian An unofficial WebVoyáge add-on

Michael Doran, Systems Librarian The “New Books” tab

Michael Doran, Systems Librarian New Books search results

Michael Doran, Systems Librarian Link into WebVoyáge record

Michael Doran, Systems Librarian New Books search results

Michael Doran, Systems Librarian 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 Can’t beat free…

Michael Doran, Systems Librarian Can you implement it? Why not?  Over 300 current users, many of them small and/or special librariescurrent users  Extensive documentation Detailed installation instructions Helpful commenting in Perl scripts Website with “About” pagesAbout  (Limited) support from developer

Michael Doran, Systems Librarian 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 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 Download…

Michael Doran, Systems Librarian Download the “tarball”

Michael Doran, Systems Librarian 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 blocks x newbooks-6.1/CHANGES, bytes, 36 tape blocks x newbooks-6.1/English-alt.gif, 855 bytes, 2 tape blocks x newbooks-6.1/English.gif, 889 bytes, 2 tape blocks x newbooks-6.1/Finnish.gif, 551 bytes, 2 tape blocks x newbooks-6.1/INSTALL, bytes, 29 tape blocks x newbooks-6.1/dope.sh, 3512 bytes, 7 tape blocks x newbooks-6.1/README.unicode, 2202 bytes, 5 tape blocks x newbooks-6.1/Swedish.gif, 898 bytes, 2 tape blocks x newbooks-6.1/Welsh.gif, 967 bytes, 2 tape blocks x newbooks-6.1/newbooks.English, bytes, 20 tape blocks x newbooks-6.1/newbooks.Finnish, bytes, 21 tape blocks x newbooks-6.1/newbooks.Language, 9350 bytes, 19 tape blocks x newbooks-6.1/newbooks.Swedish, bytes, 21 tape blocks x newbooks-6.1/newbooks.Welsh, bytes, 21 tape blocks x newbooks-6.1/newbooks.cgi, bytes, 89 tape blocks x newbooks-6.1/newbooks.ini, bytes, 28 tape blocks x newbooks-6.1/newbooks.pl, bytes, 54 tape blocks x newbooks-6.1/newbooks.txt, bytes, 248 tape blocks rocky: /tmp =>

Michael Doran, Systems Librarian 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 blocks x newbooks-6.1/CHANGES, bytes, 36 tape blocks x newbooks-6.1/English-alt.gif, 855 bytes, 2 tape blocks x newbooks-6.1/English.gif, 889 bytes, 2 tape blocks x newbooks-6.1/Finnish.gif, 551 bytes, 2 tape blocks x newbooks-6.1/INSTALL, bytes, 29 tape blocks x newbooks-6.1/dope.sh, 3512 bytes, 7 tape blocks x newbooks-6.1/README.unicode, 2202 bytes, 5 tape blocks x newbooks-6.1/Swedish.gif, 898 bytes, 2 tape blocks x newbooks-6.1/Welsh.gif, 967 bytes, 2 tape blocks x newbooks-6.1/newbooks.English, bytes, 20 tape blocks x newbooks-6.1/newbooks.Finnish, bytes, 21 tape blocks x newbooks-6.1/newbooks.Language, 9350 bytes, 19 tape blocks x newbooks-6.1/newbooks.Swedish, bytes, 21 tape blocks x newbooks-6.1/newbooks.Welsh, bytes, 21 tape blocks x newbooks-6.1/newbooks.cgi, bytes, 89 tape blocks x newbooks-6.1/newbooks.ini, bytes, 28 tape blocks x newbooks-6.1/newbooks.pl, bytes, 54 tape blocks x newbooks-6.1/newbooks.txt, bytes, 248 tape blocks rocky: /tmp =>

Michael Doran, Systems Librarian 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 Version 6.1

Michael Doran, Systems Librarian A quick test of newbooks.cgi

Michael Doran, Systems Librarian 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 Type New Books URL into browser

Michael Doran, Systems Librarian 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 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 Version 6.1

Michael Doran, Systems Librarian Configure search interface

Michael Doran, Systems Librarian Configure search interface, cont. For examples, see:

Michael Doran, Systems Librarian Version 6.1

Michael Doran, Systems Librarian The “New Books” tab

Michael Doran, Systems Librarian Version 6.1 Add extra HTML code to “Tab_Text=Course Reserves” in the Course_Reserve_Search_Page stanza A tip o’ the hat to Alan Keely

Michael Doran, Systems Librarian 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 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 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 What’s a “new” book? mfhd_master.create_date between (sysdate - 35) and (sysdate - 7) and elink_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:

Michael Doran, Systems Librarian Installation best practices Read the documentation Make copies of files before editing For more information... Go to the New Books List website: Known issues Dupe 856’s => dupe new book listings

Michael Doran, Systems Librarian Questions?