Metainformationen zur Seite
  •  

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Nächste Überarbeitung		Vorhergehende Überarbeitung
json-ld [2025/12/11 12:26] – angelegt bcadminjson-ld [2025/12/11 13:00] (aktuell) – bcadmin
Zeile 18: Zeile 18:
 ===== Einleitung ===== ===== 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:
 +
 +<code>application/ld+json; profile="https://schema.org"</code>
 +
 +===== Prinzipien bei der Beschreibung von Sammlungsobjekten =====
 +
 +== Umfang eines Dokumentes ==
 +
 +Jedes JSON-Dokument beschreibt genau ein Sammlungsobjekt
 +
 +== Schema-Definition ==
 +
 +Als Schemadefinition kommt @context = "https://schema.org/" zum Einsatz
 +
 +== Schlüssel ==
 +
 +Als Schlüssel wird stets die kanonische Objekt-URL der BeeCollect Cloud verwendet, z.B:
 +<code>https://beecollect.cloud/resources/{customerCode}/objekts/{objectGuid}</code>
 +
 +== Typen ==
 +
 +Der Typ des beschriebenen Objektes wird über @type angegeben und ist ein geeigneter Schema.org-Typ.
 +
 +Die folgende Auswahl gibt einen Überblick über verfügbare schema.org-Typen:
 +  * Künstlich erzeugtes Objekt (allg.): **CreativeWork**
 +  * Kunstwerk, bildende Kunst: **VisualArtwork**
 +  * Fotografie: **Photograph**
 +  * Musikwerk (Komposition): **MusicComposition**
 +  * Musikaufnahme: **MusicRecording**
 +  * Film als Werk: **Movie**
 +  * Digitales Videoobjekt: **VideoObject**
 +  * Technisches Objekt / Gerät: **Product**
 +  * Fahrzeug: **Vehicle**
 +  * Natürliches Objekt (Mineral, Präparat): **Thing**
 +
 +== weitere Typisierung / Vokabulare ==
 +
 +Eine weitere fachspezische Festlegung von Typen (Gemälde, Gerät, Mineral usw.) erfolgt wahrweise über geeignete Schema.org-Typen und/oder über additionalType mit URIs auf Vokabular modelliert, welches über die BeeCollect Cloud abrufbar ist
 +
 +== leere oder fehlende Attribute ==
 +
 +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
  
 </WRAP> </WRAP>
 </WRAP> </WRAP>
  
↑