All Versions
- DSpace 7.x (Current Release)
- DSpace 8.x (Unreleased)
- DSpace 6.x (EOL)
- DSpace 5.x (EOL)
- More Versions...
...
Code Block | ||||
---|---|---|---|---|
| ||||
<step id="collection"> <heading></heading> <!--can specify heading, if you want it to appear in Progress Bar--> <processing-class>org.dspace.submit.step.StartSubmissionLookupStep</processing-class> <jspui-binding>org.dspace.app.webui.submit.step.JSPStartSubmissionLookupStep</jspui-binding> <xmlui-binding>org.dspace.app.xmlui.aspect.submission.submit.SelectCollectionStep</xmlui-binding> <workflow-editable>false</workflow-editable> </step> |
...
There are four accordion tabs (default configuration hide hides the third tab):
1) Search for identifier: In this tab, the user can search for an identifier in the supported online services (currently, arXiv, PubMed, CrossRef and CrossRef CiNii are supported). The publication results are presented in the tab "Results" in which the user can select the publication to proceed with. This means that a new submission form will be initiated with the form fields prefilled with metadata from the selected publication.
Currently, there are three four identifiers that are supported (DOI, PubMed ID, arXiv ID and arXiv NAID (CiNii ID) ). But these can be extended - refer to the following paragraph regarding the SubmissionLookup service configuration file.
User can fill in any of the three four identifiers. DOI is preferable. Keep in mind that the service can integrate results for the same publication from the three different providers so filling any of the three four identifiers will pretty much do the work. If identifiers for different publications are provided, the service will return a list of publications which will be shown to user to select. The selected publication will make it to the submission form in which some fields will be pre-filled with the publication metadata. The mapping from the input metadata (from arXiv or Pubmed or CrossRef or CiNii) to the DSpace metadata schema (and thus, the submission form) is configured in the Spring XML file that is discussed later on - you can see a table at the very end of this chapter.
Through the same file, a user can also extend the providers that the SubmissionLookup service can search publication from.
2) Upload a file: In this tab, the user can upload a file, select the type (bibtex. scvcsv, etc.), see the publications in the "Results" tab and then either select one to proceed with the submission or make all of them "Workspace Items" that can be found in the "Unfinished Submissions" section in the "My DSpace" page.
...
3) Free search: In this tab, the user can freely search for Title, Author and Year in the three four supported providers (PubMed, CrossRef, Arxiv and ArxivCiNii). By default, the three four providers are configured to be disabled for free search but you can enable it via the configuration file. Thus, initially this accordion tab is not shown to the user except for a data loader is declared as a "search provider" - refer to the following paragraphs.
...
This is the top level bean that describes the service of theSubmissionLookupthe SubmissionLookup. It accepts two three properties:
a) phase1TransformationEngine: the phase 1 BTE transformation engine.
b) phase2TransformationEngine: the phase 2 BTE transformation engine
Code Block | ||
---|---|---|
| ||
<bean id="phase1TransformationEngine" /> |
The transformation engine for the first phase of the service (from external service to intermediate format)
c) detailFields: A list of the keys that the user wants to display in the detailed form of a publication. That is, when the results are shown, user can see the details of each one. In the detailed form, some fields appear. These fields are configured by this property. Refer to the table at the very end of this chapter to see the available values. This property is disabled by default while the list that is shown commented out is the default list for the detailed form.
Code Block | ||
---|---|---|
| ||
<bean id="phase1TransformationEngine" /> |
The transformation engine for the first phase of the service (from external service to intermediate format)
It accepts three properties:
...
Code Block | ||
---|---|---|
| ||
<bean id="bibTeXDataLoader" /> <bean id="csvDataLoader" /> <bean id="tsvDataLoader" /> <bean id="risDataLoader" /> <bean id="endnoteDataLoader" /> <bean id="pubmedFileDataLoader" /> <bean id="arXivFileDataLoader" /> <bean id="crossRefFileDataLoader" /> <bean id="pubmedOnlineDataLoaderciniiFileDataLoader" /> <bean id="pubmedOnlineDataLoader" /> <bean id="arXivOnlineDataLoader" /> <bean id="crossRefOnlineDataLoader" /> <bean id="ciniiOnlineDataLoader" /> |
These beans are the actual data loaders that are used by the service. They are either "FileDataLoaders" or "SubmissionLookupDataLoaders" as mentioned previously.
...
pubmedOnlineDataLoader, crossRefOnlineDataLoader and , arXivOnlineDataLoader and ciniiOnlineDataLoader also support another property:
a) searchProvider: if is set to true, the dataloader supports free search by title, author or year. If at least one of these data loaders is declared as a search provider, the accordion tab "Free search" is appeared. Otherwise, it stays hidden.
crossRefOnlineDataLoader and ciniiOnlineDataLoader also have two more properties:
a) apiKey/appId respectively: Both these services need to acquire (for free) an API key in order to access their online services. For CrossRef, visit: http://www.crossref.org/requestaccount/ and for CiNii visit: https://portaltools.nii.ac.jp/developer/en/
b) maxResults: the maximum results that these services will reply with to your search. By default, this property is commented out while the default value is 10 for both services.
(Regarding the file dataloaders, you can find the attached file named "sample-files.zip" that contains samples of all the file types that the corresponding data loaders can (Regarding the pubmed, crossref and arxiv file dataloaders, you can find the attached file named "sample-files.zip" that contains samples of the three file types that the corresponding data loaders can handle)
Code Block | ||
---|---|---|
| ||
<bean id="phase1LinearWorkflow" /> |
...
The following table presents the available keys from the online services, the keys that BTE uses in phase1 and the final output map to DSpace metadata fields.
Arxiv | PubMed | CrossRef | CiNii | BTE Key (phase 1) | Extra Keys created by BTE (phase 2) | DSpace Metadata Field | Appears in Detail Form | |
---|---|---|---|---|---|---|---|---|
title | articleTitle | articleTitle | title | title | dc.title | yes | ||
published | pubDate | year | issued | issued | dc.date.issued | yes | ||
id | url | |||||||
summary | abstractText | description | abstract | dc.description.abstract | yes | |||
comment | note | |||||||
pdfUrl | fulltextUrl | |||||||
doi | doi | doi | doi | dc.identifier | yes | |||
journalRef | journalTitle | journalTitle | journal | journal | dc.source | yes | ||
author | author | authors | authors | authors | dc.contributor.author | yes | ||
authorWithAffiliation | authorsWithAffiliation | |||||||
primaryCategory | arxivCategory | dc.subject | yes | |||||
category | arxivCategory | dc.subject | ||||||
pubmedID | pubmedID | |||||||
publicationStatus | publicationStatus | |||||||
pubModel | ||||||||
printISSN | printISSN | issn | jissn | dc.identifier.issn | yes | |||
electronicISSN | electronicISSN | jeissn | ||||||
journalVolume | volume | volume | volume | |||||
journalIssue | issue | issue | issue | |||||
language | language | language | dc.language.iso | yes | ||||
publicationType | doiType | subtype | dc.type | yes | ||||
primaryKeyword | subjects | keywords | allkeywords | dc.subject | yes | |||
secondaryKeyword | keywords | allkeywords | dc.subject | yes | ||||
primaryMeshHeading | mesh | allkeywords | dc.subject | yes | ||||
secondaryMeshHeading | mesh | allkeywords | dc.subject | yes | ||||
startPage | firstPage | spage | firstpage | |||||
endPage | lastPage | epage | lastpage | |||||
printISBN | pisbn | dc.identifier.isbn | yes | |||||
electronicISBN | eisbn | |||||||
editionNumber | editionnumber | |||||||
seriesTitle | seriestitle | |||||||
volumeTitle | volumetitle | |||||||
publicationType | ||||||||
editors | editors | dc.contributor.editor | yes | |||||
translators | translators | dc.contributor.other | yes | |||||
chairs | chairs | dc.contributor.other | yes | |||||
naid | naid | |||||||
ncid | ncid | |||||||
keywords | publisher | publisher | dc.publisher | yes |
Info | ||
---|---|---|
| ||
The configuration file hosts options for two services. BatchImport service and SubmissionLookup service. Thus, some beans that are not used in the first service, are not mentioned in this documentation. However, since both services are based on the BTE, some beans are used by both services. |
...