Initial model proposal

From Schema Architypes Community Group

Initial Model

Introduction

This page contains a description of an initial model for a proposed Archive extension for the schema.org vocabulary.

This version supersedes the Initial model first published in October 2015

It is derived from that initial document and the discussion it stimulated. This version is has introduced significant simplification into the proposal.

To assist understanding and discussion this document should be read in association with viewing a prototype version of the archive.schema.org vocabulary as it would appear on the schema.org site - hosted here: http://archive.sdo-archive.appspot.com/ The intension is to reflect changes in this document on the prototype site.

Discussion of the model should take place on the Architypes public mailing list.

Premise behind Model

The intension is to create an extension to the Schema.org vocabulary, wherever possible reusing terms already in the vocabulary. Only extending where necessary to describe archive associated information that can not be described within the currently available term set. The intension is to be able to describe archive associated resources in a way that will make them visible on the web and aid their discovery. It is not the intension to create a vocabulary capable of supporting the internal processes of those that manage archives, or to replace any of the established vocabularies and ontologies created for that purpose.

Basic Model

This diagram shows the basic relationship between the proposed archive specific, types plus relevant Schema types in the model. This is not a fully comprehensive diagram, for full details of the types and properties see below.

Archive Model Overview
Archive Model Overview

Note: For simplicity and clarity most properties are shown as being of type Text. In practice many would resolve to other Schema.org types. eg. itemLocation would reference a Schema.org Place.

Core Types

Archive

Institution with archival holdings. An Archive, or Archives, is an organization which keeps and preserves archival material and potentially makes it accessible to the public.

A subtype of LocalBusiness - a combination of Organization and Place - providing the attributes to describe, when appropriate, the physical and/or organizational presence responsible for an ArchiveCollection.

ArchiveCollection

A collection of physical and/or digital items that are grouped or aggregated into an archive or fonds.

ArchiveItem

An item that is part of an ArchiveCollection.


Examples

1. Full Data Model of an item in a collection

Based upon the following real world example: Sound Recording of Lines from My Grandafther's Forehead (Radio)

@prefix : <http://schema.org/> .

#An ArchiveItem (Note the definition of two types (schema:AudioObject, schema:ArchiveItem) indicating that the item is ''both'' an AudioObject ''and'' an ArchiveItem.
<https://archiveshub.jisc.ac.uk/data/gb71-thm/407/thm/407/8/3> a schema:AudioObject, schema:ArchiveItem ;
    schema:accessConditions "Please check with the Theatre and Performance enquiry team regarding access arrangements before making an appointment to listen to this item." ;
    schema:dateCreated "1971-1972"^^schema:Date ;
    schema:description "Sound recording of the first radio broadcast of Lines from My Grandfather's Forehead by Ronnie Barker and others. Duration: max 90 mins." ;
    schema:about “Comedy”;
    schema:duration "PT90M" ;
    schema:inLanguage "EN" ;
    schema:isPartOf "https://archiveshub.jisc.ac.uk/data/gb71-thm/407/thm/407/8" ;
    schema:itemLocation "https://archiveshub.jisc.ac.uk/search/locations/eae30daa-1bf9-33d9-bf1c-7aeb220d2e76" ;
    schema:name "Sound Recording of Lines from My Grandafther's Forehead (Radio)" ;
    schema:playerType "Audio Cassette" ;
    schema:identifier "GB 71 THM/407/8/3" .

#An ArchiveCollection (a sub-collection)
<https://archiveshub.jisc.ac.uk/data/gb71-thm/407/thm/407/8> a schema:ArchiveCollection ;
    schema:description "This section contains audio recordings of Ronnie Barker in theatre performances, radio, and copies of vinyl records featuring his comedy songs and sketches." ;
    schema:about “Comedy”, "Ronnie Barker”;
    schema:hasPart "https://archiveshub.jisc.ac.uk/data/gb71-thm/407/thm/407/8/3" ;
    schema:inLanguage "EN" ;
    schema:isPartOf "https://archiveshub.jisc.ac.uk/data/gb71-thm/407" ;
    schema:name "Ronnie Barker Collection: Audio Recordings" ;
    schema:temporalCoverage "1954-2005" ;
    schema:identifier "GB 71 THM/407/8" .

