Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Enhanced / cleaned up PubMed docs

...

Then create a spring configuration file in [dspace.dir]/config/spring/api.

Each DSpace metadata field that will be used for the mapping must first be configured as a spring bean of classorg.dspace.importer.external.metadatamapping.MetadataFieldConfig.

...

 

Note that the single field mappings used for the combined author mapping are not added to this list.

 

Framework Sources Implementations

Pubmed

PubMed Integration

Introduction

First read the base documentation on external importing This documentation explains the implementation of the importer framework using PubMed (http://www.ncbi.nlm.nih.gov/pubmed) as an example.

The configuration done for pubmed PubMed specifically is located at pubmed-integration.xml in dspace [dspace.dir]/config/spring/api/pubmed-integration.xml I will not go into detail to what exactly is configured for the pubmed integration as it is simply a usage of the classes explained here

Enabling

pubmed

PubMed Lookup (XMLUI Only)

The pubmed PubMed specific integration of the external sources import requires the following to be active.
The pubmed PubMed lookup is done during the "XMLUIStartSubmissionLookupStep" and this can be enabled by adjusting 1 one step in the [dspace.dir]/config/item-submission.xml
. Uncommenting this step will permit the user to do the pubmed PubMed based lookups during their submission.

 

Code Block
titleitem-submission.xml
<!-- Find publications based on ID/DOI/Title/Author to pre-fill the submission. XMLUI ONLY.
     For JSPUI version, see JSPUIStartSubmissionLookupStep under <step-definitions> above.
<step>
    <heading>submit.progressbar.lookup</heading>
    <processing-class>org.dspace.submit.step.XMLUIStartSubmissionLookupStep</processing-class>
    <jspui-binding>org.dspace.app.webui.submit.step.JSPStartSubmissionLookupStep</jspui-binding>
    <xmlui-binding>org.dspace.app.xmlui.aspect.submission.submit.StartSubmissionLookupStep</xmlui-binding>
    <workflow-editable>true</workflow-editable>
</step>
 -->

 

 
Additional Config

After uncommenting hat step, simply restart your servlet container, and this lookup step will be available within your deposit process.

Publication Lookup URL

To be able to do the lookup for our configured import-service, we need to be able to know what url URL to use to check for publications. This can be done by setting the publication.url property though maven using 2 different ways.  This URL the publication-lookup.url setting defined within the [dspace.dir]/config/modules/publication-lookup.cfg.  You may choose to modify this setting or override it within your local.cfg.

This setting can be modified in one of two ways:

  • You can choose to specific a single, specific URL. This will tell the lookup service to only use one location to lookup publication information.  Valid URLs are any that are defined as a baseAddress for beans within the [src]/dspace-api/src/main/resources/spring/Setting the publication.url property to the address as defined in the configured importservice (PubmedImportService in this case) in the file spring-dspace-addon-import-services.xml. This will check this single configured url for publications.
  • Setting the publication url property to an askterisk '*'. This will check all configured importServices for their urls to base the search for publications on.
Pubmed
  • Spring config file.
  • By default, publication-lookup.url is set to an asterisk ('*').  This default value will attempt to lookup the publication using ALL configured importServices in the [src]/dspace-api/src/main/resources/spring/spring-dspace-addon-import-services.xml Spring config file

 

PubMed Metadata Mapping

The PubMed metadata mappings are defined in the [dspace.dir]/config/spring/api/pubmed-integration.xml Spring configuration file.  These metadata mappings can be tweaked as desired. The format of this file is described in the "Metadata mapping" section above

PubMed specific classes Config

These classes are simply implementations based of the base classes defined in importer/external. They add characteristic behaviour behavior for services/mapping for the pubmed PubMed specific data.

Metadata mapping classes

  • "PubmedFieldMapping". An implementation of AbstractMetadataFieldMapping, linking to the bean that serves as the entry point of other metadata mapping
  • "PubmedDateMetadatumContributor"/"PubmedLanguageMetadatumContributor". Pubmed specific implementations of the "MetadataContributor" interface

Service classes

...