.. _authors.json#/:

authors
=======

.. container:: title

 A record in the Authors collection

:type: ``object``

:Required: :ref:`authors.json#/properties/name`, :ref:`authors.json#/properties/_collections`

**Properties:** :ref:`authors.json#/properties/$schema`, :ref:`authors.json#/properties/_bucket`, :ref:`authors.json#/properties/_collections`, :ref:`authors.json#/properties/_private_notes`, :ref:`authors.json#/properties/acquisition_source`, :ref:`authors.json#/properties/advisors`, :ref:`authors.json#/properties/arxiv_categories`, :ref:`authors.json#/properties/awards`, :ref:`authors.json#/properties/birth_date`, :ref:`authors.json#/properties/control_number`, :ref:`authors.json#/properties/death_date`, :ref:`authors.json#/properties/deleted`, :ref:`authors.json#/properties/deleted_records`, :ref:`authors.json#/properties/email_addresses`, :ref:`authors.json#/properties/ids`, :ref:`authors.json#/properties/inspire_categories`, :ref:`authors.json#/properties/legacy_creation_date`, :ref:`authors.json#/properties/legacy_version`, :ref:`authors.json#/properties/name`, :ref:`authors.json#/properties/new_record`, :ref:`authors.json#/properties/positions`, :ref:`authors.json#/properties/project_membership`, :ref:`authors.json#/properties/public_notes`, :ref:`authors.json#/properties/self`, :ref:`authors.json#/properties/status`, :ref:`authors.json#/properties/stub`, :ref:`authors.json#/properties/urls`


.. _authors.json#/properties/$schema:

$schema
+++++++

:type: ``string``

:format: ``uri``

:minLength: ``1``


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


.. _authors.json#/properties/_collections:

_collections
++++++++++++

.. container:: title

 Collections to which record belongs

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **_collections**  is:

:type: ``string``

:minLength: ``1``

**Allowed values:** 

- Authors


.. _authors.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#/`


.. _authors.json#/properties/acquisition_source:

acquisition_source
++++++++++++++++++

:Reference: :ref:`acquisition_source.json#/`


.. _authors.json#/properties/advisors:

advisors
++++++++

.. container:: title

 List of advisors

:MARC: ``701``

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **advisors**  is:

:type: ``object``

:Required: :ref:`authors.json#/properties/advisors/items/properties/name`

**Properties:** :ref:`authors.json#/properties/advisors/items/properties/curated_relation`, :ref:`authors.json#/properties/advisors/items/properties/degree_type`, :ref:`authors.json#/properties/advisors/items/properties/hidden`, :ref:`authors.json#/properties/advisors/items/properties/ids`, :ref:`authors.json#/properties/advisors/items/properties/name`, :ref:`authors.json#/properties/advisors/items/properties/record`


.. _authors.json#/properties/advisors/items/properties/curated_relation:

curated_relation
################

:type: ``boolean``


.. _authors.json#/properties/advisors/items/properties/degree_type:

degree_type
###########

:MARC: ``701__g``

:Reference: :ref:`degree_type.json#/`


.. _authors.json#/properties/advisors/items/properties/hidden:

hidden
######

Whether this advisor should be hidden

:type: ``boolean``


.. _authors.json#/properties/advisors/items/properties/ids:

ids
###

.. container:: title

 List of advisor's IDs

:MARC: ``701__i``

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **ids**  is:

:Reference: :ref:`id.json#/`


.. _authors.json#/properties/advisors/items/properties/name:

name
####

:MARC: ``701__a``

The full name of the advisor, written in the
standard ``last names, first names`` form.

:example: ``Smith, John P.S.``

:type: ``string``

:pattern: ``^[^``, ``]+(``, ``[^``, ``]+)?(``, ``?[^``, ``]+)?$``

:minLength: ``1``


.. _authors.json#/properties/advisors/items/properties/record:

record
######

:Reference: :ref:`author.json#/`


.. _authors.json#/properties/arxiv_categories:

arxiv_categories
++++++++++++++++

.. container:: title

 List of research areas of author

