Konfiguration der Museums-Online-Schnittstelle

Mit der Museums-Online-Schnittstelle können Verzeichnungseinheiten für die Plattform Museums-Online exportiert werden. Die Konfiguration wird im Archiv Schema Editor vorgenommen.

Die Schnittstelle muss zusätzlich in der Verwaltungsoberfläche aktiviert werden.

Nachfolgend ist eine Beispielkonfiguration dargestellt, die verschiedene Optionen abdeckt:

museums-online:
  # Optional, welche Verzeichnungseinheiten exportiert werden:
  base-query:
    files_are_public: true
    has_media_types: true

  # Optional, maximale Anzahl pro Anfrage (Default: 100):
  max-records: 100

  # Zuordnung der Felder zum Export:
  field-mapping:
    - target: title
      fields:
        - title
    - target: creator
      fields:
        - museumsonline_persons
    - target: type
      fields:
        - archival_type
      enum: archival_type
    - target: identifier
      fields:
        - signature
        - inventory_number

Alle Eigenschaften sind optional und müssen nicht zwingend konfiguriert werden.

Die Felder werden im Dublin-Core-Namespace exportiert, z.B. als dc:title.

Mit base-query wird definiert, welche Verzeichnungseinheiten für den Export berücksichtigt werden. Die konfigurierten Filter werden bei jeder Anfrage automatisch angewendet. Im obigen Beispiel werden nur Verzeichnungseinheiten exportiert, die öffentliche Dateien haben und Medientypen enthalten. Ohne Konfiguration werden alle Verzeichnungseinheiten exportiert.

Mit max-records wird die maximale Anzahl der Verzeichnungseinheiten pro Anfrage begrenzt. Wenn eine höhere Anzahl angefragt wird, wird diese auf den konfigurierten Wert begrenzt. Der Default ist 100.

Mit field-mapping wird die Zuordnung von Feldern der Verzeichnungseinheiten zu den Zielfeldern im Export konfiguriert. Pro Eintrag wird ein Zielfeld (target) und eine Liste von Quellfeldern (fields) definiert. Der target-Wert enthält nur den Feldnamen (z.B. title), der Namespace-Prefix wird automatisch ergänzt. Als Quellfelder können sowohl Standardfelder (z.B. title, signature) als auch benutzerdefinierte Felder (z.B. museumsonline_persons) verwendet werden. Wenn mehrere Quellfelder angegeben werden, wird für jeden Wert ein separates Element im Export erzeugt. Felder mit mehreren Werten (Listen) werden mit , zusammengefasst.

Optional kann pro Eintrag ein enum angegeben werden. Damit werden die gespeicherten Werte (Identifier) durch die entsprechenden Enum-Labels ersetzt. Im obigen Beispiel wird archival_type mit dem Enum archival_type aufgelöst, sodass z.B. pic als Bild exportiert wird.

Unabhängig von der Konfiguration werden die URL der Verzeichnungseinheit im Webauftritt und die Thumbnail-URL (falls vorhanden) automatisch als Identifikatoren erzeugt.

Die technische Dokumentation der Schnittstelle (URL-Parameter, Beispielantworten) ist unter Museums-Online-Schnittstelle beschrieben.