#An Archive Collection
<https://archiveshub.jisc.ac.uk/data/gb71-thm/407> a schema:ArchiveCollection ;
    schema:about “Comedy”, "Ronnie Barker”;
    schema:accessConditions "This archive collection is available for consultation in the V&A Blythe House Archive and Library Study Room by appointment only. Full details of access arrangements may be found here: http://www.vam.ac.uk/content/articles/a/archives/.  Access to some of the material may be restricted. These are noted in the catalogue where relevant." ;
    schema:creator [ a schema:Person ;
            schema:name "Ronnie Barker" ;
            schema:sameAs <http://viaf.org/viaf/2676198> ] ;
    schema:description "The collection consists of memorabilia material collected by Ronnie Barker to document his career. Materials include scrapbooks compiled by Ronnie Barker with press cuttings, reviews, memorabilia and photographs of his theatre, television and film work, photographs, manuscript material, scripts, correspondence, certificates and awards, press and marketing materials, audio recordings, audio visual recordings and material relating to special events and honours in his career." ;
    schema:hasPart "https://archiveshub.jisc.ac.uk/data/gb71-thm/407/thm/407/8" ;
    schema:inLanguage "EN" ;
    schema:contentLocation "https://archiveshub.jisc.ac.uk/search/locations/eae30daa-1bf9-33d9-bf1c-7aeb220d2e76" ;
    schema:name "Ronnie Barker Collection" ;
    schema:temporalCoverage "1929-2005" ;
    schema:holdingArchive "https://archiveshub.jisc.ac.uk/search/locations/eae30daa-1bf9-33d9-bf1c-7aeb220d2e76";
    schema:identifier "GB 71 THM/407/8" .

#An Archive 
<https://archiveshub.jisc.ac.uk/search/locations/eae30daa-1bf9-33d9-bf1c-7aeb220d2e76> a schema:Archive ;
    schema:address "Blythe House23 Blythe Road, London W14 0QX, England" ;
    schema:name "V&A Theatre and Performance Collections" ;
    schema:archiveHeld <https://archiveshub.jisc.ac.uk/data/gb71-thm/407>
    schema:url <http://www.vam.ac.uk/content/articles/t/archives-theatre-performance/> .

2. JSON-LD Inserts into individual pages

Based upon the following real world example: Sound Recording of Lines from My Grandafther's Forehead (Radio)

Page for an AudioObject Item in the archive

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@id": "https://archiveshub.jisc.ac.uk/data/gb71-thm/407/thm/407/8/3",
  "@type": ["AudioObject","ArchiveItem"],
  "identifier": "GB 71 THM/407/8/3",
  "name": "Sound Recording of Lines from My Grandafther's Forehead (Radio)",
  "about": "Comedy",
  "description": "Sound recording of the first radio broadcast of Lines from My Grandfather's Forehead by Ronnie Barker and others. Duration: max 90 mins.",
  "inLanguage": "EN",
  "dateCreated": "1971-1972",
  "duration": "PT90M",
  "playerType": "Audio Cassette",
  "accessConditions": "Please check with the Theatre and Performance enquiry team regarding access arrangements before making an appointment to listen to this item.",
  "itemLocation": "https://archiveshub.jisc.ac.uk/search/locations/eae30daa-1bf9-33d9-bf1c-7aeb220d2e76",	
  "isPartOf": "https://archiveshub.jisc.ac.uk/data/gb71-thm/407/thm/407/8"	  		  
}
</script>

Note the definition of two types ("@type": "AudioObject, ArchiveItem",) indicating that the item is both an AudioObject and an ArchiveItem.

Page for a sub-collection in the archive

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@id": "https://archiveshub.jisc.ac.uk/data/gb71-thm/407/thm/407/8",
  "@type": "ArchiveCollection",	
  "identifier": "GB 71 THM/407/8",
  "name": "Ronnie Barker Collection: Audio Recordings",
  "description": "This section contains audio recordings of Ronnie Barker in theatre performances, radio, and copies of vinyl records featuring his comedy songs and sketches.",
  "about": ["Comedy","Ronnie Barker"],
  "inLanguage": "EN",
  "temporalCoverage": "1954-2005",
  "hasPart": "https://archiveshub.jisc.ac.uk/data/gb71-thm/407/thm/407/8/3",
  "isPartOf": "https://archiveshub.jisc.ac.uk/data/gb71-thm/407"
}
</script>

Page for a collection in the archive

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@id": "https://archiveshub.jisc.ac.uk/data/gb71-thm/407",
  "@type": "ArchiveCollection",	
  "identifier": "GB 71 THM/407/8",
  "name": "Ronnie Barker Collection",
  "about": ["Comedy","Ronnie Barker"],
   "creator": {
	 "@type": "Person",
	 "name": "Ronnie Barker",
	 "sameAs": "http://viaf.org/viaf/2676198"
  },
  "description": "The collection consists of memorabilia material collected by Ronnie Barker to document his career. Materials include scrapbooks compiled by Ronnie Barker with press cuttings, reviews, memorabilia and photographs of his theatre, television and film work, photographs, manuscript material, scripts, correspondence, certificates and awards, press and marketing materials, audio recordings, audio visual recordings and material relating to special events and honours in his career.",
  "inLanguage": "EN",
  "temporalCoverage": "1929-2005",
  "accessConditions": "This archive collection is available for consultation in the V&A Blythe House Archive and Library Study Room by appointment only. Full details of access arrangements may be found here: http://www.vam.ac.uk/content/articles/a/archives/.  Access to some of the material may be restricted. These are noted in the catalogue where relevant.",
  "contentLocation": "https://archiveshub.jisc.ac.uk/search/locations/eae30daa-1bf9-33d9-bf1c-7aeb220d2e76",
  "holdingArchive": "https://archiveshub.jisc.ac.uk/search/locations/eae30daa-1bf9-33d9-bf1c-7aeb220d2e76",
  "hasPart": "https://archiveshub.jisc.ac.uk/data/gb71-thm/407/thm/407/8"
}
</script>

Page for an archive

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@id": "https://archiveshub.jisc.ac.uk/search/locations/eae30daa-1bf9-33d9-bf1c-7aeb220d2e76",
  "@type": "Archive",
  "name": "V&A Theatre and Performance Collections",
  "url": "http://www.vam.ac.uk/content/articles/t/archives-theatre-performance/",
  "archiveHeld": "https://archiveshub.jisc.ac.uk/data/gb71-thm/407",
  "address": "Blythe House23 Blythe Road, London W14 0QX, England"
}
</script>