JSON-LD (schema.org)

Einleitung

Die BeeCollect Cloud unterstützt die Bereitstellung von Daten in Form von JSON-LD unter Verwendung von schema.org als semantischen Standard. Damit wird ein niedrigschwelliger Zugang zu normierten Daten unter Verwendung eines etablierten Standards erreicht. Aus BeeCollect Professional als Quellsystem lassen sich Daten z.B. von Sammlungsobjekten sehr leicht in dem hier beschriebene Format abbilden.

Hinweis: Die folgende Dokumentation stellt einen Entwurf dar und hat rein informativen Charakter. Es wird keine Gewähr für eine Umsetzung entsprechend dem aktuellen Stand der Dokumentation übernommen.

Die Auslieferung der Daten erfolgt immer unter dem folgenden Content-Type:

application/ld+json; profile="https://schema.org"

Prinzipien bei der Beschreibung von Sammlungsobjekten

• jedes JSON-Dokument beschreibt genau ein Sammlungsobjekt
• als Schemadefinition kommt @context = „https://schema.org/“ zum Einsatz
• als Schlüssel wird stets die kanonische Objekt-URL der BeeCollect Cloud verwendet, z.B:

https://beecollect.cloud/resources/{customerCode}/objekts/{objectGuid}

• @type ist ein geeigneter Schema.org-Typ
• fachliche Objektklassen (Gemälde, Gerät, Mineral usw.) werden über Schema.org-Typen und/oder über additionalType mit URIs auf Vokabular modelliert, welches über die BeeCollect Cloud abrufbar ist
• es werden nur Eigenschaften ausgeliefert, für die Werte vorhanden sind. Leere Strings oder Null-Werte werden nicht exportiert

Verfügbare Attribute / Felder

Pflichtfelder

Jedes Objekt stellt folgende Felder bereit:

• @context – immer „https://schema.org/“
• @id – kanonische Objekt-URI
• @type – Schema.org-Typ
• identifier – Inventarnummer / lokale Signatur (String oder Liste)
• name – Titel / Bezeichnung des Objekts

Soll-Felder

Jedes Objekt sollte folgende Felder bereitstellen:

• description – Kurzbeschreibung
• creator – Person oder Organisation (bei Kunstwerken / Medien)
• dateCreated – Entstehungsdatum / Datierung (ISO-Datum oder Freitext)
• material bzw. artMedium – Material / Technik
• location – aktueller Standort (Depot, Raum, Außenstelle)
• provider – haltende Institution / Museum
• medium – URL(s) zu Digitalisaten
• license – URI der Lizenz (z. B. CC-Lizenzen)
• rightsHolder – Rechteinhaber:in
• additionalType – URI des passenden Vokabular-Knotens in BeeCollect

Kann-Felder

Darüber hinaus können Objekte noch folgende Felder enthalten:

• alternateName – weitere Titel / Varianten
• width / height / depth / weight – Maße als QuantitativeValue
• size – Maße als Freitext
• locationCreated – Entstehungsort
• spatialCoverage / contentLocation – geografischer Bezug (Motiv, Fundort)
• provenance – Provenienztext
• subjectOf – Link zu einer detaillierten Repräsentation des Objektes, z.B in BeeCollect Web