.. _journals.json#/: journals ======== .. container:: title A record representing a Journal :type: ``object`` :Required: :ref:`journals.json#/properties/journal_title`, :ref:`journals.json#/properties/short_title`, :ref:`journals.json#/properties/_collections` **Properties:** :ref:`journals.json#/properties/$schema`, :ref:`journals.json#/properties/_bucket`, :ref:`journals.json#/properties/_collections`, :ref:`journals.json#/properties/_harvesting_info`, :ref:`journals.json#/properties/_private_notes`, :ref:`journals.json#/properties/book_series`, :ref:`journals.json#/properties/control_number`, :ref:`journals.json#/properties/date_ended`, :ref:`journals.json#/properties/date_started`, :ref:`journals.json#/properties/deleted`, :ref:`journals.json#/properties/deleted_records`, :ref:`journals.json#/properties/doi_prefixes`, :ref:`journals.json#/properties/inspire_categories`, :ref:`journals.json#/properties/issns`, :ref:`journals.json#/properties/journal_title`, :ref:`journals.json#/properties/legacy_creation_date`, :ref:`journals.json#/properties/legacy_version`, :ref:`journals.json#/properties/license`, :ref:`journals.json#/properties/new_record`, :ref:`journals.json#/properties/proceedings`, :ref:`journals.json#/properties/public_notes`, :ref:`journals.json#/properties/publisher`, :ref:`journals.json#/properties/refereed`, :ref:`journals.json#/properties/related_records`, :ref:`journals.json#/properties/self`, :ref:`journals.json#/properties/short_title`, :ref:`journals.json#/properties/title_variants`, :ref:`journals.json#/properties/urls` .. _journals.json#/properties/$schema: $schema +++++++ :type: ``string`` :format: ``uri`` :minLength: ``1`` .. _journals.json#/properties/_bucket: _bucket +++++++ Used by `invenio-records-files` to store information about the bucket attached to this record. .. note:: This field is maintained by `invenio-records-files` and should not be edited manually. :type: ``string`` :minLength: ``1`` .. _journals.json#/properties/_collections: _collections ++++++++++++ .. container:: title Collections to which this record belongs :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **_collections** is: :type: ``string`` :minLength: ``1`` **Allowed values:** - Journals .. _journals.json#/properties/_harvesting_info: _harvesting_info ++++++++++++++++ :MARC: ``583`` Metadata about the harvesting process of this journal. :type: ``object`` **Properties:** :ref:`journals.json#/properties/_harvesting_info/properties/coverage`, :ref:`journals.json#/properties/_harvesting_info/properties/date_last_harvest`, :ref:`journals.json#/properties/_harvesting_info/properties/last_seen_item`, :ref:`journals.json#/properties/_harvesting_info/properties/method` .. _journals.json#/properties/_harvesting_info/properties/coverage: coverage ######## :MARC: ``583__a`` Whether all articles are automatically added to Inspire (``full``) or a selection is made (``partial``). :type: ``string`` :minLength: ``1`` **Allowed values:** - full - partial .. _journals.json#/properties/_harvesting_info/properties/date_last_harvest: date_last_harvest ################# :MARC: ``583__c`` Date on which the most recent harvest was performed. .. note:: This date does not necessarily mean that any records were created on that day. This can happen if there was no journal update since the previous time, or that the update did not have any relevant effect for Inspire. :type: ``string`` :format: ``date`` :minLength: ``1`` .. _journals.json#/properties/_harvesting_info/properties/last_seen_item: last_seen_item ############## :MARC: ``583__3`` Information about last processed item in the harvest. This item can be a volume, an issue or even a specific article. :type: ``string`` :minLength: ``1`` .. _journals.json#/properties/_harvesting_info/properties/method: method ###### :MARC: ``583__i`` How the harvesting is performed. Possible values are: ``feed`` Inspire receives a feed with publisher updates. ``harvest`` harvesting is done through webscraping. ``print`` articles are picked manually from the printed journal. ``hepcrawl`` harvesting is done through a native ``hepcrawl`` spider. :type: ``string`` :minLength: ``1`` **Allowed values:** - feed - harvest - print - hepcrawl .. _journals.json#/properties/_private_notes: _private_notes ++++++++++++++ .. container:: title List of private notes :MARC: ``595__a``, ``667__x`` These notes are only visible to privileged users, not regular users. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **_private_notes** is: :Reference: :ref:`sourced_value.json#/` .. _journals.json#/properties/book_series: book_series +++++++++++ :MARC: ``980__a:BookSeries`` corresponds to ``true`` Whether this “journal” is actually a serial whose volumes are books, i.e. a book series. :type: ``boolean`` .. _journals.json#/properties/control_number: control_number ++++++++++++++ .. container:: title ID of current record :MARC: ``001`` Read-only field. Also called ``record ID`` or ``recid``. :type: ``integer`` .. _journals.json#/properties/date_ended: date_ended ++++++++++ :MARC: Not present. Date of last publication of the journal. :type: ``string`` :format: ``date`` :minLength: ``1`` .. _journals.json#/properties/date_started: date_started ++++++++++++ :MARC: Not present. Date of first publication of the journal. :type: ``string`` :format: ``date`` :minLength: ``1`` .. _journals.json#/properties/deleted: deleted +++++++ .. container:: title Whether this record has been deleted :MARC: ``980__a/c:deleted`` :type: ``boolean`` .. _journals.json#/properties/deleted_records: deleted_records +++++++++++++++ :MARC: ``981__a`` List of records that were deleted because they were replaced by this one. This typically happens when merging two records: one of them gets enriched with the information of the other one, which is then superfluous and gets deleted. For the opposite concept, see :ref:`journals.json#/properties/new_record`. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **deleted_records** is: :Reference: :ref:`journal.json#/` .. _journals.json#/properties/doi_prefixes: doi_prefixes ++++++++++++ .. container:: title List of DOI prefixes for this journal :MARC: ``677__d`` This DOI prefix is the common start of DOIs in this journals, that all articles share. .. note:: This is a list because journals can change publishers, and the new publisher will often assign new DOIs in its own prefix. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **doi_prefixes** is: :type: ``string`` :pattern: ``^10\.\d+(\.\d+)?/.*$`` :minLength: ``1`` .. _journals.json#/properties/inspire_categories: inspire_categories ++++++++++++++++++ .. container:: title List of Inspire categories :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **inspire_categories** is: :Reference: :ref:`inspire_field.json#/` .. _journals.json#/properties/issns: issns +++++ .. container:: title List of ISSNs :MARC: ``022`` :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **issns** is: :type: ``object`` :Required: :ref:`journals.json#/properties/issns/items/properties/value` **Properties:** :ref:`journals.json#/properties/issns/items/properties/medium`, :ref:`journals.json#/properties/issns/items/properties/value` .. _journals.json#/properties/issns/items/properties/medium: medium ###### .. container:: title Physical medium to which this ISSN refers :MARC: ``022__b`` :type: ``string`` :minLength: ``1`` **Allowed values:** - online - print .. _journals.json#/properties/issns/items/properties/value: value ##### :MARC: ``022__a`` :example: ``0295-5075`` :type: ``string`` :pattern: ``^\d{4}-\d{3}[\dX]$`` :minLength: ``1`` .. _journals.json#/properties/journal_title: journal_title +++++++++++++ :Reference: :ref:`title.json#/` :MARC: ``130`` .. _journals.json#/properties/legacy_creation_date: legacy_creation_date ++++++++++++++++++++ .. container:: title Date of record creation on legacy :MARC: ``961__x`` Only present if the record already existed on legacy Inspire. :type: ``string`` :format: ``date`` :minLength: ``1`` .. _journals.json#/properties/legacy_version: legacy_version ++++++++++++++ .. container:: title Last record update :MARC: ``005`` Used to indicate the version of the record on legacy. :type: ``string`` :minLength: ``1`` .. _journals.json#/properties/license: license +++++++ :MARC: ``540`` :type: ``object`` **Properties:** :ref:`journals.json#/properties/license/properties/license`, :ref:`journals.json#/properties/license/properties/url` .. _journals.json#/properties/license/properties/license: license ####### .. container:: title License statement :MARC: ``540__a`` Either the short name of the license or the full license statement. :example: ``CC-BY-4.0`` :type: ``string`` :minLength: ``1`` .. _journals.json#/properties/license/properties/url: url ### .. container:: title URL of the license :MARC: ``540__u`` URL where the full license statement may be found, if only a short name is provided in ``license``. :type: ``string`` :format: ``uri`` :minLength: ``1`` .. _journals.json#/properties/new_record: new_record ++++++++++ .. container:: title Record replacing this one :MARC: ``970__d`` Contains a reference to the record replacing the current one, if it is marked as :ref:`journals.json#/properties/deleted`. :Reference: :ref:`journal.json#/` .. _journals.json#/properties/proceedings: proceedings +++++++++++ :MARC: ``690__a:Proceedings`` corresponds to ``true`` Whether this journal publishes conference proceedings. If it publishes both conference proceedings and peer reviewed articles (depending on issue), both this field and :ref:`journals.json#/properties/refereed` are ``true``. :type: ``boolean`` .. _journals.json#/properties/public_notes: public_notes ++++++++++++ .. container:: title List of public notes :MARC: ``500__a``, ``640__a``, ``680__i`` Any notes about the document that do not fit into another field. .. note:: These notes are publicly visible. For notes not shown to regular users, see :ref:`journals.json#/properties/_private_notes`. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **public_notes** is: :Reference: :ref:`sourced_value.json#/` .. _journals.json#/properties/publisher: publisher +++++++++ .. container:: title List of publishers :MARC: ``643__b`` The first element of the list is the current publisher of the journal. .. note:: This is a list because journals can change publishers. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **publisher** is: :type: ``string`` :minLength: ``1`` .. _journals.json#/properties/refereed: refereed ++++++++ :MARC: ``690__a:Peer review`` corresponds to ``true``, ``690__a:NON-PUBLISHED`` to ``false`` Whether this journal is considered to perform peer review. This assessment might differ from the journal's. If the journal does not publish proceedings :ref:`journals.json#/properties/proceedings`, all articles in it are flagged as :ref:`hep.json#/properties/refereed`. Otherwise, it is only the case if the article is not a ``conference paper``. :type: ``boolean`` .. _journals.json#/properties/related_records: related_records +++++++++++++++ .. container:: title List of related records :MARC: ``530`` :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **related_records** is: :Reference: :ref:`related_record.json#/` .. _journals.json#/properties/self: self ++++ :Reference: :ref:`journal.json#/` .. _journals.json#/properties/short_title: short_title +++++++++++ :MARC: ``711__a`` Normalized title of the journal :example: ``Phys.Rev. D`` :type: ``string`` :minLength: ``1`` .. _journals.json#/properties/title_variants: title_variants ++++++++++++++ .. container:: title List of journal name variants :MARC: ``730__a`` These name variants appear in references and are used to properly recognize citations. :example: ``PHYS REVIEW`` :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **title_variants** is: :type: ``string`` :minLength: ``1`` .. _journals.json#/properties/urls: urls ++++ :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **urls** is: :Reference: :ref:`url.json#/`