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

2. doran@uta.edu Michael Doran, Systems Librarian An unofficial WebVoyáge add-on

3. doran@uta.edu Michael Doran, Systems Librarian The “New Books” tab

4. doran@uta.edu Michael Doran, Systems Librarian New Books search results

5. doran@uta.edu Michael Doran, Systems Librarian Link into WebVoyáge record

6. doran@uta.edu Michael Doran, Systems Librarian New Books search results

7. doran@uta.edu 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…

8. doran@uta.edu Michael Doran, Systems Librarian Can’t beat free…

9. doran@uta.edu 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

10. doran@uta.edu 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

11. doran@uta.edu 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

12. doran@uta.edu Michael Doran, Systems Librarian Download…

13. doran@uta.edu Michael Doran, Systems Librarian Download the “tarball”

14. doran@uta.edu 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, 18390 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, 14795 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, 10210 bytes, 20 tape blocks x newbooks-6.1/newbooks.Finnish, 10391 bytes, 21 tape blocks x newbooks-6.1/newbooks.Language, 9350 bytes, 19 tape blocks x newbooks-6.1/newbooks.Swedish, 10280 bytes, 21 tape blocks x newbooks-6.1/newbooks.Welsh, 10465 bytes, 21 tape blocks x newbooks-6.1/newbooks.cgi, 45364 bytes, 89 tape blocks x newbooks-6.1/newbooks.ini, 13972 bytes, 28 tape blocks x newbooks-6.1/newbooks.pl, 27142 bytes, 54 tape blocks x newbooks-6.1/newbooks.txt, 126550 bytes, 248 tape blocks rocky: /tmp =>

15. doran@uta.edu 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, 18390 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, 14795 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, 10210 bytes, 20 tape blocks x newbooks-6.1/newbooks.Finnish, 10391 bytes, 21 tape blocks x newbooks-6.1/newbooks.Language, 9350 bytes, 19 tape blocks x newbooks-6.1/newbooks.Swedish, 10280 bytes, 21 tape blocks x newbooks-6.1/newbooks.Welsh, 10465 bytes, 21 tape blocks x newbooks-6.1/newbooks.cgi, 45364 bytes, 89 tape blocks x newbooks-6.1/newbooks.ini, 13972 bytes, 28 tape blocks x newbooks-6.1/newbooks.pl, 27142 bytes, 54 tape blocks x newbooks-6.1/newbooks.txt, 126550 bytes, 248 tape blocks rocky: /tmp =>

16. doran@uta.edu 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

17. doran@uta.edu Michael Doran, Systems Librarian Version 6.1

18. doran@uta.edu Michael Doran, Systems Librarian A quick test of newbooks.cgi

19. doran@uta.edu 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)

20. doran@uta.edu Michael Doran, Systems Librarian Type New Books URL into browser http://your-server.univ.edu/cgi-bin/newbooks.cgi

21. doran@uta.edu 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)

22. doran@uta.edu 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…

23. doran@uta.edu Michael Doran, Systems Librarian Version 6.1

24. doran@uta.edu Michael Doran, Systems Librarian Configure search interface

25. doran@uta.edu Michael Doran, Systems Librarian Configure search interface, cont. For examples, see: http://rocky.uta.edu/doran/autolist/configexamples.html

26. doran@uta.edu Michael Doran, Systems Librarian Version 6.1

27. doran@uta.edu Michael Doran, Systems Librarian The “New Books” tab http://your-server.univ.edu/cgi-bin/newbooks.cgihttp://your-server.univ.edu/cgi-bin/Pwebrecon.cgi

28. doran@uta.edu 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

29. doran@uta.edu 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)

30. doran@uta.edu 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!

31. doran@uta.edu 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

32. doran@uta.edu 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: http://rocky.uta.edu/doran/autolist/secure/sql.htm

33. doran@uta.edu 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: http://rocky.uta.edu/doran/autolist/ Known issues Dupe 856’s => dupe new book listings

34. doran@uta.edu Michael Doran, Systems Librarian Questions?