All Versions
- DSpace 7.x (Current Release)
- DSpace 8.x (Unreleased)
- DSpace 6.x (EOL)
- DSpace 5.x (EOL)
- More Versions...
...
This documentation explains the features and the usage of the importer framework.
Enabling the framework can be achieved by uncommenting the following step in item-submission.xml
.
Implementation specific or additional configuration can be found in their related documentation, if any.
Please refer to subdivisions of this documentation for specific implementations of the framework.
Code Block | ||||
---|---|---|---|---|
| ||||
<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> |
...
Note that the single field mappings used for the combined author mapping are not added to this list.
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 specifically is located at [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
[dspace.dir]/config/item-submission.xml.
Uncommenting this step will permit the user to do the PubMed based lookups during their submission.
Code Block | ||
---|---|---|
| ||
<!-- 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> <xmlui-binding>org.dspace.app.xmlui.aspect.submission.submit.StartSubmissionLookupStep</xmlui-binding> <workflow-editable>true</workflow-editable> </step> --> |
After uncommenting hat step, simply restart your servlet container, and this lookup step will be available within your deposit process.
To be able to do the lookup for our configured import-service, we need to be able to know what URL to use to check for publications. 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:
baseAddress
for beans within the [src]/dspace-api/src/main/resources/spring/spring-dspace-addon-import-services.xml
Spring config file.publication-lookup.url=http://eutils.ncbi.nlm.nih.gov/entrez/eutils/
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
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
These classes are simply implementations based of the base classes defined in importer/external. They add characteristic behavior for services/mapping for the PubMed specific data.
...