◇◆
pub-id-type Type of Publication Identifier
Type of publication identifier or the organization or system that defined the identifier.
Usage/Remarks
Attribute Best Practice
Type of Identifier
While the values of the @pub-id-type
attribute are unconstrained, Best Practice is to reserve the @pub-id-type value for the specific type of the
external identifier (such as a DOI or PMID) or for a generic type of identifier (such
as a publisher’s identifier, an aggregator’s or archive’s identifier, the identifier
assigned by
an indexing or hosting service, or similar). The values for @pub-id-type are unconstrained and may take any value.
Authority for Identifier
The attribute @assigning-authority should name the organization or system that assigned the identifier or administers
the identifier (such as Crossref, OCLC, GenBank, Figshare).
Context
The @pub-id-type attribute can be used:
- on an object identifier element (<object-id>), which may be used inside a citation or on a some block-level objects such as a <fig> or structural objects such as a <sec>;
- inside a bibliographic citation element such as <mixed-citation> or <element-citation> (for example, on the <pub-id> element, which identifies a publication cited in a bibliographic reference list);
- on an issue or volume identifier (for example, on the <issue-id> element, which identifies an issue cited in a bibliographic reference list).
Case in Attribute Values
Upper/lower/mixed case in attribute values for organizations and identifier types
is likely to be variable and thus unreliable for search/discovery. If possible, JATS
recommends a case-insensitive search for such values. For example, if an identifier
type is a DOI, many publishers will use “doi” (to keep all attribute values lower case), while others will use “DOI” (because that is the native language acronym). Adding to this variability are identifiers
that change over time. Expect to find the organization Crossref in values as “Crossref” (the currently preferred organization name), “CrossRef” (the previously preferred organization name), or “crossref” (for publishers who prefer all lower case for attributes).
Historical Note
BITS takes the usage of this attribute from JATS, the major difference being that
JATS can use this attribute in the metadata for an article, whereas BITS does not
use this attribute in the metadata for a book. In BITS 2.0 and JATS version 1.2d2
(2018), the @pub-id-type’s value conflated two
meanings: the attribute could hold the
type of identifier (such as a DOI or ISBN), or it could hold the name of the organization
or system
that defined or registered the identifier (such as Crossref). There was no way to
state both that
the identifier content of the element was a DOI and that the server was
Figshare or Crossref. Although all the previous @pub-id-type values will continue to be accepted, for Best Practice, the @assigning-authority
should name an organization, and the @pub-id-type attribute should describe the identifier type.
OPTIONAL on many elements; click for list and usage
| Value | Meaning |
|---|---|
| Text, numbers, or special characters | The type of identifier, either as a specific type (such as “doi” or “std-designation”) or a generic identifier type (such as “publisher-id” or “archive”). |
| Restriction | @pub-id-type is an optional attribute; there is no default. |
Suggested usage
Best Practice: While this attribute may contain any text, the type of identifier should be named when the identifier is a known type, for example, DOI, ISBN, or Handle.
The list below suggests some well-established types:
|
aggregator
|
Identifier assigned by a data aggregator (generally used with elements <object-id>, <issue-id>, and <volume-id>)
|
|---|---|
|
archive
|
Identifier assigned by an archive or other repository (generally used with elements
<object-id>, <issue-id>, and <volume-id>)
|
|
art-access-id
|
Generic article accession identifier for interchange and retrieval between archives
|
|
arxiv
|
arXiv archive of electronic preprints
|
|
coden
|
Obsolete PDB/CCDC identifier (may be present on older articles)
|
|
custom
|
The value “custom” is used in versions of JATS that have a static list of values for
the @pub-id-type attribute. To add a value to such a list, the identifier is given the type “custom”
and a separate @custom-type attribute provides the typing value. There is no need for this mechanism in BITS,
since there are no restrictions on the value of @pub-id-type, but “custom” and @custom-type have both been included in BITS so that documents valid to a stricter version of
the JATS Tag Set can still be made into book parts.
|
|
doaj
|
Directory of Open Access Journals
|
|
doi
|
Digital Object Identifier
|
|
index
|
Identifier assigned by an abstracting or indexing service (generally used with elements
<object-id>, <issue-id>, and <volume-id>)
|
|
isbn
|
International Standard Book Number
|
|
manuscript
|
Identifier assigned to a manuscript
|
|
medline
|
NLM Medline identifier
|
|
pmcid
|
PubMed Central identifier
|
|
pmid
|
PubMed ID; see http://www.ncbi.nlm.nih.gov/sites/entrez?db=pubmed.
|
|
publisher-id
|
Publisher’s identifier, such as an “book-id”,
“booknum”, “identifier”, “book-number”, “pub-id”, etc.
|
|
sici
|
Serial Item and Contribution Identifier (An ANSI/NISO Z39.56 code to uniquely identify
volumes, articles, or other parts of a periodical. A journal article may have more
than one SICI, for example, one for a print version and another for an electronic
version.)
|
|
std-designation
|
The official number of a standard, from a standards body such as ISO, NISO, IEEE,
ASME, etc., for example, “Z39.96-2015”
|
Tagged Sample
<pub-id> is a DOI (inside citation)
...
<element-citation publication-type="journal" publication-format="print">
...
<fpage>519</fpage>
<lpage>617</lpage>
<pub-id pub-id-type="doi">10.1542/peds.2004-1441</pub-id>
</element-citation>
...