This document is in draft and is subject to change.
How to read this document
...
- Label: A label for the property.
- RDF property: A recognized RDF property that can be expressed as a URI.
- DB property: How the property is persisted to a relational database. "Attribute" indicates that this property is persisted as an attribute of the described class. "Relationship" indicates that this property is persisted as a relationship to another entity in the database.
- Expected type: The expected data type for the property.
- Obligation: The number of allowable values for each property. Properties that are recommended (but not required) are indicated with a *.
- Definition: The definition of the property.
- Notes: Additional information that will help create or format data
Namespaces | |
|---|---|
| css | http://www.corestandards.org/ |
| dct | http://purl.org/dc/terms/ |
| dcmitype | http://purl.org/dc/dcmitype/ |
| ore | http://www.openarchives.org/ore/terms/ |
| ontowiki | http://ns.ontowiki.net/SysOnt/ |
| schema | http://schema.org/ |
Classes
AlignmentObject, Author, Guide, Language, Organization, Place, PrimarySourceSet, PrimarySourceSetSource, Subject, TeachingGuide, TimePeriod
| Anchor | ||||
|---|---|---|---|---|
|
...
| Label | RDF property | DB property type | Expected type | Obligation | Definition | Notes |
|---|---|---|---|---|---|---|
| @type | @type | N/A | URI | 1 | RDF type of the alignment object | Expected value: "schema:AlignmentObject" |
| alignmentType | schema:alignmentType | N/A | text | 1 | A category of alignment between the learning resource and the framework node. | Expected value: "requires" |
| educationalFramework | schema:educationalFramework | N/A | text | 1 | The framework to which the resource being described is aligned. | Format: Common Core State Standards dot notation Example: "CCSS.ELA-Literacy.RH.6-8.7" |
| targetName | schema:targetName | N/A | text | 0-1* | The name of a node in an established educational framework. | Expected value: "Common Core State Standard" |
| targetUrl | schema:targetUrl | N/A | URI | 0-1* | The URL of a node in an established educational framework. | Expected values: "ccss:ELA-Literacy/RH/6-8/7/", "ccss:ELA-Literacy/RH/6-8/7/", "ccss:ELA-Literacy/RH/6-8/9/", "ccss:ELA-Literacy/RH/9-10/9/", "ccss:ELA-Literacy/RH/11-12/7/", "ccss:ELA-Literacy/RH/11-12/9/", "ccss:ELA-Literacy/CCRA/R/7/", "ccss:ELA-Literacy/CCRA/W/8/", "ccss:ELA-Literacy/WHST/6-8/8/", "ccss:ELA-Literacy/WHST/9-10/8/" |
...
| Label | RDF property | DB property type | Expected type | Obligation | Definition | Notes |
|---|---|---|---|---|---|---|
| id | N/A | attribute | text | 1 | Unique id of the author | |
| @type | @type | N/A | URI | 1 | RDF type of the author | Expected value: "schema:Person" |
| name | schema:name | attribute | text | 1 | Name of the author | |
| affiliation | schema:affiliation | relationship | schema:Organization | 0-1 | Organizational affiliation of the author |
*recommended
| Anchor | ||||
|---|---|---|---|---|
|
Class:
...
Guide
| Label | RDF property | DB property type | Expected type | Obligation | Definition | Notes | @type | @type
|---|---|---|---|---|---|---|---|
| id | N/A | attribute URI | text | 1 | RDF typeUnique id of the | languageExpected value: "schema:Language"teaching guide | |
@id | @id | N/A | URI | 0-1 | RDF idUnambiguous URI of the | languageteaching guide | |
| @type | @type | N/A | URI | 1 | RDF type of the guide | Expected value: "schema:CreativeWork" | |
| name | schema:name | N/Aattribute | text | 0-1* | Name of the language | Expected value: "English" |
*recommended
...
Class:Organization
| Label | RDF property | DB property type | Expected type | Obligation | Definition | Notes | |
|---|---|---|---|---|---|---|---|
| id | N/A | attribute | text | 1 | Unique id of the organization | ||
| @type | @type | N/A | URI | 1 | RDF type of the organization | Expected value: "schema:Organization" | |
| name | schema:name | attribute | text | 1 | Name of the organization | ||
| location | schema:location | attribute | schema:Place (RDF) text (DB) | 0-1 | Location of the organization | In the database, the value of this field is equivalent to Class:Place.nameguide | |
text | schema:text ontowiki:Markdown | attribute | markdown | 0-1 | Textual content of the guide, such as questions and activity | ||
| set | schema:isPartOf | relationship | schema:CreativeWork | 1 | The primary source set to which this guide belongs | ||
| author | scheme:author | relationship | schema:Person | 0-n | The author of this guide |
*recommended
| Anchor |
|---|
...
|
...
|
Class:
...
Language
| Label | RDF property | DB property type | Expected type | Obligation | Definition | Notes |
|---|---|---|---|---|---|---|
| @type | @type | N/A | URI | 1 | RDF type of the placelanguage | Expected value: "schema:PlaceLanguage" |
| name@idschema:name | @id | N/A | textURI | 0-1 | Name RDF id of the time place |
*recommended
...
Class:PrimarySource
| Label | RDF property | DB propertylanguage | Expected value: "http://www.lexvo.org/page/term/eng/English" Vocabulary: Lexvo In the future, other languages may be used, but for the time being, the only expected language is English. | |||
|---|---|---|---|---|---|---|
| name | schema:name | N/A | text | 0-1 | Name of the language | Expected value: "English" |
*recommended
| Anchor | ||||
|---|---|---|---|---|
|
Class:Organization
| Label | RDF property | DB property type | Expected type | Obligation | Definition | Notes | |||
|---|---|---|---|---|---|---|---|---|---|
| id | N/A | attribute | text | 1 | Unique id of the primary sourceorganization | @id | |||
| @type | @id@type | N/A | URI | 1 | Unambiguous URIRDF type of the | primary sourcetype | N/Aorganization | Expected value: "schema:Organization" | |
| name | schema:name | attribute | text | 1 | Media type Name of the primary source | Acceptable values: "image", "audio", "video", "document" | |||
| @type | @type | N/A | URI | 1 | RDF type of the primary source | Default value: "schema:CreativeWork" Other possible values: "schema:MediaObject", "schema:AudioObject", "schema:VideoObject", "schema:ImageObject" @type can be derived from the type property | |||
| name | schema:name | attribute | test | 0-1* | Name or brief caption describing the primary source | ||||
| aggregation | dct:references | attribute | ore:Aggregation (RDF) URI (DB) | 1 | The DPLA aggregation representing the primary source | ||||
thumbnail | schema:thumbnailUrl | attribute | URI | 0-1* | A thumbnail representation of the primary source | ||||
| text | schema:text ontowiki:Markdown | attribute | markdown | 0-1 | Narrative description, transcription, citation, or other text describing the primary source | ||||
| encodingFormat | schema:encodingFormat | attribute | text | 0-1* | The format in which the full representation of the primary source is encoded | Example: "pdf", "mp3", "jpg" | |||
| contentUrl | schema:contentUrl | attribute | URI | 0-1* | A URL pointing to a full representation of the primary source | The content URL may be dependent on the authorization status of the user accessing the data. For example, an authorized user may be served the URI for the full representation of the item as hosted by DPLA, while an unauthorized user may be served the value for ore:Aggregation.isShownAt. | |||
| primarySourceSet | schema:isPartOf | relationship | schema:CreativeWork | 1 | The primary source set to which this primary source belongs |
*recommended
...
Class:PrimarySourceSet
| Label | RDF property | DB property type | Expected type | Obligation | Definition | Notes |
|---|---|---|---|---|---|---|
| id | N/A | attribute | text | 1 | Unique id of the PSS | |
| slug | N/A | attribute | text | 0-1* | Human-readable slug to be used in the construction of a URL for the PSS | |
| published | N/A | attribute | boolean | 1 | Whether or not the PSS is intended for live publication on the DPLA website. | If true, PSS will be accessible to all users. If false, PSS will only be accessible to authorized users. Default value: false |
@id | @id | N/A | URI | 1 | Unambiguous URI of the PSS | |
| @type | @type | N/A | URI | 1 | RDF type of the PSS | Expected value: "schema:CreativeWork" |
| name | schema:name | attribute | text | 0-1* | Name of the PSS | |
| image | schema:image | attribute | URI | 0-1* | Large version of image representing PSS | |
| thumbnail | schema:thumnailUrl | attribute | URI | 0-1* | Small version of image representing PSS | |
| description | schema:description | attribute | text | 0-1* | Brief description of the PSS | Example: "This collection uses primary sources to explore the French and Indian War." |
| dateCreated | schema:dateCreated | attribute | ISO 8601 date format (yyyy-mm-dd) | 1 | Date the PSS was created | |
| dateModified | schema:dateModified | attribute | ISO 8601 date format (yyyy-mm-dd) | 0-1 | Date the PSS was most recently modified | |
| text | schema:text ontowiki:Markdown | attribute | markdown | 0-1 | Narrative overview of the PSS | PrimarySourceSet:text and PrimarySourceSet:resources may be concatenated to form a single schema:text field |
| resources | schema:text ontowiki:Markdown | attribute | markdown | 0-1 | Narrative information regarding resources for further research | Can include links to additional sources and tips for finding related materials in the DPLA PrimarySourceSet:text and PrimarySourceSet:resources may be concatenated to form a single schema:text field |
| primarySource | schema:hasPart | relationship | schema:CreativeWork | 0-n* | Primary sources in the PSS | |
| teachingGuide | schema:hasPart | relationship |
Class:TeachingGuide schema:CreativeWork | 0-n* | Teaching guide associated with the PSS | |
| subject | schema:about | relationship | schema:Thing | 0-n* | Educational subject of the PSS | |
| timePeriod | dct:temporal | relationship | dct:PeriodOfTime | 0-n* | Temporal subject of the PSS | |
| author | schema:author | relationship | Class:Author schema:Person | 0-n* | Author of the PSS | |
| publisher | schema:publisher | N/A | schema:Organization | 0-1 | Publisher of the PSS | The publisher for all PSS's is DPLA. |
| language | schema:inLanguage | N/A | schema:Language | 0-n | Primary language of the PSS | |
| mediaType | dct:type | N/A | dct:DCMIType | 0-1 | The set of classes specified by the DCMI Type Vocabulary, used to categorize the nature or genre of the resource.
| Expected value: "dcmitype:InteractiveResource" |
| learningResourceType | schema:learningResourceType | N/A | text | 0-1 | Predominant type of kind characterizing the learning resource | Expected value: "Source Set" |
| interactivityType | schema:interactivityTypeorganization | |||||
| location | schema:location | attribute | schema:Place (RDF) text (DB) | 0-1 | Location of the organization | In the database, the value of this field is equivalent to Class:Place.name |
*recommended
| Anchor | ||||
|---|---|---|---|---|
|
Class:Place
| Label | RDF property | DB property type | Expected type | Obligation | Definition | Notes |
|---|---|---|---|---|---|---|
| @type | @type | N/A | URI | 1 | RDF type of the place | Expected value: "schema:Place" |
| name | schema:name | N/A | text | 0-1 | Name of the time place |
*recommended
| Anchor | ||||
|---|---|---|---|---|
|
Class:Set
| Label | RDF property | DB property type | Expected type | Obligation | Definition | Notes | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | N/A | attribute | text | 1 | Unique id of the set | ||||||||
| slug | N/A | attribute | text | 0-1* | Human-readable slug to be used in the construction of a URL for the set | ||||||||
| published | N/A | attribute | boolean | 1 | Whether or not the set is intended for live publication on the DPLA website. | If true, set will be accessible to all users. If false, set will only be accessible to authorized users. Default value: false | |||||||
@id | @id | N/A | URI | 1 | Unambiguous URI of the set | ||||||||
| @type | @type | N/A | URI | 1 | RDF type of the set | Expected value: "schema:CreativeWork" | |||||||
| name | schema:name | attribute | text | 0-1* | Name of the set | ||||||||
| image | schema:image | attribute | URI | 0-1* | Large version of image representing set | ||||||||
| thumbnail | schema:thumnailUrl | attribute | URI | 0-1* | Small version of image representing set | ||||||||
| description | schema:description | attribute | text | 0-1* | Brief description of the set | Example: "This collection uses primary sources to explore the French and Indian War." | |||||||
| dateCreated | schema:dateCreated | attribute | ISO 8601 date format (yyyy-mm-dd) | 1 | Date the set was created | ||||||||
| dateModified | schema:dateModified | attribute | ISO 8601 date format (yyyy-mm-dd) | 0-1 | Date the set was most recently modified | ||||||||
| text | schema:text ontowiki:Markdown | attribute | markdown | 0-1 | Narrative overview of the set | Set:text and Set:resources may be concatenated to form a single schema:text field | |||||||
| resources | schema:text ontowiki:Markdown | attribute | markdown | 0-1 | Narrative information regarding resources for further research | Can include links to additional sources and tips for finding related materials in the DPLA Set:text and Set:resources may be concatenated to form a single schema:text field | |||||||
| source | schema:hasPart | relationship | schema:CreativeWork | 0-n* | Sources in the set | ||||||||
| guide | schema:hasPart | relationship |
schema:CreativeWork | 0-n* | Teaching guide associated with the set | ||||||||
| subject | schema:about | relationship | schema:Thing | 0-n* | Educational subject of the set | ||||||||
| timePeriod | dct:temporal | relationship | dct:PeriodOfTime | 0-n* | Temporal subject of the set | ||||||||
| author | schema:author | relationship | schema:Person | 0-n* | Author of the set | ||||||||
| publisher | schema:publisher | N/A | schema:Organization | 0-1 | Publisher of the set | The publisher for all set's is DPLA. | |||||||
| language | schema:inLanguage | N/A | schema:Language | 0-n | Primary language of the set | ||||||||
| mediaType | dct:type | N/A | dct:DCMIType | 0-1 | The set of classes specified by the DCMI Type Vocabulary, used to categorize the nature or genre of the resource.
| Expected value: "dcmitype:InteractiveResource" | |||||||
| learningResourceType | schema:learningResourceType | N/A | text | 0-1 | Predominant type of kind characterizing the learning resource | Expected value: "Source Set" | |||||||
| interactivityType | schema:interactivityType | N/A | text | 0-1 | Predominant mode of learning supported by the learning resource | Expected value: "Interactive" Vocabulary: Learning Registry Metadata Initiative suggested terms | |||||||
| license | schema:license | N/A | URI | 0-1 | URL where the owner specifies permissions for using the resource | Expected value: "http://dp.la/info/terms/" | |||||||
| educationalAlignment | schema:educationalAlignment | N/A | schema:alignmentObject | 0-n | An alignment to an established educational framework | ||||||||
| accessibilityFeature | schema:accessibilityFeature | N/A | text | 0-1n | Predominant mode of learning supported by the learning resource | Expected value: "InteractiveContent features of the resource, such as accessible media, alternatives and supported enhancements for accessibility | Expected values: "captions", "structuralNavigation", "audioControl", "videoControl" Vocabulary: Learning Registry Metadata Initiative suggested terms | ||||||
| licenseaccessibilityHazard | schema:licenseaccessibilityHazard | N/A | URItext | 0-1 | URL where the owner specifies permissions for using the resource | Expected value: "http://dp.la/info/terms/" | educationalAlignment | schema:educationalAlignmentn | A characteristic of the described resource that is physiologically dangerous to some users. Related to WCAG 2.0 guideline 2.3 | Expected values: "noFlashingHazard", "motionSimulation", "noSoundHazard" Vocabulary: Learning Registry Metadata Initiative suggested terms | |||
| accessibilityControl | schema:accessibilityControl | N/A | schema:alignmentObjecttext | 0-n | An alignment to an established educational framework | accessibilityFeature | schema:accessibilityFeature | N/A | text | 0-n | Content features of the resource, such as accessible media, alternatives and supported enhancements for accessibilityIdentifies input methods that are sufficient to fully control the described resource | Expected values: "captions", "structuralNavigation", "audioControl", "videoControlfullMouseControl" Vocabulary: Learning Registry Metadata Initiative suggested terms | |
| accessibilityHazard | schema:accessibilityHazard | N/A | text | 0-n | A characteristic of the described resource that is physiologically dangerous to some users. Related to WCAG 2.0 guideline 2.3 | Expected values: "noFlashingHazard", "motionSimulation", "noSoundHazard" Vocabulary: Learning Registry Metadata Initiative suggested terms | |||||||
| accessibilityControl | schema:accessibilityControl | N/A | text | 0-n | Identifies input methods that are sufficient to fully control the described resource | Expected values: "fullMouseControl" Vocabulary: Learning Registry Metadata Initiative suggested terms |
*recommended
...
Class:Subject
...
*recommended
| Anchor | ||||
|---|---|---|---|---|
|
Class:Source
| Label | RDF property | DB property type | Expected type | Obligation | Definition | Notes | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | N/A | attribute | text | 1 | Unique id of the source | |||||||||||
@id | @id | N/A | URI | 1 | Unambiguous URI of the source | |||||||||||
| type | N/A | attribute | text | 1 | Unique id of the subject | Media type of the source | Acceptable values: "image", "audio", "video", "document" This value will be used to determine how to embed the object in the HTML page. | |||||||||
| @type | @type | N/A | URI | 1 | RDF type of the | subjectsource | ExpectedDefault value: "schema: | Thing"CreativeWork" Other possible values: "schema:MediaObject", "schema:AudioObject", "schema:VideoObject", "schema:ImageObject" @type can be derived from the type property | ||||||||
| name | schema:name | attribute | texttest | 0-1* | Name of the subjector brief caption describing the source | lrmi | ||||||||||
| N/Aaggregation | dct:references | attribute | boolean | 1 | If true, the subject is intended for used in the Learning Registry Metadata Initiative | Default: true | filter | N/A | attribute | boolean | 1 | If true, the subject is intended for use as a filter in the DPLA web interface | Default: false ore:Aggregation (RDF) URI (DB) | 1 | The DPLA aggregation representing the source | |
thumbnail | schema:thumbnailUrl | attribute | URI | 0-1* | A thumbnail representation of the source | |||||||||||
| text | schema:text ontowiki:Markdown | attribute | markdown | 0-1 | Narrative description, transcription, citation, or other text describing the source | |||||||||||
| encodingFormat | schema:encodingFormat | attribute | text | 0-1* | The format in which the full representation of the source is encoded | Example: "pdf", "mp3", "jpg" | ||||||||||
| contentUrl | schema:contentUrl | attribute | URI | 0-1* | A URL pointing to a full representation of the source | The content URL may be dependent on the authorization status of the user accessing the data. For example, an authorized user may be served the URI for the full representation of the source as hosted by DPLA, while an unauthorized user may be served the value for ore:Aggregation.isShownAt. | ||||||||||
| set | schema:isPartOf | relationship | schema:CreativeWork | 1 | The set to which this source belongs |
*recommended
| Anchor |
|---|
...
|
...
|
Class:
...
Subject
| Label | RDF property | DB property type | Expected type | Obligation | Definition | Notes | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| id | N/A | attribute | text | 1 | Unique id of the teaching guide | @id | @id | N/A | URI | 1 | Unambiguous URI of the teaching guidesubject | ||
| @type | @type | N/A | URI | 1 | RDF type | of the teaching guideExpected value: "schema:CreativeWork" | |||||||
| name | schema:name | attribute | text | 0-1* | Name of the teaching guide | ||||||||
text | schema:text ontowiki:Markdown | attribute | markdown | 0-1 | Textual content of the teaching guide, such as questions and activity | ||||||||
| primarySourceSet | schema:isPartOf | relationship | schema:CreativeWork | 1 | The primary source set to which this teaching guide belongs | ||||||||
| author | scheme:author | relationship | schema:Person | 0-n | The author of this teaching guide | of the subject | Expected value: "schema:Thing" | ||||||
| name | schema:name | attribute | text | 1 | Name of the subject | ||||||||
| lrmi | N/A | attribute | boolean | 1 | If true, the subject is intended for used in the Learning Registry Metadata Initiative | Default: true | |||||||
| filter | N/A | attribute | boolean | 1 | If true, the subject is intended for use as a filter in the DPLA web interface | Default: false |
*recommended
| Anchor | ||||
|---|---|---|---|---|
|
...