Page History
...
If you want to know more about the DataCite Schema, have a look at the documentation. If you change this file in a way that is not compatible with the DataCite schema, you won't be able to reserve and register DOIs anymore. Do not change anything if you're not sure what you're doing.
Identifier Service
...
To get the XML on which the XSLT processor will start, use the following command:
Code Block | ||
---|---|---|
| ||
[dspace]/ |
...
After removing the comment signs the file should look something like this (I removed the comments to make the listing shorter):
...
bin/dspace dsrun org.dspace.content.crosswalk.XSLTDisseminationCrosswalk dim 123456789/3 |
To get the XML that will be send to DataCite replace 'dim' with 'DataCite'. If the DOI is not stored in the metadata, DSpace will add it automatically as identifier. So don't worry if the XML produced by this command does not contain the DOI. Once the DOI is stored in the metadata, it should also be contained in the XML.
Identifier Service
The Identifier Service manages the generation, reservation and registration of identifiers within DSpace. You can configure it using the config file located in [dspace
...
]/config/spring/api/identifier-service.xml. In the file you should already find the code to configure DSpace to register DOIs. Just read the comments and remove the comment signs around the two appropriate beans.
After removing the comment signs the file should look something like this (I removed the comments to make the listing shorter):
Code Block | ||
---|---|---|
| ||
<!--
Copyright (c) 2002-2010, DuraSpace. All rights reserved
Licensed under the DuraSpace License.
A copy of the DuraSpace License has been included in this
distribution and is available at: http://www.dspace.org/license
-->
<beans xmlns="http://www.springframework.org/schema/beans | <!-- Copyright (c) 2002-2010, DuraSpace. All rights reserved Licensed under the DuraSpace License. A copy of the DuraSpace License has been included in this distribution and is available at: http://www.dspace.org/license --> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd"> <bean id="org.dspace.identifier.IdentifierService" classxmlns:xsi="org.dspace.identifier.IdentifierServiceImplhttp://www.w3.org/2001/XMLSchema-instance" autowire="byType"xsi:schemaLocation="http://www.springframework.org/schema/beans scope="singleton"/ http://www.springframework.org/schema/beans/spring-beans-2.5.xsd"> <bean id="org.dspace.identifier.service.DOIIdentifierProviderIdentifierService" class="org.dspace.identifier.DOIIdentifierProviderIdentifierServiceImpl" scopeautowire="singletonbyType"> <property namescope="configurationServicesingleton"/> <bean id="org.dspace.identifier.DOIIdentifierProvider" class="org.dspace.identifier.DOIIdentifierProvider" scope="singleton"> <property name="configurationService" ref="org.dspace.services.ConfigurationService" /> <property name="DOIConnector" ref="org.dspace.identifier.doi.DOIConnector" /> </bean> <bean id="org.dspace.identifier.doi.DOIConnector" class="org.dspace.identifier.doi.DataCiteConnector" scope="singleton"> <property name='DATACITE_SCHEME' value='https'/> <property name='DATACITE_HOST' value='mds.test.datacite.org'/> <property name='DATACITE_DOI_PATH' value='/doi/' /> <property name='DATACITE_METADATA_PATH' value='/metadata/' /> <property name='disseminationCrosswalkName' value="DataCite" /> </bean> </beans> |
...
Please pay attention to configure the property DATACITE_HOST. Per default it is set to the DataCite test server. To reserve real DOIs you will have to change it to mds.datacite.org. Ask your registration agency if you're not sure about the correct address.
Sending metadata updates to DataCite
DSpace should send updates to DataCite whenever the metadata of an item changes. To do so, you have to change the dspace.cfg againmust enable the DOIConsumer in your dspace.cfg (or local.cfg. You should remove the comments in front of the two following properties or add them to the dspacelocal.cfg:
Code Block | ||
---|---|---|
| ||
event.consumer.doi.class = org.dspace.identifier.doi.DOIConsumer event.consumer.doi.filters = Item+Modify_Metadata |
...
If you want DSpace to support other registration agencies, you just have to write a Java class that implements the interface DOIConnector ([dspace-source]/dspace-api/src/main/java/org/dspace/identifier/doi/DOIConnector.java). You might use the DataCiteConnector ([dspace-source]/dspace-api/src/main/java/org/dspace/identifier/doi/DataCiteConnector.java) as an example. After developing your own DOIConnector, you configure DSpace as if you were using the DataCite API directly. Just use your DOIConnector when configuring the IdentifierService instead of the DataCiteConnector.own DOIConnector, you configure DSpace as if you were using the DataCite API directly. Just use your DOIConnector when configuring the IdentifierService instead of the DataCiteConnector.
Configuring pre-registration of Identifiers
Why mint in submission?
Users often want to see what DOI they will get so they can alter their PDF, coverpage, other metadata, and so on.
This feature should ensure that users can see their future DOI, and if necessary, a warning that if certain conditions are not met, the DOI will not be registered after approval.
Keeping a DOI in pending status does use up an integer from the total DOI namespace, but it also ensures that the submitter, reviewers, administrators etc know what the DOI will be if it is ever registered in the future.
If this is really not desired, eg. there are many item types which should never get a DOI, then there is a way to configure a filter that avoids minting a new PENDING DOI at all unless conditions are met in submission.
Enable the Identifiers step
See Submission User Interface#Configuringthe%22Identifiers%22step
Configure filters and behaviour
To enable this feature and configure the exact way it works, edit the ${dspace.dir}/dspace/modules/identifiers.cfg
configuration file
Property: |
|
Example Value: |
|
Informational Note: | Enable this feature. Default: false. Handles will be registered at time of submission. DOIs (if item filters evaluate to true) will be minted in a "pending" state for items, to be registered or queued for registration at archival. |
Property: |
|
Example Value: |
|
Informational Note: | Bean ID of a logical item filter (see (If a filter is absent or null, an item will always be evaluated as 'true') |
Property: |
|
Example Value: |
|
Informational note | Bean ID of a logical item filter (see Depending on the value of Default: always_true_filter (If a filter is absent or null, an item will always be evaluated as 'true') |
Property: | identifiers.submission.strip_pending_during_submission |
Example Value: |
|
Informational Note: | If, during workspace item changes, the workspace filter no longer evaluates to true, should any DOIs be stripped? (moved to MINTED or DELETED status) This is useful in situations where the submitter needs real-time feedback as to whether their item qualifies for a DOI. |
Property: | identifiers.item-status.register-doi |
Example Value: |
|
Informational Note: | Allow administrators to queue DOIs for registration in the Item Status page. Default: false. Important: This configuration property must be set, even if it matches the default, as it is exposed as a REST configuration property to the frontend. |
Administrator registration
If an item does not have a DOI at all, or if an item has a MINTED or PENDING DOI, a user with ADMIN rights over the item may queue the DOI registration from the Item Status page. No filters will be applied to this action. This requires identifiers.item-status.register-doi
to be true
in identifiers configuration (see above)