Persons

The Person entity represents an individual who is involved in the creation, publication, and dissemination of Research products. A Person can be an author, a reviewer, an editor, a publisher, a researcher, or any other stakeholder involved in the scholarly communication process.

This section describes the metadata fields for the Person.

local_identifier

String (mandatory): Unique code identifiying the Person in the SKG (if any, otherwise “stateless identifier”).

1 "local_identifier": "the_id"

identifiers

List (optional): A list of objects representing external identifiers for the entity. Each object is structured as follows.

  • scheme String (mandatory): The scheme for the external identifier (e.g., ORCID).

  • value String (mandatory): The external identifier.

1 "identifiers": [
2     {
3         "scheme": "orcid"
4         "value": "000-0002-5193-7851"
5     }
6 ]

given_name

String (mandatory, unless an agent or a fullname is indicated): The given name of a Person.

1 "given_name": "John"

family_name

String (mandatory, unless an agent or a fullname is indicated): The family name of a Person.

1 "family_name": "Doe"

fullname

String (optional, unless given_name and family_name are not present, or an agent is not indicated): The string containing whatever concatenation of a Person’s name(s) and surnames(s).

1 "fullname": "John M. Doe"

agent

String (optional, unless all name properties are missing): The name of an agent (e.g., a collective name or a legal entity).

1 "agent": "Data curation team"

affiliations

List (optional): A list of all the affiliations of a Person (à la ORCID). Each element of the list is structured as follows:

  • organisation String (mandatory): The identifier of the Organisation a Person is affiliated with.

  • start_date String (recommended): The start date of the affiliation with the Organisation. It adheres to ISO 8601.

  • end_date String (optional): The end day (if any) of the affiliation with the Organisation. It adheres to ISO 8601.

 1 "affiliations": [
 2     {
 3         "organisation": "org2",
 4         "start_date": "2015-01-01",
 5         "end_date": "2017-01-01"
 6     },
 7     {
 8         "organisation": "org3",
 9         "start_date": "2017-01-01",
10         "end_date": "2019-01-01"
11     }
12 ]