Metainformationen zur Seite
  •  

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
json-ld [2025/12/11 12:39] – bcadminjson-ld [2025/12/11 13:00] (aktuell) – bcadmin
Zeile 19: Zeile 19:
  
 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. 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: Die Auslieferung der Daten erfolgt immer unter dem folgenden Content-Type:
Zeile 26: Zeile 28:
 ===== Prinzipien bei der Beschreibung von Sammlungsobjekten ===== ===== Prinzipien bei der Beschreibung von Sammlungsobjekten =====
  
-  * jedes JSON-Dokument beschreibt genau ein Sammlungsobjekt +== Umfang eines Dokumentes == 
-  * als Schemadefinition kommt @context = "https://schema.org/" zum Einsatz + 
-  * als Schlüssel wird stets die kanonische Objekt-URL der BeeCollect Cloud verwendet, z.B: +Jedes JSON-Dokument beschreibt genau ein Sammlungsobjekt 
-    <code>https://beecollect.cloud/resources/{customerCode}/objekts/{objectGuid}</code> + 
-  * @type ist ein geeigneter Schema.org-Typ +== Schema-Definition == 
-  * 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+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>
  
↑