Page Comparison

This document is in draft and is subject to change.

How to read this document

This document specifies data for the Educational Uses Project projects. It describes conceptual classes and properties, how data are expressed in Resource Descriptive Framework (RDF), and how they are persisted to a relational database. For the purposes of our implementation, data that are identical across all instances of a class are not persisted to the database. Each class has the following specifications:

PropertyLabel: A human-readable name or 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 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, Language Guide, Organization Language, Place Organization, PrimarySource Set, PrimarySourceSet Source, Subject, TeachingGuide, TimePeriod Subject, TimePeriod

Anchor

	AlignmentObject
	AlignmentObject

Class:AlignmentObject

DB

PropertyLabel	RDF property	property	Expected type	Obligation	Definition
@type	@typeN/A	URI	1	RDF type of the alignment object	Expected value: "schema:AlignmentObject"
alignment typealignmentType	schema:alignmentTypeN/A	text	1	A category of alignment between the learning resource and the framework node.	Expected value: "requires"
educational frameworkeducationalFramework	schema:educationalFrameworkN/A	text	1	The framework to which the resource being described is aligned.	The value for this field should match the label for targetUrl Example: Format: Common Core State Standards dot notation Example: "CCSS.ELA-Literacy.RH.6-8.7"
target nametargetName	schema:targetNameN/A	text	0-1*	The name of a node in an established educational framework.	Expected value: "Common Core State Standard"
targetUrl	schema:targetUrlN/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/"

*recommended

Anchor

	Author
	Author

Class:

...

Author

DB typeidN/AUnique id PSS0-*Human-readable slug to be used in the construction of a URL for the PSS@id

PropertyLabel

RDF property

property

Expected type

Obligation

Definition

Notes

@type

attributeURI

text

1

RDF type of the

slug

N/A

attributeauthor

Expected value: "schema:Person"

name

schema:name

text

1

Name of the author

affiliation

@id

N/A

URI

1

Unambiguous URI of the PSS

@type

N/A

schema:affiliation

Class:Organization

schema:Organization

0-1

Organizational affiliation of the author

*recommended

Anchor

	Guide
	Guide

Class:Guide

PSSimageimageURI*thumbnailthumnailUrlSmall version of image representing PSSdescriptionschemadescriptiontext1*

Label	RDF property	Expected type	Obligation	Definition	Notes
@id	@id	URI	1	Unambiguous URI of the teaching guide
@type	@type	URI	1	RDF type of the PSSguide	Expected value: "schema:CreativeWork"
name	schema:name	attribute	text	0-1*	Name of the	guide
text	schema:	text attribute ontowiki:Markdown	markdown	0-1	Large version of image representing PSS	Textual content of the guide, such as questions and activity
set	schema:	isPartOf	attribute	URI	0-1*	Class:Set schema:CreativeWork	1	The primary source set to which this guide belongs
author	scheme:	attribute	author	Class:A uthor schema:Person	0-	Brief description of the PSS	Example: "This collection uses primary sources to explore the French and Indian War."
date created	schema:dateCreated	attribute	ISO 8601 date format (yyyy-mm-dd)	1	Date the PSS was created
date modified	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
primary source	schema:hasPart	relationship	Class:PrimarySource schema:MediaObject	0-n*	Primary sources in the PSS
teaching guide	schema:hasPart	relationship	Class:TeachingGuide schema:CreativeWork	0-n*	Teaching guide associated with the PSS
subject	schema:about	relationship	Class:Subject schema:Thing	0-n*	Educational subject of the PSS
time period	dct:temporal	relationship	Class:TimePeriod dct:PeriodOfTime	0-n*	Temporal subject of the PSS
author	schema:author	relationship	Class:Person schema:Person	0-n*	Author of the PSS
publisher	schema:publisher	N/A	Class:Organization 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
media type	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"
learning resource type	schema:learningResourceType	N/A	text	0-1	Predominant type of kind characterizing the learning resource	Expected value: "Source Set"
interactivity type	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/"
educational alignment	schema:educationalAlignment	N/A	schema:alignmentObject	0-n	An alignment to an established educational framework
accessibility feature	schema:accessibilityFeature	N/A	text	0-n	Content 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
accessibility hazard	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
accessibility control	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:PrimarySource

Property	RDF property	DB property type	Expected type	Obligation	Definition	Notes
id	N/A	attribute	text	1	Unique id of the PS
@id	@id	N/A	URI	1	Unambiguous URI of the PS
@type	@type	N/A	URI	1	RDF type of the PS	Expected value: "schema:MediaObject"
name	schema:name	attribute	test	0-1*	Name or brief caption describing the PS
aggregation	dct:references	attribute	ore:Aggregation (RDF) URI (DB)	1	The DPLA aggregation representing the PS
thumbnail	schema:thumbnailUrl	attribute	URI	0-1*	A thumbnail representation of the PS
text	schema:text ontowiki:Markdown	attribute	markdown	0-1	Narrative description, transcription, citation, or other text describing the PS
encoding format	schema:encodingFormat	attribute	text	0-1*	The format in which the full representation of the PS is encoded	Example: "pdf", "mp3", "jpg"
content URL	schema:contentUrl	attribute	URI	0-1*	A URL pointing to a full representation of the PS	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.
primary source set	schema:isPartOf	relationship	Class:PrimarySourceSet schema:CreativeWork	1	The primary source set to which this primary source belongs

*recommended

Class:TeachingGuide

Property	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 guide
@type	@type	N/A	URI	1	RDF type of the teaching guide	Expected 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
primary source set	schema:isPartOf	relationship	Class:PrimarySourceSet schema:CreativeWork	1	The primary source set to which this teaching guide belongs
author	scheme:author	relationship	Class:Person schema:Person	0-n	The author of this teaching guide

*recommended

Class:Author

Property	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	Class:Organization schema:Organization	0-1	Organizational affiliation of the author

*recommended

Class:Organization

Property	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	Class:Place 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

Class:Subject

Property	RDF property	DB property type	Expected type	Obligation	Definition	Notes
id	N/A	attribute	text	1	Unique id of the subject
@type	@type	N/A	URI	1	RDF type 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

Class:TimePeriod

Property	RDF property	DB property type	Expected type	Obligation	Definition	Notes
id	N/A	attribute	text	1	Unique id of the time period
@type	@type	N/A	URI	1	RDF type of the time period	Expected value: "dct:PeriodOfTime"
name	schema:name	attribute	text	1	Name of the time period
lrmi	N/A	attribute	boolean	1	If true, the time period is intended for used in the Learning Registry Metadata Initiative as a subject term	Default: true
filter	N/A	attribute	boolean	1	If true, the time period is intended for use as a filter in the DPLA web interface	Default: false

*recommended

Class:Place

Property	RDF property	DB property	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

Class:Language

DB

Property	RDF property	n	The author of this guide

*recommended

Anchor
Language
Language

Class:Language

Label

RDF property

Expected type

Obligation

Definition

Notes

@type

URI

1

RDF type of the language

Expected value: "schema:Language"

@id

URI

0-1

RDF id of the language

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

text

0-1

Name of the language

Expected value: "English"

*recommended

Anchor

	Organization
	Organization

Class:Organization

Label	RDF property	Expected type	Obligation	Definition	Notes
@type	@type	URI	1	RDF type of the organization	Expected value: "schema:Organization"
name	schema:name	text	1	Name of the organization

*recommended

Anchor

	PrimarySourceSet
	PrimarySourceSet

Class:Set

Label	RDF property	Expected type	Obligation	Definition	Notes
@id	@id	URI	1	Unambiguous URI of the set
@type	@type	URI	1	RDF type of the set	Expected value: "schema:CreativeWork"
name	schema:name	text	1	Name of the set
image	schema:image	URI	0-1*	Large version of image representing set
thumbnail	schema:thumnailUrl	URI	0-1*	Small version of image representing set
description	schema:description	text	0-1*	Brief description of the set	Example: "This collection uses primary sources to explore the French and Indian War."
dateCreated	schema:dateCreated	ISO 8601 date format (yyyy-mm-dd)	1	Date the set was created
dateModified	schema:dateModified	ISO 8601 date format (yyyy-mm-dd)	0-1	Date the set was most recently modified
overview	schema:text ontowiki:Markdown	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	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	Class:Source schema:CreativeWork	0-n*	Sources in the set
guide	schema:hasPart	Class:Guide schema:CreativeWork	0-n*	Teaching guide associated with the set
subject	schema:about	Class:Subject schema:Thing	0-n*	Educational subject of the set
timePeriod	dct:temporal	Class:TimePeriod dct:PeriodOfTime	0-n*	Temporal subject of the set
author	schema:author	Class:Author schema:Person	0-n*	Author of the set
publisher	schema:publisher	Class:Organization schema:Organization	0-1	Publisher of the set	The publisher for all set's is DPLA.
language	schema:inLanguage	Class:Language schema:Language	0-n	Primary language of the set
mediaType	dct:type	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	text	0-1	Predominant type of kind characterizing the learning resource	Expected value: "Source Set"
interactivityType	schema:interactivityType	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	URI	0-1	URL where the owner specifies permissions for using the resource	Expected value: "http://dp.la/info/terms/"
educationalAlignment	schema:educationalAlignment	schema:alignmentObject	0-n	An alignment to an established educational framework
accessibilityFeature	schema:accessibilityFeature	text	0-n	Content 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
accessibilityHazard	schema:accessibilityHazard	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	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

Anchor

	Source
	Source

Class:Source

Label	RDF property	Expected type	Obligation	Definition	Notes
@id	@id	URI	1	Unambiguous URI of the source
@type	@type	URI	1	RDF type of the 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	text	0-1*	Name or brief caption describing the source
aggregation	dct:references	ore:Aggregation (RDF) URI (DB)	1	The DPLA aggregation representing the source
thumbnail	schema:thumbnailUrl	URI	0-1*	A thumbnail representation of the source
textualContent	schema:text ontowiki:Markdown	markdown	0-1	Narrative description, transcription, citation, or other text describing the source
encodingFormat	schema:encodingFormat	text	0-1*	The format in which the full representation of the source is encoded	Example: "pdf", "mp3", "jpg"
contentUrl	schema:contentUrl	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.
citation	dct:bibliographicCitation	markdown	0-1	A bibliographic reference to the source	Example: "National Museum of American History, Kenneth E. Behrig Center. George Washington's Camp Chest. Digital Public Library of America. http://dp.la/primary-source-sets/sets/american-revolution/sources/8."
credits	dct:provenance	dct:ProvenanceStatement	0-1	A statement relating to the ownership of the source	Example: "Courtesy of the University of Michigan via HathiTrust"
set	schema:isPartOf	Class:Set schema:CreativeWork	1	The set to which this source belongs

*recommended

Anchor
Subject
Subject

Class:Subject

Label

RDF property

Expected type

Obligation

Definition

Notes

@type

N/A

URI

1

RDF type of the languagesubject

Expected value: "schema:Language"

@id

N/A

URI

0-1

RDF id of the language

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"

If an @id is given, this field should match the label of the @id

...

Thing"
name	schema:name	text	1	Name of the subject

*recommended

Anchor

	TimePeriod
	TimePeriod

Class:TimePeriod

Label	RDF property	Expected type	Obligation	Definition	Notes
@type	@type	URI	1	RDF type of the time period	Expected value: "dct:PeriodOfTime"
name	schema:name	text	1	Name of the time period

*recommended

Versions Compared

Old Version 8

New Version Current

Key

How to read this document

Namespaces

Classes

Class:AlignmentObject

Class:

Author

Class:Guide

Class:PrimarySource

Class:TeachingGuide

Class:Author

Class:Organization

Class:Subject

Class:TimePeriod

Class:Place

Class:Language

Anchor
Language
Language

Class:Language

Class:Organization

Class:Set

Class:Source

Anchor
Subject
Subject

Class:Subject

Class:TimePeriod

Page Comparison

Versions Compared

Old Version 8

New Version Current

Key

How to read this document

Namespaces

Classes

Class:AlignmentObject

Class:

Author

Class:Guide

Class:PrimarySource

Class:TeachingGuide

Class:Author

Class:Organization

Class:Subject

Class:TimePeriod

Class:Place

Class:Language

AnchorLanguageLanguage

Class:Language

Class:Organization

Class:Set

Class:Source

AnchorSubjectSubject

Class:Subject

Class:TimePeriod

Anchor
Language
Language

Anchor
Subject
Subject