<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.

Usage/Remarks

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 Best Practice

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 a 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 source term 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

Base Attributes

Namespaces

Models and Context
May be contained in
Description
Text, numbers, or special characters
Content Model
<!ELEMENT  article-version
                        (#PCDATA)                                    >
Tagged Samples
NISO JAV-based version, with display content 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>
...
NISO JAV-based version, with display content JAV
...
<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>
...
Version not from controlled vocabulary
...
<article-meta>
 <article-version 
   article-version-type="status"
  >draft</article-version>
 ...
</article-meta>
...