Metadaten aktualisieren - kitodo/kitodo-production GitHub Wiki

[!Note] Verfügbar ab Kitodo.Production 3.8.0

Funktionalität und Vorgehen

Vorgangsmetadaten, die über eine Suchschnittstelle nach Kitodo.Production importiert wurden, können über eine Schaltfläche im Metadaten-Editor aktualisiert werden:

Dies löst einen Re-Import der Metadaten anhand des gleichen Identifiers über die gleiche Suchschnittstelle aus und vergleicht das Ergebnis der erneuten Suchabfrage mit den bereits in Kitodo hinterlegten Metadaten. Bei diesem Vergleich festgestellte Unterschiede werden dem Nutzenden in einem Popup-Dialog präsentiert:

Die erste Spalte enthält dabei zunächst das Label des Metadatums, bei dem Unterschiede festgestellt wurden. Die mittlere Spalte zeigt die Werte, die aktuell in dem Kitodo-Vorgang vorhanden sind. In der rechten Spalte werden die durch die erneute Suchabfrage an die Katalogschnittstelle erhaltenen Werte zum Vergleich aufgelistet.

Der Nutzende hat nun die Möglichkeit, anhand der Pfeile zwischen der zweiten und dritten Spalte individuell für jedes Metadatum zu entscheiden, ob die in Kitodo bereits vorhandenen Werte beibehalten oder mit den vom Katalog erhaltenen Metadaten ersetzt oder ergänzt werden sollen. Die Werte, die zur Übernahme ausgewählt sind, werden zur besseren Erkennbarkeit in schwarzer Schrift dargestellt, während die zu verwerfenden Werte ausgegraut werden. Zusätzlich zeigt der Pfeil auf die Werte, die übernommen werden sollen.

Durch Klicken auf den Pfeil kann zwischen diesen drei Optionen durchgeschaltet werden:

https://github.com/user-attachments/assets/4766f168-ddd0-4484-b2d9-2420bada43ad

Voraussetzungen für Metadaten-Aktualisierung

Um die Metadaten-Aktualisierung nutzen zu können, müssen die folgenden Bedingungen erfüllt sein:

  • der Nutzende muss über mindestens eine Rolle die Berechtigung "Metadaten aktualisieren" haben
  • dem Vorgang muss eine Importkonfiguration vom Typ Katalogsuche zugewiesen sein, die die Quelle für die ursprüngliche und erneute Katalogabfrage definiert; Informationen zu Importkonfigurationen finden Sie hier.
  • der Vorgang muss einen eindeutigen Identifier in einem Metadatum enthalten, das im aktuellen Regelsatz als recordIdentifier konfiguriert wurde; dieser Identifier wird benötigt, um den gleichen Datensatz in der Katalogschnittstelle identifizieren und erneut laden zu können. Weitere Informationen zu "Funktionalen Metadaten" wie recordIdentifier sind hier zu finden.

Ist die erste Bedingung nicht erfüllt, wird der Knopf zum Aktualisieren der Metadaten nicht angezeigt. Falls die Berechtigung zum Aktualisieren der Metadaten vorhanden ist, eine der letzten beiden Bedingungen aber nicht erfüllt wurde, wird der Knopf angezeigt, bleibt jedoch inaktiv:

Importkonfigurationen für bestehende Vorgänge ergänzen

Vorgänge, die mit Kitodo.Production 3.8 oder später erstellt wurden, bekommen automatisch die Importkonfiguration zugewiesen, auf deren Grundlage sie erzeugt wurden. Für Bestandsvorgänge, die vor einem Update auf Kitodo.Production 3.8 entstanden sind, können Importkonfigurationen nachträglich entweder einzeln oder als Listenfunktion gesetzt werden.

Importkonfiguration für einzelne Vorgänge setzen

Für einzelne Vorgänge kann die Importkonfiguration über die Bearbeitungsmaske des Vorgangs im Reiter "Vorgangsdetails" direkt gesetzt werden:

Importkonfiguration als Listenfunktion

Über das "Aktionen"-Menü in der Vorgangsliste kann mithilfe der Option "Importkonfiguration setzen" die Importkonfiguration für alle ausgewählten Vorgänge auf einmal gesetzt werden:

Beim Klick auf diese Option erscheint ein Popup-Dialog, der die Auswahl der zu setzenden Importkonfiguration ermöglicht:

Hinweis: Zur Verwendung der Listenfunktion wird die Berechtigung "Importkonfiguration setzen" benötigt.

Hinweis 2: Aufgrund von technischen Einschränkungen der in Kitodo.Production verwendeten Suchindex-Software ist die Ausführung von Listenfunktionen wie "Importkonfiguration setzen" derzeut auf maximal 10.000 Vorgänge gleichzeitig beschränkt (siehe https://github.com/kitodo/kitodo-production/issues/6466)