Tech Blog

WebVoyage TomCat RefMan (RIS) format export

  • DescriptionAllows export of records from catalogue in RefMan (RIS) format – works with EndNote and other bibliographic managers, including Zotero .
  • Author: Tom Pasley
  • Institution:
  • Universal College of Learning
  • Year: 2010
  • License: BSD style
  • Short description: Use, modification and distribution of the code are permitted provided the copyright notice, list of conditions and disclaimer appear in all related material.
  • Link to terms: Detailed license terms
  • Skill required for using this code:
    Intermediate

State

Generally stable, but in late development stages.

Programming language

XSL

Software requirements

WebVoyage Tomcat 7.0.4+

Author(s) email

t.pasley@nospam.ucol.ac.nz

Download

Attach the code file(s) to this page and link to them here.
Page attachments management can be reached from the top-right menu – ‘attachments’ after page save.

Working example

http://libcat.ucol.ac.nz/vwebv/exportRecord.do?bibId=47556&format=RIS

Original release

12 April 2010

There will be gunge that comes through from the original MaRC cataloguing:

CY  – Auckland NZ :
PB  – Random House,
PY  – 2003.

– but I’m not sure what can be done about this, as we don’t want to routinely delete that last two or three characters!

Release notes

12 April 2010

Installation is not as tidy as I’d like, but hopefully not too hard.

Installation instructions

Follow the order listed below…

Backup and edit the /xsl/userTextConfigs/pageProperties for your skin, and add a RefMan reference type attribute, (risformat=”*REFTYPE), for each node under the *bibFormats. Use a reference type code which complies with the RIS format specification :

<!-- ## This section defines the text and the icon to use (for results list icons) for bibFormat ## -->
   <bibFormats>
      <bibFormat type="aa" icon="icon_book.gif" risformat="BOOK">Book</bibFormat>
      <bibFormat type="ab" icon="icon_article.gif" risformat="GEN">Article/Pamphlet</bibFormat>
      <bibFormat type="ac" icon="icon_pamphlet.gif" risformat="BOOK">Book</bibFormat>
      <bibFormat type="ad" icon="icon_book.gif" risformat="BOOK">Book</bibFormat>
      <bibFormat type="am" icon="icon_book.gif" risformat="BOOK">Book</bibFormat>
      <bibFormat type="as" icon="icon_serial.gif" risformat="SER">Serial</bibFormat>

A list of reference type codes can be found at: http://www.refman.com/support/risformat_reftypes.asp

Edit display_RIS.xsl and change libcat.ucol.ac.nz (around lines 62 and 115 in the files) to your Voyager system’s URL.

Copy across the files to your server:

/xsl/exportFormats/RIS.xsl

/xsl/contentLayout/configs/export/RISConfig.xml

/xsl/contentLayout/configs/export/RISConfigHoldings.xml

/xsl/contentLayout/display/display_RIS.xsl

Backup and edit /holdingsInfo.vbib.properties and add the line: export.format.RIS=RIS.xsl

\#=========================================================================
\# XSL templates to use for each export format.

\# The format name (X in export.format.X) must match exactly the format  name
\# in webvoyage.properties.

\# Note for the export formats Latin1, Raw and UTF-8 there is no xsl file
\#=========================================================================

export.format.RIS=RIS.xsl

Then backup and edit /webvoyage.properties and under this text:

#========================================================================
# Note for the export formats Latin1, Raw and UTF-8 there is no xsl file
#======================================================================

at some suitable place add these lines (but make sure the order does not clash!)

page.exportDialog.format.RIS.label=RefMan export (RIS)
page.exportDialog.format.RIS.order=6

Page Attachments

File NameCommentSizeNumber of Downloads
RISConfigHoldings.xmlplace in l\xsl\contentLayout\configs\export\4 kB257
RIS.xslplace in \xsl\exportFormats\2 kB274
display_RIS.xslplace in \xsl\contentLayout\display\36 kB222
RISConfig.xmlplace in l\xsl\contentLayout\configs\export\11 kB315

 

Leave a Reply