authors

A record in the Authors collection
type:object
Required:name, _collections

Properties: $schema, _bucket, _collections, _private_notes, acquisition_source, advisors, arxiv_categories, awards, birth_date, control_number, death_date, deleted, deleted_records, email_addresses, ids, inspire_categories, legacy_creation_date, legacy_version, name, new_record, positions, project_membership, public_notes, self, status, stub, urls

$schema

type:string
format:uri
minLength:1

_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

_collections

Collections to which record belongs
type:array
minItems:1
Every element of _collections is:
type:string
minLength:1

Allowed values:

  • Authors

_private_notes

List of private notes
MARC:595

These notes are only visible to privileged users, not regular users.

type:array
minItems:1
Every element of _private_notes is:
Reference:sourced_value

acquisition_source

Reference:acquisition_source

advisors

List of advisors
MARC:701
type:array
minItems:1
Every element of advisors is:
type:object
Required:name

Properties: curated_relation, degree_type, hidden, ids, name, record

curated_relation

type:boolean

degree_type

MARC:701__g
Reference:degree_type

hidden

Whether this advisor should be hidden

type:boolean

ids

List of advisor’s IDs
MARC:701__i
type:array
minItems:1
Every element of ids is:
Reference:id

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

record

Reference:author

arxiv_categories

List of research areas of author
MARC:65017a when it contains an arXiv category.
type:array
minItems:1
Every element of arxiv_categories is:
Reference:arxiv_categories

awards

List of awards received by the author
MARC:678
type:array
minItems:1
Every element of awards is:
An award
type:object

Properties: name, url, year

name

Name of the award
MARC:678__a (also contains year).
example:Nobel Prize in Physics
type:string
minLength:1

url

URL of award announcement
MARC:678__u
Reference:url

year

Year of the award
MARC:678__a (also contains name).
type:integer
minimum:1000
maximum:2050

birth_date

MARC:100__d (first part)
type:string
format:date
minLength:1

control_number

ID of current record
MARC:001

Read-only field. Also called record ID or recid.

type:integer

death_date

MARC:100__d (second part)

See also status deceased.

type:string
format:date
minLength:1

deleted

Whether this record has been deleted
MARC:980__a/c:deleted
type:boolean

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 new_record.

type:array
minItems:1
Every element of deleted_records is:
Reference:author

email_addresses

List of email addresses
MARC:371__m/o, 595__m/o
type:array
minItems:1
Every element of email_addresses is:
type:object
Required:value

Properties: current, hidden, value

current

Whether this address is still in use
MARC:if true, the email comes from m, if false, from o.
type:boolean

hidden

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

value

An email address
type:string
format:email
minLength:1

ids

type:array
minItems:1
Every element of ids is:
Reference:id

inspire_categories

type:array
minItems:1
Every element of inspire_categories is:
Reference:inspire_field

legacy_creation_date

type:string
format:date
minLength:1

legacy_version

Last record update
MARC:005

Used to indicate the version of the record on legacy.

type:string
minLength:1

name

Name information of the author
MARC:100, 400, 880
type:object
Required:value

Properties: name_variants, native_names, numeration, preferred_name, previous_names, title, value

name_variants

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 native_names to the Latin alphabet;
  • other splittings among last names and first names;
  • combinations with previous_names.
example:Smith-Taylor, Johnny
MARC:400__a
type:array
pattern:^[^, ]+(, [^, ]+)?(, ?[^, ]+)?$
minItems:1
Every element of name_variants is:
type:string
minLength:1

native_names

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

example: 立洋
MARC:880__a
type:array
minItems:1
Every element of native_names is:
type:string
minLength:1

numeration

MARC:100__b
type:string
minLength:1

Allowed values:

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

preferred_name

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

example:Smith, John
MARC:100__q
type:string
minLength:1

previous_names

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
Every element of previous_names is:
type:string
minLength:1

title

MARC:100__c
type:string
minLength:1

Allowed values:

  • Sir

value

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

new_record

Record replacing this one
MARC:970__d

Contains a reference to the record replacing the current one, if it is marked as deleted.

Reference:author

positions

MARC:371
type:array
minItems:1
Every element of positions is:
type:object
Required:institution

Properties: curated_relation, current, end_date, hidden, institution, rank, record, start_date

curated_relation

type:boolean

current

MARC:371__z:current corresponds to true
type:boolean

end_date

MARC:371__t
type:string
format:date
minLength:1

hidden

Whether this position should be hidden

type:boolean

institution

MARC:371__a
type:string
minLength:1

rank

MARC:371__r
Reference:rank

record

URI for the institution record

Reference:institution

start_date

MARC:371__s
type:string
format:date
minLength:1

project_membership

List of projects on which the author worked
MARC:693
type:array
minItems:1
Every element of project_membership is:
type:object
Required:name

Properties: curated_relation, current, end_date, hidden, name, record, start_date

curated_relation

type:boolean

current

Whether the author is still involved in it
MARC:693__z corresponds to true
type:boolean

end_date

MARC:693__d

Date the author stopped working on this project.

type:string
format:date
minLength:1

hidden

Whether this project should be hidden

type:boolean

name

MARC:693__e

Name of the project.

type:string
minLength:1

record

URI for the experiment record

Reference:experiment

start_date

MARC:693__s

Date the author started working on this project.

type:string
format:date
minLength:1

public_notes

type:array
minItems:1
Every element of public_notes is:
Reference:sourced_value

self

Url of the record

Url of the record itself

Reference:author

status

The person’s status

type:string
minLength:1

Allowed values:

  • active
  • deceased
  • departed
  • retired

stub

type:boolean

urls

type:array
minItems:1
Every element of urls is:
Reference:url