IIIF Presentation API

Die Metadaten eines Teils von über Memobase verfügbaren Dokumenten werden ebenfalls als sog. IIIF Manifeste angeboten, was eine Einbindung dieser Dokumente auf Drittsystemen möglich macht.

Die nachfolgende Beschreibung gilt für die Versionen 2 und 3 der Presentation API. Ziel ist die Abbildung des Memobase RDF Datenmodells auf die Basistypen der IIIF Presentation API.

Allgemeines

IIIF-Manifeste, wie sie über memobase.ch zur Verfügung gestellt werden, beschreiben immer nur ein Memobase-Dokument, allerdings wird nicht zu jedem Dokument ein Manifest erstellt. Folgende Voraussetzungen müssen erfüllt sein:

Eine digitale Ressource zum Dokument ist vorhanden und kann in Memobase eingebunden werden (Dokument ist nicht onsite oder noonsite)
Es handelt sich um eine Bildressource oder die Ressource kann ohne externen Player abgespielt werden, wobei in letzterem Fall nur ein Manifest der Version 3 erstellt wird
Das Dokument ist publiziert und öffentlich zugänglich (nicht Memobase+)

IIIF Presentation API 2

IIIF Presentation Resources

Die Basisressourcen der IIIF Presentation API v2.1 haben folgende Entsprechungen im Memobase-Datenmodell

Manifest ↔︎ Record
Sequence ↔︎ Keine Entsprechung im Memobase-Datenmodell, dient als Container für das einzelne Canvas
Canvas ↔︎ Keine Entsprechung im Memobase-Datenmodell, dient als Container für den Content
Image Resource ↔︎ Digitales Objekt

IIIF Presentation Properties

Die folgende Tabelle gibt Auskunft über das detaillierte Mapping zwischen Memobase RDF Datenmodell und IIIF-Ressourcentypen. Ein grünes Feld bedeutet dabei das Erstellen des entsprechenden Feldes im IIIF-Dokument, ein Oranges eine mögliche Erweiterung zu einem späteren Zeitpunkt, ein Rotes schliesslich eine Inkompatibilität zwischen entsprechenden Feld und Ressourcentyp.

IIIF Properties	Manifest	Sequence	Canvas	Image Resource
label	`record → rico:title`	Keine Entsprechung	Immer `digitalObject`	Redundant, da nur ein Bild pro Manifest
metadata	`rico:descriptiveNote` `rico:scopeAndContent` `rico:hasPublisher → rico:name` `rdau:P60556` (place of capture) `dct:spatial → rico:name` `dct:hasLanguage → rico:name` `recordSet → rico:title` `rico:recordResourceOrInstantiationIsSourceOfCreationRelation → rico:name + rico:creationRelationHasTarget → rico:name` `rdau:P60441 → rico:name` (producer)	Keine Entsprechung	Keine Entsprechung	`digitalObject → edm:componentColor` (key: `componentColor`, value: Liste)
description	`record → dct:abstract`	Keine Entsprechung	Keine Entsprechung	`digitalObject → ebucore:mediaResourceDescription`
thumbnail	Redundant	Redundant	Redundant	Für Bilder werden keine separaten Thumbnails erstellt
attribution	`record → rico:conditionsOfUse` `record` -> `rico:isOrWasRegulatedBy` -> `(type holder)` -> `rico:name`	Vermutlich redundant (vgl. license)	Vermutlich redundant (vgl. license)	Vermutlich redundant (vgl. license)
license	Redundant	Redundant	Redundant	`digitalObject` -> `rico:isOrWasRegulatedBy` -> `(type usage)` -> `rico:name`
logo	`recordSet → rico:heldBy → wdt:P154`	Redundant	Redundant	Redundant
@id	URI zum Manifest (dereferenzierbar) in der Form `{scheme}://{host}/{prefix}/{identifier}/manifest`	URI zur Sequence (nicht dereferenzierbar) in der Form `{scheme}://{host}/{prefix}/{identifier}/sequence/{name}`, wobei `name = default`	URI zur Sequence (nicht dereferenzierbar) in der Form `{scheme}://{host}/{prefix}/{identifier}/canvas/{name}`, wobei `name = default`	URI zur Datei (via Medienserver)
@type	Immer `sc:Manifest`	Immer `sc:Sequence`	Immer `sc:Canvas`	Immer `dctypes:Image`
format				`digitalObject → ebucore:hasMimeType`
height			`digitalObject → ebucore:height`	`digitalObject → ebucore:height`
width			`digitalObject → ebucore:width`	`digitalObject → ebucore:width`
viewingDirection	Im Moment sinnlos, da nur ein Canvas / Bild	Im Moment sinnlos, da nur ein Canvas / Bild
viewingHint	Immer `individuals`	Immer `individuals`	Obsolet, wenn sequence nicht gleich `paged`
navDate	`record → dct:created`
related	Keine entsprechenden Informationen vorhanden	Keine entsprechenden Informationen vorhanden	Keine entsprechenden Informationen vorhanden	Keine entsprechenden Informationen vorhanden
rendering	Link zur Objektseite	Redundant	Redundant	Redundant
service	Im Moment unnötig	Im Moment unnötig	Im Moment unnötig	Im Moment unnötig
seeAlso	Keine entsprechenden Memobase-Ressourcen vorhanden	Keine entsprechenden Memobase-Ressourcen vorhanden	Keine entsprechenden Memobase-Ressourcen vorhanden	Keine entsprechenden Memobase-Ressourcen vorhanden
within	Im Moment unnötig	Im Moment unnötig	Im Moment unnötig	Im Moment unnötig
startCanvas		Im Moment sinnlos, da nur ein Canvas vorhanden
contentLayer
first
last
total
next
prev
startIndex

