BeeCollect Cloud: Wie es funktioniert

Die BeeCollect Cloud API

Die BeeCollect Cloud API ermöglicht das sichere Hoch- und Herunterladen von Daten und Medien in die BeeCollect Cloud über ein modernes Authentifizierungs- und Freigabeverfahren. Daten und Medien können dabei nur von entsprechend berechtigten Akteuren eingesehen oder verändert werden.

Neben der BeeCollect Cloud API sind in der BeeCollect Cloud auch noch weitere Schnittstellen wie OAI-PMH oder IIIF integriert - auf diese wird an anderer Stelle noch näher eingegangen.

Authentifizierung und Rechtevergabe

In der BeeCollect Cloud sind alle Daten und Medien einer Organisation zu einem gemeinsamen Core zusammengefasst. Damit eine Person oder eine Software auf diesen Core zugreifen kann, wird ein ShareKey benötigt.

Jede Organisation besitzt genau einen primären ShareKey, welcher den gesamten Core repräsentiert und „der Organisation gehört“, die die Daten bereitstellt. Zusätzlich können weitere ShareKeys erzeugt werden. Solche zusätzlichen ShareKeys werden gezielt bestimmten eigenen Daten(sätzen) zugeordnet und an externe Akteure weitergegeben – zum Beispiel Partnerinstitutionen oder Projekte. Ein ShareKey ist dabei nicht nur ein Zugangsschlüssel, sondern enthält gleichzeitig die Berechtigungen, also welche Daten gesehen oder genutzt werden dürfen und in welchem Umfang.

Um überhaupt mit der Cloud arbeiten zu können (also z. B. Daten abzufragen oder zu importieren), wird außerdem ein AccessToken benötigt. Dieses Token wird über den Organisations-Schlüssel zusammen mit einem Secret - also einem Geheimwort - angefordert. Das AccessToken ist jeweils 10 Minuten gültig und dient als kurzfristiger, sicherer Arbeitsnachweis für die laufende Verbindung.

Man könnte diese Mechanik auch kurz beschreiben mit:

• AccessToken = „Wer bist du?“
• ShareKey = „Welche Daten darfst du mit welchen Rechten nutzen?“

Daten und Medien hochladen und teilen

Für Organisationen, die BeeCollect Professional nutzen, ist der Zugang zur BeeCollect Cloud recht einfach. Das Programm BeeCollect Professional enthält in den relevanten Programmmodulen bereits alle notwendigen Funktionen, um Daten und Medien für die Bereitstellung in der BeeCollect Cloud zu markieren und festzulegen, mit wem sie geteilt werden sollen. Die eigentliche Bereitstellung übernehmen dann BeeCollect Sync bzw. der BeeCollect Server. Hier werden die ausgewählten Daten in das für die BeeCollect Cloud vorgesehene Format (z.B. BC_JSON, LIDO, EDM, DC, JSON-LD oder SKOS) transformiert und dann in die BeeCollect Cloud hochgeladen.

Akteure ohne BeeCollect Professional können ebenfalls Daten in der BeeCollect Cloud bereitstellen, wenn sie dazu berechtigt sind. Die BeeCollect Cloud API ist entsprechend dokumentiert, so dass es mit wenig Aufwand möglich ist, eine eigene Schnittstelle zur BeeCollect Cloud zu implementieren. Wir stellen dafür ein Swagger-YAML bereit, welches alle dafür notwendigen Deklarationen und Parameter enthält.

Daten und Medien herunterladen

Das Herunterladen von Daten und Medien erfolgt, sofern die Daten nicht öffentlich über OAI-PMH oder IIIF freigegeben sind, ebenfalls über die BeeCollect Cloud API. Über den von der sendenden Organisation bereitgestellten ShareKey kann ein Akteur auf die mit dem ShareKey assoziierten Daten zugreifen und sie zur Weiterverarbeitung herunterladen.

Daten bidirektional austauschen

Auch ein bidirektionaler Austausch von Daten zwischen verschiedenen Akteuren ist möglich. Alle Daten und Medien haben in der BeeCollect Cloud einen eindeutigen Schlüssel. Dieser ist identisch mit dem in BeeCollect Professional für den entsprechenden Datensatz oder das Medium verwendeten Schlüssel. Da als Format für diese Schlüssel der GUID-Standard verwendet wird, können auch externe Akteure ohne BeeCollect Professional Daten bereitstellen, die dann problemlos vom Empfänger in BeeCollect Professional bearbeitet werden können. Voraussetzung dafür ist ein einheitlichen Datenformat von Sender und Empfänger.

Datenformate in der BeeCollect Cloud

Die BeeCollect Cloud ist nicht festgelegt auf ein bestimmtes Datenformat, da innerhalb der BeeCollect Cloud keinerlei Verarbeitung der übermittelten Daten erfolgt. Die Daten werden hier nur gespeichert und bei Bedarf zur Verfügung gestellt.

Organisationen, die BeeCollect Professional verwenden, benutzen BeeCollect Sync bzw. den BeeCollect Server für die Transformation der zu sendenen oder empfangenen Daten in und aus dem für dem jeweiligen Datenformat. Aktuell kann BeeCollect Sync folgende Datenformate für die BeeCollect Cloud bereitstellen:

LIDO

• Basisformat: XML
• gut geeignet zur Lieferung von Daten an Portalsysteme wie die DDB
• relativ hohe semantische Anforderungen an die Datenqualität (Event-Struktur)
• relativ hoher Mapping-Aufwand von und nach BeeCollect Professional (wenig vergleichbare Datenstruktur)
• nicht gut geeignet für bidirektionalen Datenaustausch (fehlende Schlüssel-Attribute und Zeitstempel auf vielen Informationsebenen)

EDM

• Basisformat: XML
• gut geeignet zur Lieferung von Daten an Portalsysteme wie Europeana oder kulturpool.at
• mittlere semantische Anforderungen an die Datenqualität
• mittlere Informationstiefe
• mittlerer Mapping-Aufwand von und nach BeeCollect Professional
• nicht gut geeignet für bidirektionalen Datenaustausch (fehlende Schlüssel-Attribute und Zeitstempel auf vielen Informationsebenen)

DC (Dublin Core)

• Basisformat: Plain Text
• notwendig zur Bereitstellung von Daten über OAI-PMH
• geringe semantische Anforderungen an die Datenqualität
• geringer Informationstiefe
• geringer Mapping-Aufwand von und nach BeeCollect Professional
• nicht gut geeignet für bidirektionalen Datenaustausch (fehlende Schlüssel-Attribute und Zeitstempel auf praktisch allen Informationsebenen)

BC_JSON

• Basisformat: JSON
• proprietäres Datenformat (kein anerkanntes Standardformat)
• geringe semantische Anforderungen an die Datenqualität (objektzentrisch, nicht ontologisch)
• hohe Informationstiefe
• geringer Mapping-Aufwand von und nach BeeCollect Professional
• sehr gut geeignet für birektionalen Datenaustausch (Schlüssel-Attribute und Zeitstempel auf allen Informationsebenen vorhanden)

Möchten Sie Daten in einem anderen Datenformat austauschen, sprechen Sie mit uns. Wir entwickeln dann gemeinsam mit Ihnen ein entsprechendes Import-Export-PlugIn für dieses Format.