: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#/`


.. _authors.json#/properties/awards:

awards
++++++

.. container:: title

 List of awards received by the author

:MARC: ``678``

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **awards**  is:

.. container:: title

 An award

:type: ``object``

**Properties:** :ref:`authors.json#/properties/awards/items/properties/name`, :ref:`authors.json#/properties/awards/items/properties/url`, :ref:`authors.json#/properties/awards/items/properties/year`


.. _authors.json#/properties/awards/items/properties/name:

name
####

.. container:: title

 Name of the award

:MARC: ``678__a`` (also contains :ref:`authors.json#/properties/awards/items/properties/year`).
:example: ``Nobel Prize in Physics``

:type: ``string``

:minLength: ``1``


.. _authors.json#/properties/awards/items/properties/url:

url
###

.. container:: title

 URL of award announcement

:MARC: ``678__u``

:Reference: :ref:`url.json#/`


.. _authors.json#/properties/awards/items/properties/year:

year
####

.. container:: title

 Year of the award

:MARC: ``678__a`` (also contains :ref:`authors.json#/properties/awards/items/properties/name`).

:type: ``integer``

:minimum: ``1000``

:maximum: ``2050``


.. _authors.json#/properties/birth_date:

birth_date
++++++++++

:MARC: ``100__d`` (first part)

:type: ``string``

:format: ``date``

:minLength: ``1``


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


.. _authors.json#/properties/death_date:

death_date
++++++++++

:MARC: ``100__d`` (second part)

See also :ref:`authors.json#/properties/status` ``deceased``.

:type: ``string``

:format: ``date``

:minLength: ``1``


.. _authors.json#/properties/deleted:

deleted
+++++++

.. container:: title

 Whether this record has been deleted

:MARC: ``980__a/c:deleted``

:type: ``boolean``


.. _authors.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:`authors.json#/properties/new_record`.

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **deleted_records**  is:

:Reference: :ref:`author.json#/`


.. _authors.json#/properties/email_addresses:

email_addresses
+++++++++++++++

.. container:: title

 List of email addresses

:MARC: ``371__m/o``, ``595__m/o``

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **email_addresses**  is:

:type: ``object``

:Required: :ref:`authors.json#/properties/email_addresses/items/properties/value`

**Properties:** :ref:`authors.json#/properties/email_addresses/items/properties/current`, :ref:`authors.json#/properties/email_addresses/items/properties/hidden`, :ref:`authors.json#/properties/email_addresses/items/properties/value`


.. _authors.json#/properties/email_addresses/items/properties/current:

current
#######

.. container:: title

 Whether this address is still in use

:MARC: if ``true``, the email comes from ``m``, if
    ``false``, from ``o``.

:type: ``boolean``


.. _authors.json#/properties/email_addresses/items/properties/hidden:

hidden
######

.. container:: title

 Whether this address should be hidden

:MARC: if ``true``, the email comes from ``371``, if
    ``false``, from ``595``.

Email addresses might be considered sensitive
information and hidden at the user's request.

:type: ``boolean``


.. _authors.json#/properties/email_addresses/items/properties/value:

value
#####

.. container:: title

 An email address

:type: ``string``

:format: ``email``

:minLength: ``1``


.. _authors.json#/properties/ids:

ids
+++

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **ids**  is:

:Reference: :ref:`id.json#/`


.. _authors.json#/properties/inspire_categories:

inspire_categories
++++++++++++++++++

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **inspire_categories**  is:

:Reference: :ref:`inspire_field.json#/`


.. _authors.json#/properties/legacy_creation_date:

legacy_creation_date
++++++++++++++++++++

:type: ``string``

:format: ``date``

:minLength: ``1``


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


.. _authors.json#/properties/name:

name
++++

.. container:: title

 Name information of the author

:MARC: ``100``, ``400``, ``880``

:type: ``object``

:Required: :ref:`authors.json#/properties/name/properties/value`

