Person
Validate against: http://json-schema.org/draft-07/schema#
Schema ID: http://schemas.digitallinguistics.io/Person-4.3.0.json
Type: object
Description
An object providing information about a Person
Required Properties
familyNamegivenName
Properties
The following properties are defined for this object:
Type:
typeType:
stringRead-only:
trueDescription
The type of object. Must be set to
Person.This item must have the following value:
"Person"ID:
idDescription
A unique database identifier for this Person
Abbreviation:
abbreviationType:
stringDescription
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:
Access Rights:
accessType:
objectDescription
The access rights for information about this person
Referenced Schema
This item must validate against the following schema:
Address:
addressType:
objectDescription
The address for this person
Referenced Schema
This item must validate against the following schema:
Birth Date:
birthDateType:
stringDescription
This person’s birth date, in internet date time format
Format:
dateBirth Place (Database Reference):
birthPlaceType:
objectDescription
A database reference to this person’s place of birth, as a Location object
Referenced Schema
This item must validate against the following schema:
Email:
emailType:
stringDescription
This person’s email
Format:
emailFamily Name(s) / Last Name(s):
familyNameType:
stringDescription
This person’s family name(s) (last name(s))
Gender:
genderType:
stringDescription
This person’s self-reported gender identity
Given Name(s) / First Name(s):
givenNameType:
stringDescription
This person’s given name(s) (first name(s)), including middle name(s), if any
Languages Spoken:
languagesType:
arrayDescription
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:
trueItems
Each item in this array must adhere to the following schema:
Language Spoken:
languagesThis item must also validate against all of the following schemas:
Language
Type:
objectDescription
Each item in the
languagesArray must be a valid Language objectReferenced Schema
This item must validate against the following schema:
Properties
The following properties are defined for this object:
Age Learned:
ageLearnedType:
integerDescription
The age at which this person learned this language
Minimum:
0Notes:
notesType:
arrayDescription
Notes about this person’s use of this language
Items must be unique:
trueItems
Each item in this array must adhere to the following schema:
Note:
notesType:
objectDescription
A note about this person’s use of this language
Referenced Schema
This item must validate against the following schema:
Proficiency:
proficiencyType:
stringDescription
The proficiency level of this person in this Language
Years Known:
yearsKnownType:
integerDescription
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:
linkType:
stringDescription
A URL where a presentational format for this resource may be viewed
Format:
uriNotes:
notesType:
arrayDescription
An array of notes about this person
Items must be unique:
trueItems
Each item in this array must adhere to the following schema:
Note:
notesType:
objectDescription
A note about this person
Referenced Schema
This item must validate against the following schema:
Phone Number:
phoneType:
stringDescription
A phone number for this Person
Pseudonym:
pseudonymType:
stringDescription
A pseudonym for this Person
Roles:
rolesType:
arrayDescription
An array of the roles that this person has in the context of the associated data, e.g.
speakerortranscriberItems must be unique:
trueItems
Each item in this array must adhere to the following schema:
Role:
rolesType:
stringDescription
The role that this person has in the context of the associated data, e.g.
speakerortranscriberMinimum length:
1Start Date:
startDateType:
stringDescription
The date a person began work on a project, a language documentation, the transcription of a text, or another form of data collection or research. This field is most useful when the Person object is being used as part of the Language.contributor and Text.contributor fields.
This item must also validate against exactly one of the following schemas:
Format:
dateFormat:
date-time
End Date:
endDateType:
stringDescription
The date a person finished work on a project, a language documentation, the transcription of a text, or another form of data collection or research. This field is most useful when the Person object is being used as part of the Language.contributor and Text.contributor fields.
This item must also validate against exactly one of the following schemas:
Format:
dateFormat:
date-time
Tags:
tagsType:
objectDescription
A set of tags for this Person
Referenced Schema
This item must validate against the following schema:
URL:
urlType:
stringDescription
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" ], "startDate": "2018-10-05T15:26:23.070Z", "endDate": "2018-10-05T15:26:23.070Z", "type": "Person", "url": "https://data.digitallinguistics.io/languages/Chitimacha/people/BP.json" }
Developer Notes
This is a top-level database object