Properties

Journals are contained in the Journal Scheme. Each journal has a Concept associated with it, which contains journal-specific metadata. Behavior of manuscripts associated with particular journals is controlled by these metadata values. The DryadJournalConcept class wraps the specific journal metadata elements in a single class.

Identifiers

fullName: The only required metadata that a journal must have. This name is unique in the system.

journalID: A secondary, Dryad-assigned unique short identifier.

issn: The journal's International Standard Serial Number, uniquely assigned to each periodical.

conceptID: An internal database identifier for use by Dryad.

Relationship to Dryad

status: A value of ACCEPTED indicates that the journal's metadata has been validated by Dryad's curators, while a value of CANDIDATE indicates that this journal has not been validated.

customerID: If present, the internal Association Anywhere customer ID for the sponsoring organization.

paymentPlan: This value triggers whether or not journal.subscriptionPaid is true (journal.subscriptionPaid as a separate metadata value is deprecated). If present, the value indicates the payment plan [https://datadryad.org/pages/paymentPlans] that the sponsoring organization uses. Valid values are SUBSCRIPTION, DEFERRED and PREPAID.

hasJournalPage: This value should be set to true if the journal is integrated, sponsored, or both.

website: This should contain the journal's website url. (Currently, we are only capturing/maintaining this for journals with journal pages -- see above)

description: This should contain a brief text description of the journal, preferably taken directly from the journal's website. (Currently, we are only capturing/maintaining this for journals with journal pages -- see above)

canonicalManuscriptNumberPattern: A regular expression indicating what the canonical, non-changing part of the journal's manuscript ID is. This should be captured in the first capture group of the regex. The rest of the ID may change based on its revision status.

Miscellaneous

These aren't used, but existed in the old class PublicationBean.

memberName

Temporary Journal Concepts

When a user submits data for a published paper for a journal that has not been associated with Dryad before, a temporary journal concept is created. These concepts have a temporary journalID and fullName that are the same as the user-entered journal name and a status of CANDIDATE.

At some point before these submissions are curated into the archive, a curator needs to validate the journal and update its temporary concept, giving it its ISSN and changing its status to ACCEPTED.

Modifying Existing Journal Concepts

Modifications to existing, accepted concepts should be documented in a "dc.description.provenance" field using this format: [name] [what you changed] [date as YYYY-MM-DD]

Querying Journal Concepts

Users with access (curators and repository administrators) can retrieve information about journals either through the Scheme management system, looking for concepts in the Journal scheme, or through the REST API's organizations endpoint.

Scheme GUI

This method is very tedious, especially if you need to edit or adjust multiple concepts. From the user pull-down menu, go to Manage Scheme and then click on the Journal scheme. You should be taken to the Journal scheme page, which just identifies scheme as Journal and has a few basic attributes. From there, go to the pull-down menu and select Search & Add Concepts. To look at a particular journal's concept, click on the name of the journal. The status of the concept is an Attribute and can be edited by choosing Edit Concept Attribute from the pull-down menu, while the other metadata values can be edited or created by choosing Edit Metadata Value from the pull-down menu.

REST API

You need an authorized access token in order to use this method, but it is more efficient for batch-editing concepts.

Viewing Concepts

To view all journal concepts, use a GET request:

http://datadryad.org/api/v1/organizations/?access_token=xxxxx

This can be modified to only return concepts with a particular status, either `ACCEPTED` or `CANDIDATE`: