Person

Validate against: http://json-schema.org/draft-07/schema#

Schema ID: http://schemas.digitallinguistics.io/Person-4.2.0.json

Type: object

Description

An object providing information about a Person

Developer Notes

This is a top-level database object

Required Properties

  • familyName
  • givenName

Properties

The following properties are defined for this object:

  • Type: type

    Type: string

    Read-only: true

    Description

    The type of object. Must be set to Person.

    This item must have the following value:

    "Person"
  • ID: id

    Description

    A unique database identifier for this Person

  • Abbreviation: abbreviation

    Type: string

    Description

    An abbreviation for this person (typically their initials). If a pseudonym is used for this person, use the initials of the pseudonym rather than their actual initials.

    Referenced Schema

    This item must validate against the following schema:

    http://schemas.digitallinguistics.io/Abbreviation.json

  • Access Rights: access

    Type: object

    Description

    The access rights for information about this person

    Referenced Schema

    This item must validate against the following schema:

    http://schemas.digitallinguistics.io/Access.json

  • Address: address

    Type: object

    Description

    The address for this person

    Referenced Schema

    This item must validate against the following schema:

    http://schemas.digitallinguistics.io/Address.json

  • Birth Date: birthDate

    Type: string

    Description

    This person’s birth date, in internet date time format

    Format: date

  • Birth Place (Database Reference): birthPlace

    Type: object

    Description

    A database reference to this person’s place of birth, as a Location object

    Referenced Schema

    This item must validate against the following schema:

    http://schemas.digitallinguistics.io/DatabaseReference.json

  • Email: email

    Type: string

    Description

    This person’s email

    Format: email

  • Family Name(s) / Last Name(s): familyName

    Type: string

    Description

    This person’s family name(s) (last name(s))

  • Gender: gender

    Type: string

    Description

    This person’s self-reported gender identity

  • Given Name(s) / First Name(s): givenName

    Type: string

    Description

    This person’s given name(s) (first name(s)), including middle name(s), if any

  • Languages Spoken: languages

    Type: array

    Description

    A list of the languages that this person speaks. Each item should be a DLx Language object, optionally with a few additional properties such as ageLearned, etc., Because the DLx Language object consist minimally of just the language name, not all details about the language need to be provided here.

    Items must be unique: true

    Items

    Each item in this array must adhere to the following schema:

    Language Spoken: languages

    This item must also validate against all of the following schemas:

    • Language

      Type: object

      Description

      Each item in the languages Array must be a valid Language object

      Referenced Schema

      This item must validate against the following schema:

      http://schemas.digitallinguistics.io/Language.json

    • Properties

      The following properties are defined for this object:

      • Age Learned: ageLearned

        Type: integer

        Description

        The age at which this person learned this language

        Minimum: 0

      • Notes: notes

        Type: array

        Description

        Notes about this person’s use of this language

        Items must be unique: true

        Items

        Each item in this array must adhere to the following schema:

        Note: notes

        Type: object

        Description

        A note about this person’s use of this language

        Referenced Schema

        This item must validate against the following schema:

        http://schemas.digitallinguistics.io/Note.json

      • Proficiency: proficiency

        Type: string

        Description

        The proficiency level of this person in this Language

      • Years Known: yearsKnown

        Type: integer

        Description

        The number of years this person has known this Language

      Additional Properties

      Any additional properties must adhere to the following schema:

      This schema imposes no restrictions. All values are valid.

  • Link: link

    Type: string

    Description

    A URL where a presentational format for this resource may be viewed

    Format: uri

  • Notes: notes

    Type: array

    Description

    An array of notes about this person

    Items must be unique: true

    Items

    Each item in this array must adhere to the following schema:

    Note: notes

    Type: object

    Description

    A note about this person

    Referenced Schema

    This item must validate against the following schema:

    http://schemas.digitallinguistics.io/Note.json

  • Phone Number: phone

    Type: string

    Description

    A phone number for this Person

  • Pseudonym: pseudonym

    Type: string

    Description

    A pseudonym for this Person

  • Roles: roles

    Type: array

    Description

    An array of the roles that this person has in the context of the associated data, e.g. speaker or transcriber

    Items must be unique: true

    Items

    Each item in this array must adhere to the following schema:

    Role: roles

    Type: string

    Description

    The role that this person has in the context of the associated data, e.g. speaker or transcriber

    Minimum length: 1

  • Tags: tags

    Type: object

    Description

    A set of tags for this Person

    Referenced Schema

    This item must validate against the following schema:

    http://schemas.digitallinguistics.io/Tags.json

  • URL: url

    Type: string

    Description

    The URL where the JSON data for this Person may be accessed

    Format: uri

Additional Properties

Any additional properties must adhere to the following schema:

This schema imposes no restrictions. All values are valid.

Examples

The following are example values for this schema:

  • {
      "abbreviation": "BP",
      "access": {
        "notes": "No access restrictions on this person's data."
      },
      "birthDate": "1867-01-01",
      "dateCreated": "2018-10-05T15:26:23.070Z",
      "dateModified": "2018-10-05T15:26:23.070Z",
      "familyName": "Paul",
      "gender": "male",
      "givenName": "Benjamin",
      "id": "46d3ad45-d1b8-4656-b496-dcb39203c5a9",
      "languages": [
        {
          "name": "Chitimacha",
          "proficiency": "fluent"
        },
        {
          "name": "English",
          "proficiency": "fluent"
        }
      ],
      "link": "https://data.digitallinguistics.io/languages/Chitimacha/people/BP",
      "roles": [
        "speaker"
      ],
      "type": "Person",
      "url": "https://data.digitallinguistics.io/languages/Chitimacha/people/BP.json"
    }