Differences

This shows you the differences between two versions of the page.

--- indexing:dspace [2017/04/21 11:59] – demiankatz
+++ indexing:dspace [2020/09/21 13:50] – [3. Customize Import Rules (optional)] demiankatz
@@ Line 2: / Line 2: @@
 These are the instructions used by the Naval Postgraduate School in Monterey, California to index DSpace records in VuFind.
-:!: ** These instructions were written for VuFind 2.x or newer; See [[legacy:indexing:dspace|this page]] for VuFind 1.x **
 ===== 1. Turn on OAI-PMH in DSpace =====
@@ Line 50: / Line 48: @@
 php harvest_oai.php
 ./batch-import-xsl.sh DSpace dspace.properties</code>
+==== Troubleshooting ====
+If you receive an error message during harvesting, you may need to rebuild the OAI indexes on your DSpace server. Log into that system and run these commands:
+<code>
+<path to dspace directory>/bin/dspace oai clean-cache
+<path to dspace directory>/bin/dspace oai import -c
+</code>
+After that processing completes, retry the harvest process on the VuFind server as described above.
 ===== 3. Customize Import Rules (optional) =====
-If you wish to customize the way your records are ingested, see the [[indexing:xml|indexing XML]] page for details. The instructions above use the example [[https://github.com/vufind-org/vufind/blob/master/import/dspace.properties|dspace.properties]] and [[https://github.com/vufind-org/vufind/blob/master/import/xsl/dspace.xsl|dspace.xsl]] files that ship with VuFind. You can modify these as needed to change the way data is indexed.
+If you wish to customize the way your records are ingested, see the [[indexing:xml|indexing XML]] page for details. The instructions above use the example [[https://github.com/vufind-org/vufind/blob/dev/import/dspace.properties|dspace.properties]] and [[https://github.com/vufind-org/vufind/blob/dev/import/xsl/dspace.xsl|dspace.xsl]] files that ship with VuFind. You can modify these as needed to change the way data is indexed.
 :!: If you change import rules, note that you will need to remove your $VUFIND_LOCAL_DIR/harvest/DSpace directory, re-harvest the records, and repeat the indexing process in step 2 above.
+===== 4. Customize Record Display (optional) =====
+By default, VuFind does not include any DSpace-specific display logic; records indexed from DSpace are displayed using the standard "SolrDefault" record driver and templates. However, the default import setup marks DSpace records with a record_format value of "dspace" which means that you can create a custom record driver named SolrDspace in order to create custom DSpace-only display options. See [[development:howtos:displaying_a_custom_field|displaying a custom field]] for some examples of record display customization.
 ---- struct data ----
 ----