IIIF Presentation API 3

IIIF Presentation Resources

Grün hinterlegte Ressourcen werden in Memobase-Manifesten verwendet

IIIF Presentation Properties

Farbcodierung:

Grün: Property wird mit Metadaten aus Memobase-Dokumenten befüllt
Orange: Property wird nicht mit Metadaten aus Memobase-Dokumenten befüllt
Rot: IIIF-Presentation-Standard sieht das Feld auf der Ressource nicht vor

IIIF Properties	Manifest	Canvas	Annotation	Content Resource
label	`record → rico:title`	Redundant	Redundant	Redundant
metadata	`rico:descriptiveNote` `rico:scopeAndContent` `record` -> `dct:created` `rico:hasPublisher → rico:name` `rdau:P60556` (place of capture) `dct:spatial → rico:name` `dct:hasLanguage → rico:name` `recordSet → rico:title` `rico:recordResourceOrInstantiationIsSourceOfCreationRelation → rico:name + rico:creationRelationHasTarget → rico:name` `rdau:P60441 → rico:name` (producer)	Keine Entsprechung	Keine Entsprechung	`digitalObject → edm:componentColor` (key: `componentColor`, value: Liste)
summary	`record -> dct:abstract`	Redundant	Redundant	`digitalObject → ebucore:mediaResourceDescription`
requiredStatement	Redundant	Redundant	Redundant	Rechte und Rechtehalter: `digitalObject` -> `rico:isOrWasRegulatedBy` -> `(type usage)` -> `rico:sameAs` und `digitalObject` -> `rico:isOrWasRegulatedBy` -> `(type holder)` -> `rico:name`
rights	Redundant	Redundant	Redundant	`digitalObject` -> `rico:isOrWasRegulatedBy` -> `(type usage)` -> `rico:sameAs`
navDate	Redundant	Entstehungsdatum in Metadaten nicht einheitlich
language				Entfällt für Ressourcen, welche von einer Annotation referenziert werden
provider	Institution: id: `record` -> `rico:hasOrHadHolder` -> `@id` (Präfix entfernen) label: (=id, faute de mieux…) homepage: Memobase-Seite	Redundant	Redundant	Redundant
thumbnail	Redundant	Thumbnail-Canvas (nur Bild und Video)	Redundant	Redundant
placeholderCanvas	Poster-Canvas (nur Video)	Redundant
accompanyingCanvas	Keine entsprechende Memobase-Ressource vorhanden	Redundant
id	`{scheme}://{host}/{prefix}/{identifier}/manifest` (dereferenzierbar)	`{scheme}://{host}/{prefix}/{identifier}/canvas/{default or placeholder}` (nicht dereferenzierbar)	`{scheme}://{host}/{prefix}/{identifier}/annotation/{default or placeholder}` (nicht dereferenzierbar)	URI zur Datei (via Medienserver); wird generiert auf Grundlage von ID
type	`Manifest`	`Canvas`	`Annotation`	Audio: `Sound` Bild: `Image` Video: `Video`
format				`digitalObject → ebucore:hasMimeType`
profile				Keine weitere Spezifizierung notwendig
height		Redundant		(nur Bild und Video): `digitalObject -> ebucore:height`
width		Redundant		(nur Bild und Video): `digitalObject -> ebucore:width`
duration				(nur Audio und Video): `digitalObject -> ebucore:duration`
viewingDirection	Enfällt, da 1:1 Beziehung zwischen Manifest und Canvas
behavior	`no-auto-advance`, `non-paged`, `individuals`	`no-auto-advance`, `non-paged`	Keine relevanten Werte für Content Resources in Standard für Anwendungsfall definiert	Keine relevanten Werte für Content Resources in Standard für Anwendungsfall definiert
timeMode			Verwendet Standardwert (`trim`)
seeAlso	Keine entsprechenden Memobase-Ressourcen vorhanden	Keine entsprechenden Memobase-Ressourcen vorhanden	Keine entsprechenden Memobase-Ressourcen vorhanden	Keine entsprechenden Memobase-Ressourcen vorhanden
service	Kein entsprechender Memobase-Service vorhanden	Kein entsprechender Memobase-Service vorhanden	Kein entsprechender Memobase-Service vorhanden	Kein entsprechender Memobase-Service vorhanden
homepage	id: `https://memobase.ch`, `https://stage.memobase.ch` oder `https://test.memobase.ch` type: `Text` label: `MEMOBASE von Memoriav`, `MEMOBASE de Memoriav`, `MEMOBASE di Memoriav` format: `text/html` language: `de`, `fr` und `it`	Redundant	Redundant	Redundant
rendering	Keine entsprechenden Memobase-Ressourcen vorhanden	Keine entsprechenden Memobase-Ressourcen vorhanden	Keine entsprechenden Memobase-Ressourcen vorhanden	Keine entsprechenden Memobase-Ressourcen vorhanden
partOf	Keine externen Referenzen auf IIIF-Ressourcen	Keine externen Referenzen auf IIIF-Ressourcen	Keine externen Referenzen auf IIIF-Ressourcen	Keine externen Referenzen auf IIIF-Ressourcen
start	Enfällt, da 1:1 Beziehung zwischen Manifest und Canvas
supplementary
services	Kein entsprechender Memobase-Service vorhanden

Praktische Anwendung

Die IIIF-APIs sind bereits verfügbar, im Moment werden sie einfach nicht vom Frontend her verlinkt. Am Beispiel des Bilddokumentes smi-001-011510:

Image API

https://media.memobase.k8s.unibas.ch/memo/smi-001-011510-1/iiif/full/800,800/0/default.jpg

image.json

https://media.memobase.k8s.unibas.ch/memo/smi-001-011510-1/iiif/info.json

Manifest (v2)

https://media.memobase.k8s.unibas.ch/memo/smi-001-011510-1/manifest/v2

Bemerkung

Ein eigentlicher voll ausgereifter IIIF-Viewer wird im Moment nicht über Memobase angeboten, sieht man von OpenSeadragon ab, wie auf der Objektseite verfügbar (https://memobase.ch/de/object/smi-001-011510 ).

Es ist aber natürlich möglich, via Manifest-Link eine Ressource in einem bereits aufgesetzten Viewer wie Mirador zu verwenden.