<article-version>

Article Current Version Status or Number

Holds version information such as a version type, version status, version statement, or version number for the current article.

Remarks

Usage: An <article-version> may contain a word or phrase from a controlled version vocabulary (“Author's Original” from the NISO JAV recommendation), a non-JAV version status word (“draft” or “pre-submission final revision”), a version statement (“Preliminary version before PI edit”), or a version number (“ver. 2.0”).
Rationale: With the recent increase in availability of early versions of journal articles, it is becoming more important to record, within the XML document, a status, version name, version number, lifecycle stage, or similar descriptor. This <article-version> element was created to hold that version information.
NISO JAV as Content: The NISO JAV recommendation defines version descriptors such as “Proof” (abbreviation “P”), “Author’s Original” (abbreviation “AO”), “Version of Record” (abbreviation “VoR”), and “Corrected Version of Record” (abbreviation “CVoR”). JATS Best Practice, if using the NISO JAV terms, is to tag the NISO JAV descriptor as the content of the <article-version> element. The NISO JAV descriptor may be repeated in the @vocab-term attribute to facilitate interoperability, and should be repeated in the @vocab-term if the version concept is NISO JAV concept, but the display is not a canonical JAV value. The @article-version-type can also be used to identify the NISO JAV abbreviation.
Attribute Best Practice: Because the <article-version> element is so loosely defined, the element should always be given either a @vocab element naming the controlled vocabulary from which the status descriptor is taken or an @article-version-type attribute naming the type or kind of status identifier given. For example:
  • Controlled Vocabulary: If the article version element content is from a taxonomy, ontology, index or similar term source such as the NISO JAV recommendation, the @vocab attribute should name the vocabulary and the @vocab-identifier provide a URI or other identifier to the vocabulary. The @vocab-term attribute can provide the term source canonical version, if the element content does not, and the @vocab-term-identifier attribute may point to the term, if appropriate.
  • Version Number or Uncontrolled Vocabulary: For <article-version> content that is not based on a controlled vocabulary, the @article-version-type can be used to explain what the content means, as expressed in the Publisher’s vocabulary, for example, “status”, “web-host-version-identifier”, or “publisher-control-number”.
Recording Dates and URIs: If an author wishes to record other information about the article version, for example, the date and URI, this can be recorded using attributes on the <article-version> element (@iso-8601-date and @xlink:href).

Attributes

Content Model

<!ELEMENT  article-version
                        (#PCDATA)                                    >

Description

Text, numbers, or special characters

This element may be contained in:

Example 1

Articles in which the version descriptor is NISO JAV-based, but the display version is non-JAV:
...
<article-meta>
<article-version vocab="JAV" 
  vocab-identifier="http://www.niso.org/publications/rp/RP-8-2008.pdf"
  article-version-type="VoR"  
  vocab-term="Version of Record">version-of-record</article-version>
...
</article-meta>...
...
<article-version vocab="JAV" 
  vocab-identifier="http://www.niso.org/publications/rp/RP-8-2008.pdf"
  article-version-type="AO"  
  vocab-term="Author's Original">Author's Original</article-version>
...

Example 2

Version descriptor is NISO JAV-based, using the JAV display term:
...
<article-meta>
<article-version vocab="JAV" 
  vocab-identifier="http://www.niso.org/publications/rp/RP-8-2008.pdf"
  vocab-term="Version of Record"
  article-version-type="VoR"  
  >Version of Record</article-version>...
</article-meta>...

Example 3

Version descriptor is not from a controlled vocabulary:
...
<article-meta>
<article-version 
   article-version-type="status"
   >draft</article-version>...
</article-meta>...