**Properties:** :ref:`authors.json#/properties/name/properties/name_variants`, :ref:`authors.json#/properties/name/properties/native_names`, :ref:`authors.json#/properties/name/properties/numeration`, :ref:`authors.json#/properties/name/properties/preferred_name`, :ref:`authors.json#/properties/name/properties/previous_names`, :ref:`authors.json#/properties/name/properties/title`, :ref:`authors.json#/properties/name/properties/value`


.. _authors.json#/properties/name/properties/name_variants:

name_variants
#############

.. container:: title

 List of name variants

Contains other variations (besides `preferred_name`) of the
author name in `value` that are in use.

These could be:

- other spellings;
- other transliterations from the :ref:`authors.json#/properties/name/properties/native_names` to the
  Latin alphabet;
- other splittings among last names and first names;
- combinations with :ref:`authors.json#/properties/name/properties/previous_names`.

:example: ``Smith-Taylor, Johnny``
:MARC: ``400__a``

:type: ``array``

:pattern: ``^[^``, ``]+(``, ``[^``, ``]+)?(``, ``?[^``, ``]+)?$``

:minItems: ``1``

.. container:: sub-title

 Every element of **name_variants**  is:

:type: ``string``

:minLength: ``1``


.. _authors.json#/properties/name/properties/native_names:

native_names
############

Native names of the author, not using the Latin alphabet.

:example: ``楼 立洋``
:MARC: ``880__a``

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **native_names**  is:

:type: ``string``

:minLength: ``1``


.. _authors.json#/properties/name/properties/numeration:

numeration
##########

:MARC: ``100__b``

:type: ``string``

:minLength: ``1``

**Allowed values:** 

- Jr.
- Sr.
- I
- II
- III
- IV
- VI
- VII
- VIII


.. _authors.json#/properties/name/properties/preferred_name:

preferred_name
##############

differs from the full name in `value`. This should use Latin alphabet.

:example: ``Smith, John``
:MARC: ``100__q``

:type: ``string``

:minLength: ``1``


.. _authors.json#/properties/name/properties/previous_names:

previous_names
##############

.. container:: title

 List of previous names

Contains previous names of the author, e.g. the maiden
name.

:example: ``Taylor, Jonathan Gerald C.T.``
:MARC: no field for this, was put into ``667__a`` as a note.

:type: ``array``

:pattern: ``^[^``, ``]+(``, ``[^``, ``]+)?(``, ``?[^``, ``]+)?$``

:minItems: ``1``

.. container:: sub-title

 Every element of **previous_names**  is:

:type: ``string``

:minLength: ``1``


.. _authors.json#/properties/name/properties/title:

title
#####

:MARC: ``100__c``

:type: ``string``

:minLength: ``1``

**Allowed values:** 

- Sir


.. _authors.json#/properties/name/properties/value:

value
#####

.. container:: title

 Full name of the author

Author name in Latin alphabet (may contain diacritics). The
format should be ``last names, first names``. If not all
names are known, initials should be followed by a `.`
without space.

.. note::

    Not all authors have two names, so only one name
    without a comma is perfectly valid.

    :example: ``Jimmy``

:example: ``Smith Davis, Jonathan Gerald C.T.``
:MARC: ``100__a``

:type: ``string``

:pattern: ``^[^``, ``]+(``, ``[^``, ``]+)?(``, ``?[^``, ``]+)?$``

:minLength: ``1``


.. _authors.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:`authors.json#/properties/deleted`.

:Reference: :ref:`author.json#/`


.. _authors.json#/properties/positions:

positions
+++++++++

:MARC: ``371``

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **positions**  is:

:type: ``object``

:Required: :ref:`authors.json#/properties/positions/items/properties/institution`

**Properties:** :ref:`authors.json#/properties/positions/items/properties/curated_relation`, :ref:`authors.json#/properties/positions/items/properties/current`, :ref:`authors.json#/properties/positions/items/properties/end_date`, :ref:`authors.json#/properties/positions/items/properties/hidden`, :ref:`authors.json#/properties/positions/items/properties/institution`, :ref:`authors.json#/properties/positions/items/properties/rank`, :ref:`authors.json#/properties/positions/items/properties/record`, :ref:`authors.json#/properties/positions/items/properties/start_date`


