Submission
Last updated
Last updated
In order to comply with and institutional access , may be required to submit their to one or more . A Submission is associated with one submitter
and one Publication. It encapsulates a User satisfying one or more Policies relevant to their Publication by either (1) initiated in PASS or (2) of the publication that already exist in the target repositories. The User can start a Submission by describing their Publication and attaching relevant to it. The PASS system will use this information to determine which policies apply, and will help the User send the Publication out to the Repositories that will fulfill them.
Note that the source of a Submission record is not always a PASS User. In some instance, Submissions are created as a result of an import process designed to ensure that the User can see data relevant to their compliance with Policies in a uniform way.
id
String
Autogenerated identifier of object
metadata
String
Stringified JSON representation of metadata captured by the relevant repository forms. This will hold extended metadata relevant to the repositories selected in the Submission workflow. It may include fields such as embargoEndDate, embargoText, pmid, and anything else required by specific repositories etc.
source*
String
submitted*
boolean
When true, this value signals that the Submission will no longer be edited by the User. It indicates to Deposit services that it can generate Deposits for any Repositories that need one. This becomes "true" when the User clicks "submit" in the UI. For Submissions generated by loader processes this value will be false when the User must complete the Submission, or true if it is merely pointing to an existing copy of the Publication in a Repository.
submittedDate
String
submissionStatus*
String
aggregatedDepositStatus
String
submitterName
String
submitterEmail
String
publication*
To One
Publication represented in this Submission
repositories*
To Many
Repositories that this Publication will exist in when the Submission is completed
submitter
To One
preparers
To Many
grants
To Many
Grants that are associated with the User and are relevant to the Publication being submitted
effectivePolicies
To Many
Policies that will be satisfied via deposit through PASS
*required
Below are the possible values for the Submission.submissionStatus
field. They are listed in the order they would typically occur, and with an indication of the arrangement of the data that will result in this status. Note that not all Submissions will go through every status.
draft
Newly created Submissions by the UI will have this status by default. Only unsubmitted Submissions should have this status. Submissions created by other processes may use a different status.
Default status for Submissions newly created by a user interacting with the UI.
manuscript-required
When the PASS system identifies a need for a User to submit a Publication to a particular Repository, it will create a new Submission record with this status in order to prompt the User to provide the document and complete the Submission. For example, PASS imports information from the NIH Public Access Compliance system, which contains information about out of compliance publications - these will appear in the PASS system for PI of the corresponding Grant with the label manuscript-required
.
New Submissions of this type are created with this status already set
approval-requested
A Submission was prepared by a preparer
but now needs the submitter
to approve and submit it or provide feedback.
changes-requested
A Submission was prepared by a preparer
, but on review by the submitter
, a change was requested. The Submission has been handed back to the preparer
for editing.
cancelled
A Submission was prepared and then cancelled by the submitter
or preparer
without being submitted. No further edits can be made to the Submission.
submitted
Submission.submitted=true
, and the Publication associated with the Submission is in a positive status for each Repository i.e. it's RepositoryCopy.copyStatus
is not rejected
or stalled
, and in the absence of a RepositoryCopy, the Deposit.depositStatus
is not rejected
.
needs-attention
complete
The target repositories have all received a copy of the Submission, and have indicated that the Submission was successful.
There is a RepositoryCopy with repoCopyStatus=complete
for each of the target repositories.
These are the possible statuses for a Submission's aggregatedDepositStatus field. They are listed in the order they would occur. Note that not all Submissions will go through every status.
not-started
in-progress
failed
accepted
rejected
These are the possible sources of a Submission
pass
Submission record was created or submitted via the PASS user interface
other
Submission record was automatically created by harvesting and ingesting from a 3rd party service e.g. NIHMS
Indicates whether the record came from outside of PASS as an import, or was created through the system ()
DateTime the record was submitted by the through PASS
The current status of the Submission, derived from the status(es), status(es) and the eventType
of the most recent ()
Current combined status of Deposits, utilized by Deposit Services. The initial status of a new Submission will be "not-started" ()
Name of submitter. This field is used when a preparer nominates a submitter that is not yet a PASS . The name is temporarily stored for use in communications with the submitter until a User.id
is available. Once there is a URI for submitter
, the submitterName
should be null.
Email of submitter, formatted as a URI e.g. mailto:first.last@example.com
. This field is used when a preparer nominates a submitter that is not yet a PASS . The email value is temporarily stored for use in communications with the submitter until a User.id
is available. Once there is a URI for submitter
, the submitterEmail
should be null.
User responsible for submitting the Submission. The User will be the individual who either (a) created this Submission through PASS, thus claiming responsibility; (b) was designated as submitter
by a preparer
; or, (c) has been assigned the role based on their being PI of an associated . When this value is null, it indicates there is not yet a User record for the designated submitter. In this instance there should be a value in submitterName
and submitterEmail
.
Users who prepared, or who could contribute to the preparation of, the Submission. Preparers can edit the content of the Submission (describe the , add , select ) but cannot approve Repository agreements, or submit the publication - these tasks must be performed by the submitter
.
Submission.submitted=false
and the most recent has eventType=approval-requested
.
Submission.submitted=false
and the most recent has eventType=changes-requested
.
Submission.submitted=false
and the most recent has eventType=cancelled
.
The submit button has been pressed through the UI. From this status forward, the Submission becomes read-only to both the submitter
and preparers
. This status indicates that either (a) the Submission is still being processed, or (b) PASS has finished the Deposit process, but there is not yet confirmation from the Repository that indicates the Submission was valid. Some Submissions may remain in a submitted
state indefinitely depending on PASS's capacity to verify completion of the process in the target .
Indicates that a action may be required outside of PASS. The Submission is stalled or has been rejected by one or more
The copyStatus
of one or more for the Submission is rejected
or stalled
. In the absence of a RepositoryCopy
, the for that Repository has a depositStatus
of rejected
. To be clear, a positive status on the RepositoryCopy can override a negative status on the Deposit.
No have been initiated for the Submission
One or more for the Submission have been initiated, and at least one has not reached a status of "accepted" or "rejected"
One or more for the Submission has a status of "failed"
All related for the Submission have a status of "accepted"
One or more for the Submission has a status of "rejected"