Table of Contents
minLevel 2 outline true style none

Introduction

The contribution referenced at https://jira.duraspace.org/browse/DS-2877 contains search features for the submission system, allowing submitters to search ScienceDirect and retrieve metadata, abstracts, DOI-links and embargo metadata on the article level. This integration is based on the framework from https://jira.duraspace.org/browse/DS-2876.
In addition to the search and retrieval per article, a similar feature is available for a batch import of multiple ScienceDirect records at once.

...

API keys can be obtained from integrationsupport@elsevier.com after acceptance of the terms and conditions of the program (no cost applicable).

Enabling or Disabling the features

Live import

The live import should be enabled in the dspace/config/item-submission.xml. The step below should be included prior to the Describe metadata steps:

<step>
<heading>submit.progressbar.liveimport</heading>
<processing-class>com.atmire.submit.step.LiveImportStep</processing-class>
<jspui-binding>org.dspace.app.webui.submit.step.JSPStartSubmissionLookupStep</jspui-binding>
<xmlui-binding>com.atmire.app.xmlui.aspect.submission.submit.LiveImportStep</xmlui-binding>
<workflow-editable>true</workflow-editable>
</step>

File permissions in the upload step

The automatic suggestion of the file permissions should be enabled in the dspace/config/item-submission.xml. The step below should replace the default upload step:

<step>
<heading>submit.progressbar.upload</heading>
<processing-class>com.atmire.dspace.submit.step.ElsevierUploadStep</processing-class>
<xmlui-binding>com.atmire.dspace.app.xmlui.aspect.submission.submit.ElsevierUploadStep</xmlui-binding>
<workflow-editable>true</workflow-editable>
</step>

Link to the ScienceDirect page

The display of the link to the ScienceDirect page can be enabled in the theme. The automatic verification whether the user is entitled to download the file can be enabled in dspace/config/modules/elsevier-sciencedirect.cfg using the parameter:

entitlement.check.enabled

Embedding the article PDF

The display of the embedded article PDF can be enabled in dspace/config/modules/elsevier-sciencedirect.cfg using the parameter:

embed.display

Plugin for the Search API

Configuration

The basic API configuration can be found in file dspace/config/modules/elsevier-sciencedirect.cfg. This file contains the API key and the API urls.

...

api.key = 7f8c0…
api.article.url=http://api.elsevier.com/content/article
api.entitlement.url=http://api.elsevier.com/content/article/entitlement
api.scidir.url=http://api.elsevier.com/content/search/scidir

Mapping

The file dspace/config/spring/api/scidir-service.xml contains the spring configuration for the beans used by the Elsevier service.

Part of this configuration is the mapping of Science Direct fields to dspace metadata fields.

Configuring the mapping

Each DSpace metadata field that will be used for the mapping must first be configured as a spring bean of class com.atmire.import_citations.configuration.metadatamapping.MetadataField.

...

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

Live import

The first submission step is the Elsevier import step. This step allows the user to import a publication from Elsevier.

...

Note that importing a publication removes any fields that were already added to the item.

Configuration

To enable the Elsevier import step add the step to the submission-process in dspace/config/item-submission.xml.

<step>
<heading>submit.progressbar.liveimport</heading>
<processing-class>com.atmire.submit.step.LiveImportStep</processing-class>
<jspui-binding>org.dspace.app.webui.submit.step.JSPStartSubmissionLookupStep</jspui-binding>
<xmlui-binding>com.atmire.app.xmlui.aspect.submission.submit.LiveImportStep</xmlui-binding>
<workflow-editable>true</workflow-editable>
</step>

Batch import

Import multiple publications from Elsevier using the batch import.

...

A collection to which the items are added must be selected from the "Select collection" dropdown. Click on "Import" to start the import.

File Upload Step

The file upload step has been altered to allow people to select the accessibility of files, it can be restricted from users, placed under embargo so it's not available until a specified date, or simply be made regularly available.

Plugin for the Entitlements check

The check for entitlement can be configured in the ${dspace.dir}/config/modules/elsevier-sciencedirect.cfg.

...

* If the DOI starts with 'DOI:', then that part will be parsed off.

Embedding of the PDFs

The PDF is collected via the pii and shown in an embedded reader.

...