.. _authors.json#/properties/positions/items/properties/curated_relation:

curated_relation
################

:type: ``boolean``


.. _authors.json#/properties/positions/items/properties/current:

current
#######

:MARC: ``371__z:current`` corresponds to ``true``

:type: ``boolean``


.. _authors.json#/properties/positions/items/properties/end_date:

end_date
########

:MARC: ``371__t``

:type: ``string``

:format: ``date``

:minLength: ``1``


.. _authors.json#/properties/positions/items/properties/hidden:

hidden
######

Whether this position should be hidden

:type: ``boolean``


.. _authors.json#/properties/positions/items/properties/institution:

institution
###########

:MARC: ``371__a``

:type: ``string``

:minLength: ``1``


.. _authors.json#/properties/positions/items/properties/rank:

rank
####

:MARC: ``371__r``

:Reference: :ref:`rank.json#/`


.. _authors.json#/properties/positions/items/properties/record:

record
######

URI for the institution record

:Reference: :ref:`institution.json#/`


.. _authors.json#/properties/positions/items/properties/start_date:

start_date
##########

:MARC: ``371__s``

:type: ``string``

:format: ``date``

:minLength: ``1``


.. _authors.json#/properties/project_membership:

project_membership
++++++++++++++++++

.. container:: title

 List of projects on which the author worked

:MARC: ``693``

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **project_membership**  is:

:type: ``object``

:Required: :ref:`authors.json#/properties/project_membership/items/properties/name`

**Properties:** :ref:`authors.json#/properties/project_membership/items/properties/curated_relation`, :ref:`authors.json#/properties/project_membership/items/properties/current`, :ref:`authors.json#/properties/project_membership/items/properties/end_date`, :ref:`authors.json#/properties/project_membership/items/properties/hidden`, :ref:`authors.json#/properties/project_membership/items/properties/name`, :ref:`authors.json#/properties/project_membership/items/properties/record`, :ref:`authors.json#/properties/project_membership/items/properties/start_date`


.. _authors.json#/properties/project_membership/items/properties/curated_relation:

curated_relation
################

:type: ``boolean``


.. _authors.json#/properties/project_membership/items/properties/current:

current
#######

.. container:: title

 Whether the author is still involved in it

:MARC: ``693__z`` corresponds to ``true``

:type: ``boolean``


.. _authors.json#/properties/project_membership/items/properties/end_date:

end_date
########

:MARC: ``693__d``

Date the author stopped working on this project.

:type: ``string``

:format: ``date``

:minLength: ``1``


.. _authors.json#/properties/project_membership/items/properties/hidden:

hidden
######

Whether this project should be hidden

:type: ``boolean``


.. _authors.json#/properties/project_membership/items/properties/name:

name
####

:MARC: ``693__e``

Name of the project.

:type: ``string``

:minLength: ``1``


.. _authors.json#/properties/project_membership/items/properties/record:

record
######

URI for the experiment record

:Reference: :ref:`experiment.json#/`


.. _authors.json#/properties/project_membership/items/properties/start_date:

start_date
##########

:MARC: ``693__s``

Date the author started working on this project.

:type: ``string``

:format: ``date``

:minLength: ``1``


.. _authors.json#/properties/public_notes:

public_notes
++++++++++++

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **public_notes**  is:

:Reference: :ref:`sourced_value.json#/`


.. _authors.json#/properties/self:

self
++++

.. container:: title

 Url of the record

Url of the record itself

:Reference: :ref:`author.json#/`


.. _authors.json#/properties/status:

status
++++++

The person's status

:type: ``string``

:minLength: ``1``

**Allowed values:** 

- active
- deceased
- departed
- retired


.. _authors.json#/properties/stub:

stub
++++

:type: ``boolean``


.. _authors.json#/properties/urls:

urls
++++

:type: ``array``

:minItems: ``1``

.. container:: sub-title

 Every element of **urls**  is:

:Reference: :ref:`url.json#/`