.. _conferences.json#/: conferences =========== .. container:: title Conference :type: ``object`` :Required: :ref:`conferences.json#/properties/_collections` **Properties:** :ref:`conferences.json#/properties/$schema`, :ref:`conferences.json#/properties/_bucket`, :ref:`conferences.json#/properties/_collections`, :ref:`conferences.json#/properties/_private_notes`, :ref:`conferences.json#/properties/acronyms`, :ref:`conferences.json#/properties/addresses`, :ref:`conferences.json#/properties/alternative_titles`, :ref:`conferences.json#/properties/closing_date`, :ref:`conferences.json#/properties/cnum`, :ref:`conferences.json#/properties/contact_details`, :ref:`conferences.json#/properties/control_number`, :ref:`conferences.json#/properties/core`, :ref:`conferences.json#/properties/deleted`, :ref:`conferences.json#/properties/deleted_records`, :ref:`conferences.json#/properties/external_system_identifiers`, :ref:`conferences.json#/properties/inspire_categories`, :ref:`conferences.json#/properties/keywords`, :ref:`conferences.json#/properties/legacy_creation_date`, :ref:`conferences.json#/properties/legacy_version`, :ref:`conferences.json#/properties/new_record`, :ref:`conferences.json#/properties/opening_date`, :ref:`conferences.json#/properties/public_notes`, :ref:`conferences.json#/properties/self`, :ref:`conferences.json#/properties/series`, :ref:`conferences.json#/properties/short_description`, :ref:`conferences.json#/properties/titles`, :ref:`conferences.json#/properties/urls` .. _conferences.json#/properties/$schema: $schema +++++++ :type: ``string`` :format: ``uri`` :minLength: ``1`` .. _conferences.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`` .. _conferences.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:** - Conferences .. _conferences.json#/properties/_private_notes: _private_notes ++++++++++++++ .. container:: title List of private notes :MARC: ``595`` 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#/` .. _conferences.json#/properties/acronyms: acronyms ++++++++ .. container:: title List of acronyms of the conference :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **acronyms** is: .. container:: title Conference acronym :MARC: ``111__e`` :example: ``SUSY 2018`` :type: ``string`` :minLength: ``1`` .. _conferences.json#/properties/addresses: addresses +++++++++ .. container:: title List of locations of the conference :MARC: ``111__c`` (in the form ``city, country``), ``270__b`` This field is a list because a conference can sometimes be split among several cities. .. note:: The :ref:`address.json#/properties/postal_address` should not be provided for a conference. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **addresses** is: :Reference: :ref:`address.json#/` .. _conferences.json#/properties/alternative_titles: alternative_titles ++++++++++++++++++ :MARC: ``711`` Sometimes conferences are known by several titles/acronyms. These name variants can be provided here. .. note:: If a conference has several titles or acronyms, it is more appropriate to use :ref:`conferences.json#/properties/titles` or :`acronyms`. This field is meant mainly to port information from legacy, that was not categorized well into title/acronym variants and was used to boost search results. :type: ``array`` :minItems: ``1`` .. container:: title List of alternative titles .. container:: sub-title Every element of **alternative_titles** is: :Reference: :ref:`title.json#/` .. _conferences.json#/properties/closing_date: closing_date ++++++++++++ .. container:: title Conference closing date ``111__y`` :type: ``string`` :format: ``date`` :minLength: ``1`` .. _conferences.json#/properties/cnum: cnum ++++ .. container:: title CNUM of the conference :Reference: :ref:`cnum.json#/` .. _conferences.json#/properties/contact_details: contact_details +++++++++++++++ .. container:: title Contact information :MARC: ``270`` :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **contact_details** is: :Reference: :ref:`contact.json#/` .. _conferences.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`` .. _conferences.json#/properties/core: core ++++ .. container:: title Whether this record is CORE :MARC: ``980:CORE`` corresponds to ``true`` :type: ``boolean`` .. _conferences.json#/properties/deleted: deleted +++++++ .. container:: title Whether this record has been deleted :MARC: ``980__a/c:deleted`` :type: ``boolean`` .. _conferences.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:`conferences.json#/properties/new_record`. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **deleted_records** is: :Reference: :ref:`conference.json#/` .. _conferences.json#/properties/external_system_identifiers: external_system_identifiers +++++++++++++++++++++++++++ List of identifiers of this document on external systems. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **external_system_identifiers** is: May satisfy *any* of the following definitions: .. _conferences.json#/properties/external_system_identifiers/items/anyOf/0: 0 # :type: ``object`` :Required: :ref:`conferences.json#/properties/external_system_identifiers/items/anyOf/0/properties/schema`, :ref:`conferences.json#/properties/external_system_identifiers/items/anyOf/0/properties/value` **Properties:** :ref:`conferences.json#/properties/external_system_identifiers/items/anyOf/0/properties/schema`, :ref:`conferences.json#/properties/external_system_identifiers/items/anyOf/0/properties/value` .. _conferences.json#/properties/external_system_identifiers/items/anyOf/0/properties/schema: schema >>>>>> :type: ``string`` :minLength: ``1`` **Allowed values:** - SPIRES .. _conferences.json#/properties/external_system_identifiers/items/anyOf/0/properties/value: value >>>>> :MARC: ``970__a`` :type: ``string`` :pattern: ``^CONF-\d+$`` :minLength: ``1`` .. _conferences.json#/properties/inspire_categories: inspire_categories ++++++++++++++++++ :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **inspire_categories** is: :Reference: :ref:`inspire_field.json#/` .. _conferences.json#/properties/keywords: keywords ++++++++ .. container:: title List of keywords :MARC: ``6531`` and ``695`` (depending on presence of :ref:`conferences.json#/properties/keywords/items/properties/schema`) Keywords give information about the specific contents of the record, much more precisely than :ref:`conferences.json#/properties/inspire_categories`. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **keywords** is: :type: ``object`` :Required: :ref:`conferences.json#/properties/keywords/items/properties/value` **Properties:** :ref:`conferences.json#/properties/keywords/items/properties/schema`, :ref:`conferences.json#/properties/keywords/items/properties/source`, :ref:`conferences.json#/properties/keywords/items/properties/value` .. _conferences.json#/properties/keywords/items/properties/schema: schema ###### .. container:: title Keyword vocabulary Describes to which vocabulary the keyword in :ref:`conferences.json#/properties/keywords/items/properties/value` belongs. ``INSPIRE`` :MARC: ``695__2:INSPIRE`` The keyword has been assigned by Inspire, and belongs to its vocabulary. .. note:: If not present, the keyword is a free-form keyword, not necessarily part of any vocabulary. :type: ``string`` :minLength: ``1`` **Allowed values:** - INSPIRE .. _conferences.json#/properties/keywords/items/properties/source: source ###### :Reference: :ref:`source.json#/` .. _conferences.json#/properties/keywords/items/properties/value: value ##### .. container:: title A keyword :MARC: ``6531__a`` (depending on :ref:`conferences.json#/properties/keywords/items/properties/schema`) It belongs to the vocabulary specified by :ref:`conferences.json#/properties/keywords/items/properties/schema`. :example: ``black hole: mass`` (for :ref:`conferences.json#/properties/keywords/items/properties/schema` = ``INSPIRE``) :type: ``string`` :minLength: ``1`` .. _conferences.json#/properties/legacy_creation_date: legacy_creation_date ++++++++++++++++++++ :type: ``string`` :format: ``date`` :minLength: ``1`` .. _conferences.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`` .. _conferences.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:`conferences.json#/properties/deleted`. :Reference: :ref:`conference.json#/` .. _conferences.json#/properties/opening_date: opening_date ++++++++++++ .. container:: title Conference opening date :MARC: ``111__x`` :type: ``string`` :format: ``date`` :minLength: ``1`` .. _conferences.json#/properties/public_notes: public_notes ++++++++++++ .. container:: title List of public notes :MARC: ``500`` 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:`conferences.json#/properties/_private_notes`. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **public_notes** is: :Reference: :ref:`sourced_value.json#/` .. _conferences.json#/properties/self: self ++++ :Reference: :ref:`conference.json#/` .. _conferences.json#/properties/series: series ++++++ .. container:: title Conference series that this is part of :MARC: ``411`` :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **series** is: :type: ``object`` :Required: :ref:`conferences.json#/properties/series/items/properties/name` **Properties:** :ref:`conferences.json#/properties/series/items/properties/name`, :ref:`conferences.json#/properties/series/items/properties/number` .. _conferences.json#/properties/series/items/properties/name: name #### .. container:: title Name of the conference series ``411__a`` :type: ``string`` :minLength: ``1`` .. _conferences.json#/properties/series/items/properties/number: number ###### .. container:: title Number of the conference in the series ``411__n`` :type: ``integer`` .. _conferences.json#/properties/short_description: short_description +++++++++++++++++ :Reference: :ref:`sourced_value.json#/` .. _conferences.json#/properties/titles: titles ++++++ .. container:: title List of titles of the conference :MARC: ``111__a/b`` :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **titles** is: :Reference: :ref:`title.json#/` .. _conferences.json#/properties/urls: urls ++++ :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **urls** is: :Reference: :ref:`url.json#/`