Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: removing reference to DSpace 4

...

(Optional) Request Item with HelpDesk intermediary, is steered towards having your Repository Support staff act as a helpdesk that receives all incoming RequestItem requests, and then processes them. This adds the options of "Initial Reply to Requestor" to let the requestor know that their request is being worked on, and an option "Author Permission Request" which allows the helpdesk to email the author of the document, as not all documents are deposited by the author, or the author will need to be tracked down by a support staff, as DSpace might not have their current email address.

 


Initial Reply to Requester

 


Author permission request, includes information about the original request (requester name, requester email, requester's reason for requesting). The author/submitter's name and email address will be pre-populated in the form from the submitter, but the email address and author name are editable, as the submitter's of content to DSpace aren't always the author.

 


Email templates

Most of the email templates used by Request a Copy are treated just like other email templates in DSpace. The templates can be found in the /config/emails directory and can be altered just by changing the contents and restarting tomcat.

request_item.admintemplate for the message that will be sent to the administrator of the repository, after the original submitter requests to have the permissions changed for this item.
request_item.authortemplate for the message that will be sent to the original submitter of an item with the request for copy.

The templates for emails that the requester receives, that could have been customized by the approver in the aforementioned dialog are not managed as separate email template files. These defaults are stored in the Messages.properties file under the keys

itemRequest.response.body.approveDefault message for informing the requester of the approval
itemRequest.response.body.rejectDefault message for informing the requester of the rejection
itemRequest.response.body.contactAuthorDefault message for the helpdesk to contact the author
itemRequest.response.body.contactRequesterDefault message for the helpdesk to contact the requester

Configuration parameters

Request a copy is enabled in DSpace 4 by default. Only two configuration parameters in dspace.cfg relate to Request a Copy:

Property:

request.item.type

Example Value

request.item.type = all

Informational Note

This parameter manages who can file a request for an item. The parameter is optional. When it is empty or commented out, request a copy is disabled across the entire repository. When set to all, any user can file a request for a copy. When set to logged, only registered users can file a request for copy.

Property:

mail.helpdesk

Example Value

mail.helpdesk = foo@bar.com

Informational Note

In JSPUI, the email address assigned to this parameter will receive the emails both for granting or rejecting request a copy requests, as well as requests to change item policies. In XMLUI, the parameter will also receive these requests to change item policies. However, the actual requests for copy in XMLUI will initially be directed at the email address of the original submitter. When this email address can not be retrieved, the address in mail.helpdesk will be used as a fallback.

This parameter is optional. If it is empty or commented out, it will default to mail.admin.

WARNING: This setting is only utilized if the RequestItemHelpdeskStrategy bean is enabled in [dspace]/config/spring/api/requestitem.xml (see below)

Property:

request.item.helpdesk.override

Example Value

request.item.helpdesk.override = true

Informational Note

Should all Request Copy emails go to the mail.helpdesk instead of the item submitter? Default is false, which sends Item Requests to the item submitter.

WARNING: This setting is only utilized if the RequestItemHelpdeskStrategy bean is enabled in [dspace]/config/spring/api/requestitem.xml (see below)

...



Selecting Request a Copy strategy via Spring Configuration

...