.. _jobs.json#/: jobs ==== .. container:: title A record in the Jobs collection :type: ``object`` :Required: :ref:`jobs.json#/properties/_collections`, :ref:`jobs.json#/properties/deadline_date`, :ref:`jobs.json#/properties/description`, :ref:`jobs.json#/properties/position`, :ref:`jobs.json#/properties/regions`, :ref:`jobs.json#/properties/status` **Properties:** :ref:`jobs.json#/properties/$schema`, :ref:`jobs.json#/properties/_bucket`, :ref:`jobs.json#/properties/_collections`, :ref:`jobs.json#/properties/_private_notes`, :ref:`jobs.json#/properties/accelerator_experiments`, :ref:`jobs.json#/properties/acquisition_source`, :ref:`jobs.json#/properties/arxiv_categories`, :ref:`jobs.json#/properties/contact_details`, :ref:`jobs.json#/properties/control_number`, :ref:`jobs.json#/properties/deadline_date`, :ref:`jobs.json#/properties/deleted`, :ref:`jobs.json#/properties/deleted_records`, :ref:`jobs.json#/properties/description`, :ref:`jobs.json#/properties/external_job_identifier`, :ref:`jobs.json#/properties/external_system_identifiers`, :ref:`jobs.json#/properties/institutions`, :ref:`jobs.json#/properties/legacy_creation_date`, :ref:`jobs.json#/properties/legacy_version`, :ref:`jobs.json#/properties/new_record`, :ref:`jobs.json#/properties/position`, :ref:`jobs.json#/properties/public_notes`, :ref:`jobs.json#/properties/ranks`, :ref:`jobs.json#/properties/reference_letters`, :ref:`jobs.json#/properties/regions`, :ref:`jobs.json#/properties/self`, :ref:`jobs.json#/properties/status`, :ref:`jobs.json#/properties/urls` .. _jobs.json#/properties/$schema: $schema +++++++ :type: ``string`` :format: ``uri`` :minLength: ``1`` .. _jobs.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`` .. _jobs.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:** - Jobs .. _jobs.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#/` .. _jobs.json#/properties/accelerator_experiments: accelerator_experiments +++++++++++++++++++++++ .. container:: title List of related accelerators/experiments :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **accelerator_experiments** is: :type: ``object`` **Properties:** :ref:`jobs.json#/properties/accelerator_experiments/items/properties/accelerator`, :ref:`jobs.json#/properties/accelerator_experiments/items/properties/curated_relation`, :ref:`jobs.json#/properties/accelerator_experiments/items/properties/experiment`, :ref:`jobs.json#/properties/accelerator_experiments/items/properties/institution`, :ref:`jobs.json#/properties/accelerator_experiments/items/properties/legacy_name`, :ref:`jobs.json#/properties/accelerator_experiments/items/properties/record` .. _jobs.json#/properties/accelerator_experiments/items/properties/accelerator: accelerator ########### :MARC: ``693__a`` If present, :ref:`jobs.json#/properties/accelerator_experiments/items/properties/institution` should contain the institution where this accelerator is located. .. note:: Currently not used, see :ref:`jobs.json#/properties/accelerator_experiments/items/properties/legacy_name`. :type: ``string`` :minLength: ``1`` .. _jobs.json#/properties/accelerator_experiments/items/properties/curated_relation: curated_relation ################ :type: ``boolean`` :default: ``False`` .. _jobs.json#/properties/accelerator_experiments/items/properties/experiment: experiment ########## :MARC: not present. If present, :ref:`jobs.json#/properties/accelerator_experiments/items/properties/institution` should contain the institution where this experiment is located and :ref:`jobs.json#/properties/accelerator_experiments/items/properties/accelerator` may contain the accelerator that this experiment is using (if appropriate). .. note:: Currently not used, see :ref:`jobs.json#/properties/accelerator_experiments/items/properties/legacy_name`. :type: ``string`` :minLength: ``1`` .. _jobs.json#/properties/accelerator_experiments/items/properties/institution: institution ########### .. container:: title Institution hosting the experiment :MARC: not present. .. note:: Currently not used, see :ref:`jobs.json#/properties/accelerator_experiments/items/properties/legacy_name`. :type: ``string`` :minLength: ``1`` .. _jobs.json#/properties/accelerator_experiments/items/properties/legacy_name: legacy_name ########### .. container:: title Identifier of the experiment on legacy :MARC: ``693__e`` This field is used when migrating from legacy instead of separate :ref:`jobs.json#/properties/accelerator_experiments/items/properties/institution`, :ref:`jobs.json#/properties/accelerator_experiments/items/properties/accelerator` and :ref:`jobs.json#/properties/accelerator_experiments/items/properties/experiment`. In the future, it will be deprecated and the other fields will be used instead. :example: ``CERN-LHC-CMS`` :type: ``string`` :minLength: ``1`` .. _jobs.json#/properties/accelerator_experiments/items/properties/record: record ###### :Reference: :ref:`experiment.json#/` .. _jobs.json#/properties/acquisition_source: acquisition_source ++++++++++++++++++ :Reference: :ref:`acquisition_source.json#/` .. _jobs.json#/properties/arxiv_categories: arxiv_categories ++++++++++++++++ .. container:: title List of research areas for the job :MARC: ``65017a`` when it contains an arXiv category. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **arxiv_categories** is: :Reference: :ref:`arxiv_categories.json#/` .. _jobs.json#/properties/contact_details: contact_details +++++++++++++++ :MARC: ``270__m/p`` Contact information for questions from applicants regarding the job opening. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **contact_details** is: :Reference: :ref:`contact.json#/` .. _jobs.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`` .. _jobs.json#/properties/deadline_date: deadline_date +++++++++++++ .. container:: title Application deadline :MARC: ``046__i`` :type: ``string`` :format: ``date`` :minLength: ``1`` .. _jobs.json#/properties/deleted: deleted +++++++ .. container:: title Whether this record has been deleted :MARC: ``980__a/c:deleted`` :type: ``boolean`` .. _jobs.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:`jobs.json#/properties/new_record`. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **deleted_records** is: :Reference: :ref:`job.json#/` .. _jobs.json#/properties/description: description +++++++++++ .. container:: title Job description :MARC: ``520__a`` This may contain rich text in a subset of HTML. :type: ``string`` :minLength: ``1`` .. _jobs.json#/properties/external_job_identifier: external_job_identifier +++++++++++++++++++++++ :MARC: ``245__a`` (in parentheses) Identifier used for the job posting. :example: ``TH-SP-2019-LD`` :type: ``string`` :minLength: ``1`` .. _jobs.json#/properties/external_system_identifiers: external_system_identifiers +++++++++++++++++++++++++++ :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **external_system_identifiers** is: May satisfy *any* of the following definitions: .. _jobs.json#/properties/external_system_identifiers/items/anyOf/0: 0 # :type: ``object`` :Required: :ref:`jobs.json#/properties/external_system_identifiers/items/anyOf/0/properties/schema`, :ref:`jobs.json#/properties/external_system_identifiers/items/anyOf/0/properties/value` **Properties:** :ref:`jobs.json#/properties/external_system_identifiers/items/anyOf/0/properties/schema`, :ref:`jobs.json#/properties/external_system_identifiers/items/anyOf/0/properties/value` .. _jobs.json#/properties/external_system_identifiers/items/anyOf/0/properties/schema: schema >>>>>> :type: ``string`` :minLength: ``1`` **Allowed values:** - SPIRES .. _jobs.json#/properties/external_system_identifiers/items/anyOf/0/properties/value: value >>>>> :type: ``string`` :pattern: ``^JOBS-\d+$`` :minLength: ``1`` .. _jobs.json#/properties/institutions: institutions ++++++++++++ .. container:: title Institutions opening a position :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **institutions** is: :type: ``object`` :Required: :ref:`jobs.json#/properties/institutions/items/properties/value` **Properties:** :ref:`jobs.json#/properties/institutions/items/properties/curated_relation`, :ref:`jobs.json#/properties/institutions/items/properties/record`, :ref:`jobs.json#/properties/institutions/items/properties/value` .. _jobs.json#/properties/institutions/items/properties/curated_relation: curated_relation ################ :type: ``boolean`` .. _jobs.json#/properties/institutions/items/properties/record: record ###### :Reference: :ref:`institution.json#/` .. _jobs.json#/properties/institutions/items/properties/value: value ##### .. container:: title ICN of institution :MARC: ``110__a`` Currently, the old :ref:`institutions.json#/properties/legacy_ICN` is used here. In the future, this will change and become the new :ref:`institutions.json#/properties/ICN`. :type: ``string`` :minLength: ``1`` .. _jobs.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`` .. _jobs.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`` .. _jobs.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:`jobs.json#/properties/deleted`. :Reference: :ref:`job.json#/` .. _jobs.json#/properties/position: position ++++++++ .. container:: title Position title :MARC: ``245__a`` :type: ``string`` :minLength: ``1`` .. _jobs.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:`jobs.json#/properties/_private_notes`. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **public_notes** is: :Reference: :ref:`sourced_value.json#/` .. _jobs.json#/properties/ranks: ranks +++++ :MARC: ``656__a`` Ranks at which the successful applicant may be hired. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **ranks** is: :Reference: :ref:`rank.json#/` .. _jobs.json#/properties/reference_letters: reference_letters +++++++++++++++++ .. container:: title Where to send the reference letters :type: ``object`` **Properties:** :ref:`jobs.json#/properties/reference_letters/properties/emails`, :ref:`jobs.json#/properties/reference_letters/properties/urls` .. _jobs.json#/properties/reference_letters/properties/emails: emails ###### :MARC: ``270__o`` (if email address) Email addresses where reference letters should be sent. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **emails** is: :type: ``string`` :format: ``email`` :minLength: ``1`` .. _jobs.json#/properties/reference_letters/properties/urls: urls #### :MARC: ``270__o`` (if URL) URLs to websites where the reference letters should be uploaded. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **urls** is: :Reference: :ref:`url.json#/` .. _jobs.json#/properties/regions: regions +++++++ :MARC: ``043__a`` World regions where the position is located. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **regions** is: :type: ``string`` :minLength: ``1`` **Allowed values:** - Africa - Australasia - Asia - Europe - Middle East - North America - South America .. _jobs.json#/properties/self: self ++++ .. container:: title Url of the record Url of the record itself :Reference: :ref:`job.json#/` .. _jobs.json#/properties/status: status ++++++ :MARC: Not present Status of the current job posting. This can be: ``open`` The job posting is open and welcomes applications. ``closed`` The job posting is closed and it is not possible to apply. ``pending`` The job posting has been submitted to INSPIRE and needs to be approved for display. :type: ``string`` :minLength: ``1`` **Allowed values:** - closed - open - pending .. _jobs.json#/properties/urls: urls ++++ :MARC: ``8564`` URLs of web pages related to this job posting. :type: ``array`` :minItems: ``1`` .. container:: sub-title Every element of **urls** is: :Reference: :ref:`url.json#/`