Agent

The Agent entity represents an individual (e.g., a person, an organisation, or another kind of entity being able to act) who is involved in the creation, publication, dissemination, etc. of a Research product. An Agent can be an author, a reviewer, an editor, a publisher, a researcher, or any other stakeholder involved in the scholarly communication process.

This page describes the metadata fields for an Agent and all its subtypes (i.e., persons and organisations).

Properties

local_identifier

String (mandatory): Unique code identifying an Agent in the SKG (if any, otherwise “stateless identifier”).

Suggestion: Use a URL as a string to make this entity dereferenceable on the Web. For additional information, see the section ‘Local identifiers of entities’ of the Interoperability Framework.

"local_identifier": "https://w3id.org/oc/meta/ra/0614010840729"

identifiers

List (recommended): Objects representing external identifiers for the entity.

Each object is structured as follows:

• scheme String (mandatory): The scheme for the external identifier.
• value String (mandatory): The external identifier.

Note: the current version of SKG-IF includes the types of identifiers (to be specified as strings in the field scheme) as introduced in Section “External identifiers of entities”.

"identifiers": [
    {
        "scheme": "orcid",
        "value": "0000-0002-5193-7851"
    }           
]

entity_type

String (mandatory): Field stating what kind of entity is being serialised.

It can be agent (generic agent), person, or organisation.

"entity_type": "person"

name

String (optional): The string containing whatever concatenation of an Agent name(s).

"name": "Andrea Mannocci, PhD"

given_name

String (optional): The given name of a Person.

"given_name": "Andrea"

family_name

String (optional): The family name of a Person.

"family_name": "Mannocci"

affiliations

List (optional): All the affiliations of a Person (à la ORCID).

Each element of the list is structured as follows:

• affiliation String (mandatory): The identifier of an Organisation a Person is affiliated with.
• role String (recommended): The role that a Person had in the context of an Organisation. Needed for parsing purposes; fixed to affiliate.
• period Object (recommended): The time period where the Person was affiliated with an Organisation. It includes the following information:
  • start String (recommended): The start datetime of the affiliation with an Organisation. The string should be compliant with the ISO 8601 datetime string.
  • end String (recommended): The end datetime (if any) of the affiliation with an Organisation. The string should be compliant with the ISO 8601 datetime string.

"affiliations": [
    {
        "affiliation": "org_1",
        "role": "affiliate",
        "period": {
            "start": "2017-04-13T00:00:00Z",
            "end": "2019-02-11T23:59:59Z"
        }
    },
    {
        "affiliation": "org_2",
        "role": "affiliate",
        "period": {
            "start": "2019-02-12T00:00:00Z"
        }
    }
]

short_name

String (optional): The short name/acronym for an Organisation.

"short_name": "CNR"

other_names

List (optional): Other names, perhaps in different languages, identifying an Organisation.

"other_names": [ 
    "National Research Council",    
    "Conseil National de la Recherche"
]

website

String (optional): The website URL for an Organisation.

"website": "https://www.cnr.it/"

country

String (optional): The country code of an Organisation expressed as ISO 3166-1 alpha-2.

"country": "IT"

types

List (optional): The types of an Organisation.

One or more from the following values:

• archive
• company
• education
• facility
• government
• healthcare
• nonprofit
• funder
• research
• unspecified

"types": ["research"]

---