Skip to content

dartmouth-dltg/aspace_search_modifications

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 

Repository files navigation

WIP: ArchivesSpace Search Modifications

About

An ArchivesSpace plugin which modifies the fullrecord search field(s) to omit additional fields which would pollute the standard keyword search result set. The fullrecord field is the field searched against when doing a keyword search in the staff interface and the PUI.

The default additional fields omitted are

persistent_id
ref
uri

Consider also omitting the following fields:

ead_id
ead_location

You may also want to consider removing any _resolved data. This will narrow search results to only data contained within the object itself. Note that this will not return results for agents linked to the object, so if you searched for an agent's name, you would only get that agent record, unless the agent's name was mentioned in a note or other field on the object itself.

To compensate for the removal of the ability to search for an object's id by keyword, a new advanced search option is added which allows a staff user to search for a specific object id.

Installation

Install as you normally would. Add aspace_search_modifications to AppConfig[:plugins] in your configuration.

The plugin does not have any additional dependencies so you do not need to run the initialize-plugin script.

There is one optional configuration option which allows you to set your own list of fields to exclude from the fullrecord field. For example, if you wanted to exclude the default fields provided by the plugin as well as omit the ead_id from the fullrecord for an object:

AppConfig[:aspace_search_modification_excludes] = [
    "ead_id",
    "persistent_id",
    "ref",
    "uri"
]

If you add additional excluded fields, consider adding additional advanced search options if your users may want to search on information found in the excluded fields. See the search_definitions file in this plugin for an example.

A reindex is required to fully benefit from these changes, though this can be a soft reindex. See the ArchivesSpace Tech Docs.

Compatibility

Compatible with ArchivesSpace v3.3.1 - 3.5.0. The plugin may work with earlier 3.x versions but has not been tested.

Core Overrides

Two core methods are patched in this plugin. If you are patching these in other plugins, you will need to reconcile the two.

IndexerCommon::extract_string_values (if using v3.3.1 or lower)
IndexerCommonConfig::fullrecord_excludes (v3.4.0+)

Credits

Plugin developed by Joshua Shaw [[email protected]], Digital Library Technologies Group Dartmouth Library, Dartmouth College

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages