Basic Object Model

Metadata model for a common generic resource item in the repository.

2.1. Object Datastreams - Overview

ID	Label	State	Description
Internal FOXML		System generated	Object ID (pid), creation/modification dates, audit trail, …
DC	Dublin Core	System generated	Generated and used internally by Fedora. Don’t touch this!
CHOR_DC	SWITCHcollection application profile of Dublin Core	Mandatory	Dublin Core Metadata to describe the resource. Also includes information about the usage license and the access rights (read and modify)
RELS-EXT	RELS-EXT	mandatory	Relations to collection and content model
THUMBNAIL	THUMBNAIL	optional	Visualization (image) of the object
DS1, DS2, …	Freely definable labels	DS1 mandatory, all other Datax optional	Datastreams with the actual data. All Datax datastreams are different representations of the same object. Data1 is mandatory, all other Datax datastreams are optional. Data1 contains the representation with most information. The following representations may continuously loose information Each of the Datax datastreams has its own control group X: inline, M: managed, E: external, R: redirected

2.2. Standard Fedora FOXML

Contains Id/Identifier, date created, date last modified, version, audit trail.

2.3. Datastream CHOR_DC

2.3.1. Mandatory Elements

SWITCHcollection uses a subset of the Dublin Core Metadata Standard. A more compact list of the SWITCHcollection metatags can be found here.

XML namespace definitions in examples:

  xmlns:dcterms="http://purl.org/dc/terms/"
  xmlns:chor_dc="http://purl.org/switch/chor/"
  xmlns:chor_dcterms="http://purl.org/switch/chor/terms/"

Element	Description	Example of XML-Binding	R
title	The name or title of the resource	<dcterms:title> DNA from the Beginning </dcterms:title>	RM HM
creator +	Owner of the resource. Usually this is the Author.	<dcterms:creator> John Doe </dcterms:creator> <dcterms:creator> Erika Mustermann </dcterms:creator> <dcterms:creator> Sprachenzentrum Uni Basel </dcterms:creator>	RM HM
aaiid*	AAI ID of the creator of the resource in the repository. This person may be the creator, the contributor or another person. Technical access rights are associated to this person.	<chor_dcterms:aaiid> 3562781242@zhaw.ch </chor_dcterms:aaiid>	RM
accessRights	Who may read the content of the resource (preview, download). Access terms: Private, group (GMT group-id), institution (aai attribute home organization), public. Future extension: differentiate between metadata and content access rights.	<dcterms:accessRights chor_dcterms:access='private'> </dcterms:accessRights> <dcterms:accessRights chor_dcterms:access='group'> 3141592@lorgmt.switch.ch </dcterms:accessRights> <dcterms:accessRights chor_dcterms:access='institution'> unibas.ch </dcterms:accessRights> <dcterms:accessRights chor_dcterms:access='public'> </dcterms:accessRights>	RM
rights	Who may modify the resource. Access terms: Private, group, institution, public. Special case: the origin of the resource is an external application (LMS, SWITCHcast). If the resource can only be edited in the external application, then rights are not evaluated in the repository. A user who edits the resource is redirected to the external application (edit link).	<dcterms:rights chor_dcterms:access='private'> </dcterms:rights> <dcterms:rights chor_dcterms:access='group'> 3141592@lorgmt.switch.ch </dcterms:rights> <dcterms:rights chor_dcterms:access='institution'> unibas.ch </dcterms:rights> <dcterms:rights chor_dcterms:access='public'> </dcterms:rights>	RM
license	Link to legal specification (swiss jurisdiction) what can be done with the resource and under what conditions. Either "empty": copyright defined inside A creative commons license URL (the default for video streaming: by-nc-nd) a ODRL specification (not used yet) Complete list of possible values: http://collection.switch.ch/spec/2008/licenses/	<dcterms:license xsi:type=”dcterms:URI”> http://creativecommons.org/licenses\ /by/2.5/ch/ </dcterms:license> <dcterms:license> </dcterms:license>	RM HM
discipline +	Teaching discipline of the resource: Controlled SWITCHlor vocabulary. Code as defined in http://collection.switch.ch/spec/2008/disciplines	<dcterms:subject chor_dcterms:discipline='2043'> </dcterms:subject>	RM
Element	Description	Example of XML-Binding
contributor +	Who contributes to the resource. Being listed here does not imply technical access rights (they are specified in rights).	<dcterms:contributor> Jane Doe </dcterms:contributor> <dcterms:contributor> John Doe </dcterms:contributor> <dcterms:contributor> John Q. Public </dcterms:contributor>
publisher +	Who makes the resource available. Originating university or SWITCH	<dcterms:publisher> Université de Lausanne </dcterms:publisher>
rightsHolder	Person or organization owning or managing the rights over the resource	<dcterms:rightsHolder> John Doe </dcterms:rightsHolder> <dcterms:rightsHolder> Université de Lausanne </dcterms:rightsHolder>
tableOfContents	Table of contents (unformatted free text)	<dcterms:tableOfContents> 1. Introduction, 2. genetic alleles, 3. Inheritance, 4. Dominance, 5. Punnett squares, 6. Mendel’s laws </dcterms:tableOfContents>
abstract	Abstract of the resource	<dcterms:abstract> DNA from the Beginning is an animated tutorial on DNA, genes and heredity. The science behind each concept is explained using animations, an image gallery, video interviews, problems, biographies, and links. </dcterms:abstract>
subject +	Topic of the resource: keywords, key phrases, classification codes (free text)	<dcterms:subject> Genetics, DNA, classical experiments </dcterms:subject>
description +	An account of the content of the resource	<dcterms:description> Recorded at the ETHZ </dcterms:description>
language +	Language(s) of the content. Vocabulary: ISO-639-2 alpha-3 code	<dcterms:language xsi:type=”dcterms:ISO639-2”> deu </dcterms:language> <dc:language xsi:type=”dcterms:ISO639-2”> fra </dcterms:language> <dcterms:language xsi:type=”dcterms:ISO639-2”> eng </dcterms:language>
educationLevel +	Description of education or training context (free text)	<dcterms:educationLevel> basic studies </dcterms: educationLevel > <dcterms:educationLevel> bachelor </dcterms:educationLevel> <dcterms:educationLevel> basic master </dcterms:educationLevel >
instructionalMethod +	The way how instructional material is presented	<dcterms:instructionalMethod> Experimental learning </dcterms:instructionalMethod> <dcterms:instructionalMethod> Observation </dcterms:instructionalMethod>
issued	Publication date of the resource in W3C Format which is a subset of ISO 8601. It is suggested to define the date and time as precisely as possible and reasonable. (Creation and modification dates are part of FOXML)	<dcterms:issued xsi:type=”dcterms:W3CDTF”> 2004-03-12 </dcterms:issued> <dcterms:issued xsi:type=”dcterms:W3CDTF”> 2004-03-12T19:20+01:00 </dcterms:issued> <dcterms:issued xsi:type=”dcterms:W3CDTF”> 2004 </dcterms:issued>
alternative +	Alternative title, e.g. title abbreviations or title translations	<dcterms:alternative> DNS von Grund auf. </dcterms:alternative>
bibliographicCitation+	Bibliographic reference for the resource
type	Nature or gerne of the resource (DCMI Vocabulary: “Dataset”, “InteractiveResource”, “MovingImage”, “Software”, “Sound”, “StillImage”, “Text”) DCMI Subset defined in http://collection.switch.ch/spec/2008/types/	<dcterms:type xsi:type=”dcterms:DCMIType”> InteractiveResource </dcterms:type> <dcterms:type xsi:type=”dcterms:DCMIType”> Sound </dcterms:type>
extent +	The duration of the resource in seconds.	<dcterms:extent> 30 sec </dcterms:extent>
source	If the resource is derived from another original resource: Unique id of the original resource. If the resource has been created by an automatic export/ingest process, the source should be used to determine if an existing resource has to be updated, or if a new resource should be created. For a harvested resource, this is the URL where it can be downloaded.	<dcterms:source> uzh.ch-olat-2008-courseid12345 </dcterms:source> <dcterms:source> http://unige.ch/repo/id12345678 </dcterms:source>	HM
identifier	Persistent identifier of the resource. If a persistent identifier is set, the object can't be deleted anymore. ~~Can be used by the OAI Provider to unambiguously tag resource records.~~	<dcterms:identifier> 10.234567/987654 </dcterms:identifier>

Legend:

+: element can be repeated
RM: Repository Mandatory. The element is required for all objects that are stored in the community repository.
HM: Harvesting Mandatory. The element is required for all objects that are harvested into the federation search index.

Curently not used or specified:

accrualMethod, accrualPeriodicity, accrualPolicy, audience, coverage, available, created, date, dateAccepted, dateCopyrighted, dateSubmitted, hasFormat, hasPart, hasVersion, isFormatOf, isPartOf, isReferencedBy, isReplacedBy, isRequiredBy, isVersionOf, modified, provenance, medium, mediator, replaces, requires, temporal, spacial.

Some of these tags may become mandatory or optional tags in the future if it is required.

2.3.3. XML Binding Example

<?xml version="1.0"?>

<metadata
  xmlns:dcterms="http://purl.org/dc/terms/"
  xmlns:chor_dc="http://purl.org/switch/chor/"
  xmlns:chor_dcterms="http://purl.org/switch/terms/"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://collection.switch.ch/ http://collection.switch.ch/spec/2008/chor_dcterms.xsd" >

  <dcterms:title>
    DNA from the Beginning
  </dcterms:title>
  <dcterms:creator>
    John Doe
  </dcterms:creator>
  <dcterms:creator>
    Pinco Pallino
  </dcterms:creator>
  <chor_dcterms:aaiid>
    3562781242@zhaw.ch
  </chor_dcterms:aaiid>
  <dcterms:alternative>
    DNS von Grund auf
  </dcterms:alternative>
  <dcterms:subject>
    Genetics, DNA, classical experiments
  </dcterms:subject>
  <dcterms:subject xsi:type="dcterms:DDC">
    062
  </dcterms:subject>
  <dcterms:description>
    DNA from the Beginning is an animated tutorial on DNA, genes and 
    heredity. The science behind each concept is explained using 
    animations, an image gallery, video interviews, problems, biographies, 
    and links..
  </dcterms:description>
  <dcterms:publisher>
    Université de Lausanne
  </dcterms:publisher>
  <dcterms:license xsi:type=”dcterms:URI”>
    http://creativecommons.org/licenses/by-nc-nd/2.5/ch/
  </dcterms:license>
  <dcterms:extent>
    14 Minutes
  </dcterms:extent>
  <dcterms:source>
     uzh.ch-olat-2008-courseid1234567
  </dcterms:source>

</metadata>

2.4. Datastream RELS-EXT

This datastream specifies relations of a content object to other objects. Both RDF elements are mandatory.

Element	Description
rel:isMemberOfCollection	Reference to the collection object that contains the resource
rel:conformsTo	Reference to content model object basic object

2.5. Datastreams DS1 ... DSn

In many cases, only one datastream DS1 will we associated to a repository object. In other cases however, it will be necessary to associate different technical representations of one ressource to the same repository object.

The content datastreams are integer numbers prefixed with "DS". Examples for datastream IDs and Labels: DS1, DS12, DS300.
The enumeration does not have to be contiguous.
The datastreams are ordered.

Given a set of datastreams DSx1, DSx2, ... the DSx with the lowest x contains the representation with most information. The following representations may continuously loose information (but they may be more interoperable). DSn carries the least information.

Example – Videoclip:

DS100: original raw video data
DS200: Quicktime 800x600px 25fps
DS300: Quicktime 400x300px 10fps

For each datastream DSn the following attributes are defined: (all attributes except formaturi are mandatory)

Attribute	Description
dslabel	A textual, human readable description of the datastream. It will be generated from the Object Title and the formaturi (or the format if no formaturi available). Example “How things get Done - Medium-quality Quicktime Video”
format	Standard IANA Internet Mime type.
formaturi	Refines the IANA format specification. The string is represented in DCMI DCSV syntax. It is recommended to automatically generate this format string. The following fields are defined: `format` Refined format if the IANA type is not specific enough. This is mostly the case with zip files or other archive formats. The list of formats is specified here: http://collection.switch.ch/spec/2008/format/ Example: `format=ims-qti` `version` Version of the format, e.g. to distinguish SCORM 1.3 from SCORM 2004 Example: `version=2004;` `size` The size (witdth and height) of an image or video in pixels. Example: `size.width=130; size.height=80;` `colordepth` The number of bits for the color of an image. Example: colordepth=24; `framerate` The number of frames per second of a video clip Example: `framerate=25;` `bitrate` The number of bits per second when streamed Example: `bitrate=128000;` `extension` The original extension of the uploaded file Example: `extension=pdf;` Examples of complete formaturi: `"format=ims-qti;version=1.2;extension=zip" "size.width=130;size.height=80;colordepth=24;extension=jpg"`
STATE, CONTROL_GROUP, CREATED	Common Fedora attributes.

2.6. Datastream THUMBNAIL

The Thumbnail datastream is a visual representation (an image or snapshot) of the object. It is used to give a visual impression of an object in a list of search results.

The Thumbnail is optional. However, it is recommend to supply a thumbnail image, in particular if the object is automatically ingested to the repository. The Thumbnail may be the a snapshot of the first frame of a video clip, the first page of a course, a SCORM module or a PDF document.