Dieses Dokument beschreibt die benötigten technischen Komponenten zur Umsetzung der Anforderungen für themenspezifische Zugänge im Archivportal-D sowie für das Zugehörige Schlagworttool. Als Grundlage dienten die Konzepte und Mockups des Themenportals Weimar.

Funktionsblöcke und Technische Implementierung

Zuordnungstool-Backend 

Das Zuordnungstool-Backend ist eine Serverkomponente, die mittels HTTP-REST-Aufrufen angesprochen wird und die das Anlegen und Bearbeiten von Systematiken, Schlagwörtern, nutzerspezifischen Merklisten, Bestandsselektionen und Schlagwortzuordnungen ermöglicht. Die Endpunkte werden vom Zuordnungstool und vom APD-Frontend verwendet.

...

Themenportal und Systematikknoten werden mit internen Primärschlüsseln im System abgespeichert, bei Schlagwörtern ist die xTree-Uri der Primärschlüssel. Die xTree-URI muss bei Schlagwörtern eindeutig und stabil sein!

Beschreibung eines Zuordnungs-Workflows:

• Ein Nutzer loggt sich in APD ein, sucht und legt Objekte in seine Merkliste.
  • Merklisten werden mit den Nutzerdaten in Elasticsearch gespeichert (vorhandene Funktionalität)
• Der Nutzer loggt sich im Verknüpfungstool ein und wählt eine seiner Merklisten aus.
• Alle Objekte der Merkliste werden mit den schon zugeordneten Schlagwörtern angezeigt.
  • Es werden Schlagwörter angezeigt, die der eingeloggte Nutzer zugeordnet hat. Diese können editiert werden.
  • Es werden Schlagwörter angezeigt, die von anderen Nutzern zugeordnet wurden. Diese sind nicht editierbar (oder nur vom Administrator).
• Auswahl der Schlagwörter durch Auswahl des Themenportals und Browsen durch die Systematik 
• Schlagwörter können mit einem "Status" zugeordnet werden (AUTOSUGGESTED, SUGGESTED, DELETESUGGESTED, ACCEPTED, REJECTED, PUBLISHED, DELETED)
  
  • Der Status einer Schlagwort-Zuordnung kann später verändert werden.
• Einzelnen Objekten aus der Merkliste lassen sich Schlagwörter zuordnen oder der Status schon zugeordneter Schlagwörter lässt sich ändern.
• Allen Objekten aus der Merkliste, die einem gemeinsamen Aggregationsknoten zugehören, können über diesen in einem Schritt Schlagwörtern zugeordnet werden. 

Endpunkte

Assignment-Tool-Backend Endpoints

Sekundäre Datenhaltung, Tabellenstruktur der Datenbank

Assignment-Tool-Backend Database

Schlagwort-App

Die Schlagwort-App ordnet anhand von Schlagwortvorschlägen Schlagwörter zu. Die Schlagwortvorschläge werden automatisch erzeugt und als RDF abgelegt. Die Schlagwort-App liest die automatisch erzeugten RDF-Triples ein und ruft mit den Informationen den Endpunkt des Zuordnungstool-Backends auf, um die Schlagwörter in der Tabelle objects_keywords mit dem Status "AUTOSUGGESTED" zu speichern.

Themenportal-Frontend

Im Themenportal bewegen sich Nutzende in der Regel browsend, d.h. sie schränken die Liste der angezeigten Objekte über Schlagwort-Facetten ein. Achtung: eine Einschränkung über die Systematik-Facetten ist nicht vorgesehen. Es soll auch möglich sein, alle Objekte einer Kategorie zu finden, egal auf welcher Hierarchiestufe sich die Kategorie befindet. Technisch wird das über eine Einschränkung auf alle Schlagwörter umgesetzt, die sich in der Hierarchie unterhalb der ausgewählten Kategorie befinden.

...

Zusätzlich können Objekte über einen Suchschlitz gesucht und anschließend das Suchergebnis über Facetten eingeschränkt werden. DIe geforderte gleichzeitige Freitext-Suche und Einschränkung auf Schlagwort-Facetten bedingt, dass die Facetten im normalen Suchindex der DDB enthalten sein müssen. Die Suche wird im Themenportal dann immer eingeschränkt auf die top-level category_id erfolgen.

Verknüpfung von Kategorien und Images:

Im Themenportal-Frontend werden die Kategorien der 2. Ebene mit Bildern angezeigt. Diese Bilder sollen über die Drupal-Adminoberfläche der Kategorie zugeordnet werden.

Dazu muss der Nutzer in Drupal das Bild hochladen und dann mit Drupal-Bordmitteln dafür sorgen dass das Bild mit einem festen Link verknüpft wird der nicht den Namen oder Dateinamen etc des Bildes enthält sondern mit <themenportalId>/<categoryId> endet. (Genaues Vorgehen wird hier noch dokumentiert). Dieser Link kann dann vom Themenportal-Frontend durch Einfügen der categoryId generiert werden. Dieser Link ist stabil. Über Drupal kann das Bild das hinter dem Link liegt geändert werden.

Backend-Zugriffe

Das Themenportal-Frontend greift zu auf:

• Schlagwort-Backend
  • Hierarchiestufen der Systematiken
  • Umsetzung keywordIds in label für die Facettenwerte
• Suchindex
  • Suche und Facettenwerte
• DDB-Backend
  • Einzelobjekt-Anzeige

Neue Indexfelder im DDB Suchindex

• tp_keyword_id_<category_id> (Schlagwort mit gegebener category_id in der 2. Ebene der Hierarchie)
• tp_category_id (oberste Ebene der Hierarchie, d.h. Themenportal)

Indexierung der Schlagwörter im Suchindex

Schlagwörter werden von der IngestApp mit in die zu indexierenden Daten geschrieben. Dazu wird für das Themenportal ein neuer Worker in den IngestApp-Workflow integriert, der für die prozessierte ddbId die zugeordneten Schlagwörter aus den Datenbanktabellen des Schlagwort-Backends liest und in die zu indexierenden Daten schreibt. Dadurch wird sichergestellt, dass die Schlagwörter auch dann neu indexiert werden, wenn das Objekt über die Dash-Oberfläche neu geladen wird.

...