1 About this document

Author

Corey Wallis, RUBRIC Technical Officer

Purpose

This technical report outlines how to use the XML file developed by the RUBRIC project to provide a controlled vocabulary of ASRC subject terms for use with DSpace.

Audience

RUBRIC Project Partners and other users of DSpace

Requirements

A running instance of DSpace 1.4, currently in beta, or DSpace 1.1.x or 1.2.x with the DSpace Ontology Add-on.

References

Official DSpace website:

http://www.dspace.org/

DSpace System Documentation:

http://dspace.org/technology/system-docs/

DSpace Ontology Add-on Documentation:

http://dspace-dev.dsi.uminho.pt:8080/common/ontology-addon-doc.htm

utf-x: Unit Testing Framework for XSLT:

http://utf-x.sourceforge.net/

Official Subversion website:

http://subversion.tigris.org/

Notes

The RUBRIC ASRC subject codes XML file has only be tested using DSpace 1.4 alpha. The file should be compatible with the DSpace Ontology Add-on, although this has not been tested.

Before using the ASRC subject codes it is necessary to contact the Australian Bureau of Statistics for permission to use the classification scheme.

2 Background Information

The ASRC subject terms XML file is really a list of the Research Fields, Courses and Disciplines (RFCD) classification. These classifications are used extensively by Australian institutional repositories and are known by the more generic term of ASRC subject headings.

During the investigation phase undertaken by the RUBRIC project it was found to be a requirement of our project partners that these subject headings be available in a DSpace based repository. Upon investigation it was determined that the DSpace Ontology Add-on could provide this functionality and that the add-on had been integrated into the DSpace 1.4 code base.

During the investigation into the add-on it was determined that moving to the 1.4 code base would provide a number of fixes to other issues that we were experiencing. The decision was made to move to DSpace version 1.4 alpha to provide this functionality to our project partners and resolve the other minor issues we were experiencing.

To create an XML file for use with DSpace it was necessary to use an XSL transformation. The source XML file was kindly provided by the National Library of Australia. Using a unit testing approach, leveraging the functionality of the utf-x test suite, an XSL transformation was developed. The result of the transformation can be downloaded, as well as all of the development related files. Details of the process to download the files is outlined in the following section.

3 Downloading the ASRC Subject Codes for DSpace

The data migration programs, and associated files such as the ASRC subject codes for DSpace are made available via a publicly accessibly website at the following URL.

https://rubric-central.usq.edu.au/svn/Public/code/

It is possible to download files from this website using a subversion client.

3.1 Downloading the subject code XML file

The ASRC subject code file is available from the following URL:

https://rubric-central.usq.edu.au/svn/Public/code/legacy_code/asrc-for-dspace/asrc-for-dspace.xml

The file is complete and is ready to be used with the DSpace Ontology Add-on, or with DSpace version 1.4.

3.2 Download the files using subversion

If you have the subversion client installed on your system you can check out the files used to create the ASRC subject code XML file. The URL you will need to check out is as follows:

https://rubric-central.usq.edu.au/svn/Public/code/legacy_code/asrc-for-dspace/xsl/

4 Details of the development files

The files used in the development of the ASRC subject code XML file are available as a tar.gz file, see section 3.1, or via subversion, see section 3.2. The development files are are as follows.

xsl/ASRC.xml

A copy of the ASRC subject code XML file

xsl/ASRCList-Full.xml

A copy of the original source XML file kindly provided by the NLA

xsl/asrc_for_dspace.xsl

The XSL used to transform the XML file provided by the NLA into the ASRC subject code XML file ready for use with the DSpace Ontology Add-on or DSpace version 1.4

xsl/controlledvocabulary.xsd

An XML schema document which defines the schema that all XML files that are to be used with the DSpace Ontology Add-on must adhere to.

xsl/test/asrc_for_dspace_test.xml

An XML file defining the tests used with the utf-x test suite during the development of the asrc_for_dspace.xsl file.

5 Using the ASRC Subject Codes for DSpace

5.1 Using the ASRC Subject Codes with DSpace version 1.4

At the time of writing DSpace version 1.4 was still in development. Details of how to enable the functionality, known as controlled vocabularies in DSpace version 1.4 is in the configure.html file in the docs directory of the source package.

Alternatively the file was available via the following URL at the time of writing:

http://dspace.cvs.sourceforge.net/*checkout*/dspace/dspace/docs/configure.html#controlledvocabulary

5.2 Using the ASRC Subject Codes with the Ontology Add-on

Documentation for the use of the Ontology Add-on is available from the developers website at the following URL:

http://dspace-dev.dsi.uminho.pt:8080/common/ontology-addon-doc.htm