View source for Listings of User Roles and Privileges

[[Category:Plugins]]
[[Category:User Roles]]
This page is intended to be a near exhaustive listing of roles and privileges that can be assigned to a user to allow them to carry out certain actions.

== User Roles ==
;admin
:[[#indexer/start|indexer/start]], [[#indexer/stop|indexer/stop]], [[#indexer/force_start|indexer/force_start]], [[#create_user|create_user]], [[#subject/edit|subject/edit]], [[#staff/user_search|staff/user_search]], [[#staff/history_search|staff/history_search]], [[#staff/issue_search|staff/issue_search]], [[#config/view/FILETYPE|config/view]], [[#config/view/FILETYPE|config/view/xml]], [[#config/view/FILETYPE|config/view/workflow]], [[#config/view/FILETYPE|config/view/citation]], [[#config/view/FILETYPE|config/view/phrase]], [[#config/view/FILETYPE|config/view/namedset]], [[#config/view/FILETYPE|config/view/template]], [[#config/view/FILETYPE|config/view/static]], [[#config/view/FILETYPE|config/view/autocomplete]], [[#config/view/FILETYPE|config/view/apache]], [[#config/view/FILETYPE|config/view/perl]], [[#config/test_email|config/test_email]], [[#config/imports|config/imports]], [[#config/add_field|config/add_field]], [[#config/remove_field|config/remove_field]],[[#config/regen_abstracts|config/regen_abstracts]], [[#config/regen_citations|config/regen_citations]], [[#config/regen_views|config/regen_views]], [[#config/edit/FILETYPE|config/edit/perl]], [[#storage/manager|storage_manager]], [[#repository/epm|repository/epm]], [[#event_queue/destroy|event_queue/destroy]], [[#event_queue/details/event_queue/details]], [[#event_queue/edit|event_queue/edit]], [[#event_queue/export|event_queue/export]], [[#event_queue/view|event_queue/view]], [[#eprint/STATUS/destroy:USERTYPE|eprint/destroy]], [[#eprint/STATUS/details:USERTYPE|eprint/details]], [[#eprint/STATUS/edit:USERTYPE|eprint/edit]], [[#eprint/STATUS/export:USERTYPE|eprint/export]], [[#eprint/STATUS/upsert:USERTYPE|eprint/upsert]], [[#eprint/STATUS/view:USERTYPE|eprint/view]], [[#eprint/STATUS/remove:USERTYPE|eprint/archive/remove]], [[#eprint/STATUS/edit:USERTYPE|eprint/archive/edit]], [[#file/destroy|file/destroy]], [[#file/export|file/export]], [[#file/view|file/view]], [[#import/view|import/view]], [[#import/edit|import/edit]], [[#saved_search/destroy|saved_search/destroy]], [[#saved_search/details|saved_search]], [[#saved_search/edit|saved_search/edit]], [[#saved_search/export|saved_search/export]], [[#saved_search/view|saved_search/view]], [[#user/remove:USERTYPE|user/remove]], [[#user/edit:USERTYPE|user/edit]], [[#user/view:USERTYPE|user/view]], [[#user/details:USERTYPE|user/details]], [[#user/destroy:USERTYPE|user/destroy]], [[#user/history:USERTYPE|user/history]], [[#user/staff/edit|user/staff/edit]], [[#repository/epm|repository/epm]]
;change-email
: ''Currently empty''
;change-user
: ''Currently empty''
;deposit
: [[#items|items]], [[#create_eprint|create_eprint]], [[#user/history:USERTYPE|user/history:owner]], [[#eprint/STATUS/view:USERTYPE|eprint/inbox/view:owner]], [[#eprint/STATUS/export:USERTYPE|eprint/inbox/export:owner]], [[#eprint/STATUS/summary:USERTYPE|eprint/inbox/summary:owner]], [[#eprint/STATUS/destroy:USERTYPE|eprint/inbox/destroy:owner]], [[#eprint/STATUS/deposit:USERTYPE|eprint/inbox/deposit:owner]], [[#eprint/STATUS/edit:USERTYPE|eprint/inbox/edit:owner]], [[#eprint/STATUS/remove:USERTYPE|eprint/inbox/remove:owner]], [[#eprint/STATUS/details:USERTYPE|eprint/inbox/details:owner]], [[#eprint/STATUS/history:USERTYPE|eprint/inbox/history:owner]], [[#eprint/STATUS/messages:USERTYPE|eprint/inbox/messages:owner]], [[#eprint/STATUS/issues:USERTYPE|eprint/inbox/issues:owner]], [[#eprint/STATUS/use_as_template:USERTYPE|eprint/inbox/use_as_template:owner]], [[#eprint/STATUS/derive_version:USERTYPE|eprint/inbox/derive_version:owner]], [[#eprint/STATUS/view:USERTYPE|eprint/buffer/view:owner]], [[#eprint/STATUS/export:USERTYPE|eprint/buffer/export:owner]], [[#eprint/STATUS/summary:USERTYPE|eprint/buffer/summary:owner]], [[#eprint/STATUS/move_inbox:USER_TYPE|eprint/buffer/move_inbox:owner]], [[#eprint/STATUS/details:USERTYPE|eprint/buffer/details:owner]], [[#eprint/STATUS/history:USERTYPE|eprint/buffer/history:owner]], [[#eprint/STATUS/messages:USERTYPE|eprint/buffer/messages:owner]], [[#eprint/STATUS/request_removal:USERTYPE|eprint/buffer/request_removal:owner]], [[#eprint/STATUS/use_as_template:USERTYPE|eprint/buffer/use_as_template:owner]], [[#eprint/STATUS/derive_version:USERTYPE|eprint/buffer/derive_version:owner]], [[#eprint/STATUS/view:USERTYPE|eprint/archive/view:owner]], [[#eprint/STATUS/export:USERTYPE|eprint/archive/export:owner]], [[#eprint/STATUS/summary:USERTYPE|eprint/archive/summary:owner]], [[#eprint/STATUS/details:USERTYPE|eprint/archive/details:owner]], [[#eprint/STATUS/history:USERTYPE|eprint/archive/history:owner]], [[#eprint/STATUS/messages:USERTYPE|eprint/archive/messages:owner]], [[#eprint/STATUS/request_removal:USERTYPE|eprint/archive/request_removal:owner]], [[#eprint/STATUS/use_as_template:USERTYPE|eprint/archive/use_as_template:owner]], [[#eprint/STATUS/derive_version:USERTYPE|eprint/archive/derive_version:owner]], [[#eprint/STATUS/view:USERTYPE|eprint/deletion/view:owner]], [[#eprint/STATUS/export:USERTYPE|eprint/deletion/export:owner]], [[#eprint/STATUS/summary:USERTYPE|eprint/deletion/summary:owner]], [[#eprint/STATUS/details:USERTYPE|eprint/deletion/details:owner]], [[#eprint/STATUS/history:USERTYPE|eprint/deletion/history:owner]], [[#eprint/STATUS/messages:USERTYPE|eprint/deletion/messages:owner]], [[#eprint/STATUS/use_as_template:USERTYPE|eprint/deletion/use_as_template:owner]], [[#eprint/STATUS/derive_version:USERTYPE|eprint/deletion/derive_version:owner]]
;general
: [[#user/view:USERTYPE|user/view:owner]], [[#user/details:USERTYPE|user/details:owner]], [[#user/history:USERTYPE|user/history:owner]]
;edit-config
: [[#config/edit/FILETYPE|config/edit]], [[#config/edit/FILETYPE|config/edit/xml]], [[#config/edit/FILETYPE|config/edit/workflow]], [[#config/edit/FILETYPE|config/edit/citation]], [[#config/edit/FILETYPE|config/edit/phrase]], [[#config/edit/FILETYPE|config/edit/namedset]], [[#config/edit/FILETYPE|config/edit/template]], [[#config/edit/FILETYPE|config/edit/static]], [[#config/edit/FILETYPE|config/edit/autocomplete]], [[#config/reload|config/reload]]
;edit-own-record
: [[#user/edit:USERTYPE|user/edit:owner]]
;editor
: [[#datasets|datasets]], [[#editorial_review|editorial_review]], [[#eprint/STATUS/view:USERTYPE|eprint/inbox/view:editor]], [[#eprint/STATUS/export:USERTYPE|eprint/inbox/export:editor]], [[#eprint/STATUS/summary:USERTYPE|eprint/inbox/summary:editor]], [[#eprint/STATUS/details:USERTYPE|eprint/inbox/details:editor]], [[#eprint/STATUS/history:USERTYPE|eprint/inbox/history:editor]], [[#eprint/STATUS/messages:USERTYPE|eprint/inbox/messages:editor]], [[#eprint/STATUS/remove_with_email:USERTYPE|eprint/inbox/remove_with_email:editor]], [[#eprint/STATUS/move_archive:USERTYPE|eprint/inbox/move_archive:editor]], [[#eprint/STATUS/move_buffer:USERTYPE|eprint/inbox/move_buffer:editor]], [[#eprint/STATUS/use_as_template:USERTYPE|eprint/inbox/use_as_template:editor]], [[#eprint/STATUS/derive_version:USERTYPE|eprint/inbox/derive_version:editor]], [[#eprint/STATUS/edit:USERTYPE|eprint/inbox/edit:editor]], [[#eprint/STATUS/takelock:USERTYPE|eprint/inbox/takelock:editor]], [[#eprint/STATUS/view:USERTYPE|eprint/buffer/view:editor]], [[#eprint/STATUS/export:USERTYPE|eprint/buffer/export:editor]], [[#eprint/STATUS/summary:USERTYPE|eprint/buffer/summary:editor]], [[#eprint/STATUS/export:USERTYPE|eprint/buffer/export:editor]], [[#eprint/STATUS/details:USERTYPE|eprint/buffer/details:editor]], [[#eprint/STATUS/history:USERTYPE|eprint/buffer/history:editor]], [[#eprint/STATUS/messages:USERTYPE|eprint/buffer/messages:editor]], [[#eprint/STATUS/issues:USERTYPE|eprint/buffer/issues:editor]], [[#eprint/STATUS/remove_with_email:USERTYPE|eprint/buffer/remove_with_email:editor]], [[#eprint/STATUS/reject_with_email:USERTYPE|eprint/buffer/reject_with_email:editor]], [[#eprint/STATUS/move_inbox:USERTYPE|eprint/buffer/move_inbox:editor]], [[#eprint/STATUS/move_archive:USERTYPE|eprint/buffer/move_archive:editor]], [[#eprint/STATUS/use+as_template:USERTYPE|eprint/buffer/use_as_template:editor]], [[#eprint/STATUS/derive_version:USERTYPE|eprint/buffer/derive_version:editor]], [[#eprint/STATUS/edit:USERTYPE|eprint/buffer/edit:editor]], [[#eprint/STATUS/takelock:USERTYPE|eprint/buffer/takelock:editor]], [[#eprint/STATUS/view:USERTYPE|eprint/deletion/view:editor]], [[#eprint/STATUS/export:USERTYPE|eprint/deletion/export:editor]], [[#eprint/STATUS/summary:USERTYPE|eprint/deletion/summary:editor]], [[#eprint/STATUS/export:USERTYPE|eprint/deletion/export:editor]], [[#eprint/STATUS/details:USERTYPE|eprint/deletion/details:editor]], [[#eprint/STATUS/history:USERTYPE|eprint/deletion/history:editor]], [[#eprint/STATUS/messages:USERTYPE|eprint/deletion/messages:editor]], [[#eprint/STATUS/move_archive:USERTYPE|eprint/deletion/move_archive:editor]], [[#eprint/STATUS/use_as_template:USERTYPE|eprint/deletion/use_as_template:editor]], [[#eprint/STATUS/derive_version:USERTYPE|eprint/deletion/derive_version:editor]], [[#eprint/STATUS/takelock:USERTYPE|eprint/deletion/takelock:editor]], 
;rest
: [[#eprint/STATUS/rest/get:USERTYPE|eprint/archive/rest/get:editor]],  [[#eprint/STATUS/rest/put:USERTYPE|eprint/archive/rest/put:editor]],  [[#eprint/STATUS/rest/get:USERTYPE|eprint/buffer/rest/get:editor]],  [[#eprint/STATUS/rest/put:USERTYPE|eprint/buffer/rest/put:editor]], [[#eprint/STATUS/rest/get:USERTYPE|eprint/inbox/rest/get:editor]], [[#eprint/STATUS/rest/put:USERTYPE|eprint/inbox/rest/put:editor]], [[#eprint/STATUS/rest/get:USERTYPE|eprint/deletion/rest/get:editor]], [[#eprint/STATUS/rest/put:USERTYPE|eprint/deletion/rest/put:editor]], [[#eprint/STATUS/rest/get:USERTYPE|eprint/inbox/rest/get:owner]],  [[#eprint/STATUS/rest/put:USERTYPE|eprint/inbox/rest/put:owner]],  [[#eprint/STATUS/rest/get:USERTYPE|eprint/buffer/rest/get:owner]],  [[#eprint/STATUS/rest/get:USERTYPE|eprint/archive/rest/get:owner]],  [[#eprint/STATUS/rest/get:USERTYPE|eprint/deletion/rest/get:owner]],  [[#user/rest/get:USERTYPE|user/rest/get:owner]],  [[#subject/rest/get|subject/rest/get]]
;saved-searches
: [[#saved_search|saved_search]], [[#create_saved_search|create_saved_search]], [[#saved_search/view:USERTYPE|saved_search/view:owner]], [[#saved_search/edit:USERTYPE|saved_search/edit:owner]], [[#saved_search/destroy:USERTYPE|saved_search/destroy:owner]]
;set-password
: [[#set-password|set-password]]
;staff-view 
:  [[#eprint/STATUS/view:USERTYPE|eprint/inbox/view]], [[#eprint/STATUS/summary:USERTYPE|eprint/inbox/summary]], [[#eprint/STATUS/export:USERTYPE|eprint/inbox/export]], [[#eprint/STATUS/details:USERTYPE|eprint/inbox/details]], [[#eprint/STATUS/history:USERTYPE|eprint/inbox/history]], [[#eprint/STATUS/view:USERTYPE|eprint/buffer/view]], [[#eprint/STATUS/summary:USERTYPE|eprint/buffer/summary]], [[#eprint/STATUS/export:USERTYPE|eprint/buffer/export]], [[#eprint/STATUS/details:USERTYPE|eprint/buffer/details]], [[#eprint/STATUS/history:USERTYPE|eprint/buffer/history]], [[#eprint/STATUS/view:USERTYPE|eprint/archive/view]], [[#eprint/STATUS/export:USERTYPE|eprint/archive/export]], [[#eprint/STATUS/details:USERTYPE|eprint/archive/details]], [[#eprint/STATUS/history:USERTYPE|eprint/archive/history]], [[#eprint/STATUS/view:USERTYPE|eprint/deletion/view]], [[#eprint/STATUS/summary:USERTYPE|eprint/deletion/summary]], [[#eprint/STATUS/export:USERTYPE|eprint/deletion/export]], [[#eprint/STATUS/details:USERTYPE|eprint/deletion/details]], [[#eprint/STATUS/history:USERTYPE|eprint/deletion/history]], [[#eprint/search/staff:USERTYPE|eprint/search/staff]]  
;toolbox
: [[#toolbox|toolbox]]
;view-status
: [[#status|status]]

== Roles used by User Types (as of EPrints 3.4.x) ==
;minuser
:general, edit-own-record, saved-searches, set-password, lock-username-to-email
;user
:general, edit-own-record, saved-searches, set-password, deposit, change-email
;editor
:general, edit-own-record, saved-searches, set-password, deposit, change-email, editor, view-status, staff-view
;admin
:general, edit-own-record, saved-searches, set-password, deposit, change-email, editor, view-status, staff-view, admin, edit-config

== User Privileges ==
=== config ===
==== config/add_field ====
Add a bespoke field to a data object, using the web browser interface.
==== config/delete/FILETYPE ====
Delete a configuration file. This can optionally be restricted to a file of a particular '''FILETYPE''': ''autocomplete, citation, namedset, perl, phrase, static, template, workflow, xml''.  Some of these types can overlap, e.g. ''workflow'' is also ''xml''.
==== config/edit/FILETYPE ====
Edit a configuration file. This can optionally be restricted to a file of a particular '''FILETYPE''': ''autocomplete, citation, namedset, perl, phrase, static, template, workflow, xml''.  Some of these types can overlap, e.g. ''workflow'' is also ''xml''.
==== config/imports ====
Unused by default.  Intended for managing bulk imports to a repository archive.
==== config/regen_abstracts ====
Drops the abstract pages cache so abstract pages can be regenerated.
==== config/regen_citations ====
Drops the citations cache so citations can be regenerated.
==== config/regen_views ==== 
Drops the browse view cache so browse view pages can be regenerated.
==== config/reload ====
Reload the repository configuration.
==== config/remove_field ====
Remove a field from a data object.  (Only fields created via the web browser interfaces, not pre-created through archive configuration).
==== config/test_email ====
View the "Send test email" page to send a test email to a specified address to confirm email sending is working as expected.
==== config/view/FILETYPE ====
View a configuration file. This can optionally be restricted to a file of a particular '''FILETYPE''': ''autocomplete, citation, namedset, perl, phrase, static, template, workflow, xml''.  Some of these types can overlap, e.g. ''workflow'' is also ''xml''.

=== eprint ===
Some eprint privileges can be specialised by the '''STATUS''' of the the eprint (e.g. ''inbox'', ''buffer'', ''archive'' or  ''deletion'' and the '''USERTYPE''' (e.g. ''owner'' or ''editor'').  The privilege ''eprint/view'' would allow the user to view any eprint, ''eprint/archive/view'' would only allow them to view eprints in the live archive and ''eprint/inbox/view:owner'' would only allow them to view eprints in the user workarea if they were owned by the user.
==== create_eprint ====
Create a new eprint, which will initial appear in that user's workarea.
==== eprint_search ====
View and use eprint search across live archive.
==== eprint/reject_with_email ====
Reject the eprint under review (returning to user's workarea) and email eprint's owner about this.
==== eprint/remove_once_archived ====
Completely remove an eprint even if it is or has been in the live archive.
==== eprint/remove_with_email ====
Completely remove an eprint and email eprint's owner to about this.
==== eprint/staff/search ====
View and use full eprint search across all statuses of eprint.
==== eprint/STATUS/deposit:USERTYPE ====
Deposit an eprint.  Typically this would be just changing it status from ''inbox'' to ''buffer'', so the eprint can be reviewed.
==== eprint/STATUS/derive_version:USERTYPE ====
Create a new version of a chosen eprint.  Copying the metadata and setting the ''succeeds'' field to that of that chosen eprint.
==== eprint/STATUS/destroy:USERTYPE ====
Completely delete an existing eprint via "Manage records" page.

==== eprint/STATUS/details:USERTYPE ====
View the ''Details'' tab for an eprint.
==== eprint/STATUS/edit:USERTYPE ====
Edit the metadata for an eprint
==== eprint/STATUS/export:USERTYPE ====
Export the metadata for an eprint in one or more different formats.
==== eprint/STATUS/history:USERTYPE ====
View the ''History'' tab for an eprint.
==== eprint/STATUS/issues:USERTYPE ====
View the ''Issues'' tab for an eprint.
==== eprint/STATUS/messages:USERTYPE ====
View the ''Messages'' tab for an eprint.
==== eprint/STATUS/move_archive:USERTYPE ====
Move an eprint to the live archive. (I.e. change its status, normally from ''buffer'' to ''archive'').
==== eprint/STATUS/move_buffer:USERTYPE ====
Move an eprint back to the review buffer. (I.e. change its status to ''buffer'').
==== eprint/STATUS/move_deletion:USERTYPE ====
Retire an eprint. (I.e. change its status, normally from ''archive'' to ''deletion'').
==== eprint/STATUS/move_inbox:USERTYPE ====
Move an eprint back to a user's workarea. (I.e. change its status, normally from ''buffer'' to ''inbox'').
==== eprint/STATUS/remove:USERTYPE ====
Completely remove an eprint.
==== eprint/STATUS/request_removal:USERTYPE ====
Request that an existing eprint is removed, (e.g. because it is a duplicate or has been added erroneously).
==== eprint/STATUS/rest/get:USERTYPE ====
An eprint's metadata can be retrieved using the REST API.
==== eprint/STATUS/rest/put:USERTYPE ====
An eprint's metadata can be set using the REST API.
==== eprint/STATUS/summary:USERTYPE ====
View the ''Summary''' tab of an eprint.
==== eprint/STATUS/takelock:USERTYPE ====
Take the edit lock on an eprint.
==== eprint/STATUS/upsert:USERTYPE ====
Overwrite the existing metadata for an eprint.  Typically with a PUT request via an API not through the repository's web browser interface.
==== eprint/STATUS/use_as_template:USERTYPE ====
Use metadata from a chosen eprint to create a new eprint, which is not a new version of that chosen eprint.
==== eprint/STATUS/view:USERTYPE ====
View an eprint and a rendering of its metadata

=== event_queue ===
==== event_queue/destroy ====
Completely delete an event queue task.
==== event_queue/details ====
View the ''Details'' tab for an event queue task.
==== event_queue/edit ====
Edit an event queue task.  (E.g. change the time it should run or reset its status if it has failed.)
==== event_queue/export ====
Export the metadata for an event queue task. 
==== event_queue/view ====
View the metadata for an event queue task.

=== file ===
==== file/destroy ====
Completely delete a file record via "Manage records" page.

==== file/export ====
Export the metadata for a file record.
==== file/view ====
View the metadata for a file record.

=== import ===
==== import/view ====
View the metadata for an import.
==== import/edit ====
Edit the metadata for an import.

=== indexer ===
==== indexer/force_start ====
Force start the indexer, if the repository thinks it is still running but no event queue tasks are being processed.
==== indexer/start ====
Start the indexer if it is not currently running.
==== indexer/stop ====
Stop the indexer if it is currently running.

=== saved_search ===
Some saved search privileges can be specialised by '''USERTYPE''' (e.g. ''owner'').  The privilege ''saved_search/edit'' would allow the user to view any saved search record, ''saved_search/edit:owner'' would only allow them to edit their own saved search records.
==== create_saved_search ====
Create a new saved_search record.
==== saved_search ==== 
View listing or a user's saved searches.
==== saved_search/destroy:USERTYPE ====
Completely delete a saved search record.
==== saved_search/details:USERTYPE ==== 
View the ''Details'' tab for a saved search record.
==== saved_search/edit:USERTYPE ====
Edit the metadata for a saved search record.
==== saved_search/export:USERTYPE ====
Export the metadata for a saved search record.
==== saved_search/view:USERTYPE ====
View the metadata for a saved search record.

=== staff ===
==== staff/user_search ==== 
View and use the search over user records.
==== staff/history_search ==== 
View and use the search over eprint history records.
==== staff/issue_search ====
View and use the search over eprint issue records.

=== subject ===
==== subject/edit ====
View and edit the subject tree.
==== subject/rest/get ====
A subject's metadata can be retrieved using the REST API.

=== user ===
Some user privileges can be specialised by '''USERTYPE''' (e.g. ''owner'').  The privilege ''user/edit'' would allow the user to view any user record, ''user/edit:owner'' would only allow them to edit their own user record.
==== create_user ====
Create a new user.
==== user/destroy:USERTYPE ====
Completely delete a user record.
==== user/details:USERTYPE ====
View the ''Details'' tab of a user.
==== user/edit:USERTYPE ====
Edit a user's profile.
==== user/history:USERTYPE ====
View the ''History'' tab of a user.  This includes the changes (revisions) they made to any eprint record.
==== user/mediate ====
Whether a user can mediate for (i.e. act as) another user.  Required feature of [[SWORD]] API.
==== user/remove:USERTYPE ==== 
Unused by default.  Intended for removing a user record. Use [[#user/destroy:USERTYPE|user/destroy:USERTYPE]] instead.

==== user/staff/edit ====
Unused by default.  Intended for restricting parts of a user's profile to be edited by a repository admininistrator. 
==== user/view:USERTYPE ====
View a user record's metadata.

=== Miscellaneous ===
==== datasets ====
View the "Manage records" page.
==== editorial_review ====
View the "Review" page.
==== items ====
View the "Manage deposits" page.
==== repository/epm ====
View the "EPrints Bazaar" page and install Bazaar plugins.
==== set-password ====
Unused by default.  Intended for restricting whether a user can set their own password.
==== status ====
View the "Status" and "Database Schema" pages.
==== storage/manager ====
View the "Storage Manager" page.
==== toolbox ====
Use the toolbox CGI script (i.e. ''/cgi/toolbox/toolbox'') to carry out a operation provided by EPrints::Toolbox.  '''Dangerous''': Do not enable without good reason.

== Public Role User Privileges ==
These privileges available to users without them needing to login.  This mainly pertains to REST requests you may or may not want accessible.
;+eprint/archive/rest/get
:REST request to get metadata for an eprint in the live archive
;+subject/archive/rest/get
:REST request to get metadata for a subject in the archive's subject tree.