Reimport von Titelmetadaten einzelner Vorgänge - Version 2

[andre-hohmann]

Einleitung

Im Community Board wurde die bisherige Diskussion unter Reimport von Titelmetadaten einzelner Vorgänge besprochen. Im Folgenden werden die Erkenntnisse und Ergebnisse in Form einer Leistungsbeschreibung zusammengefasst.

Ziel

Implementierung einer Funktion zur Aktualisierung der Metadaten je Vorgang durch manuelles Auslösen im Metadateneditor.

Weitere Informationen:

• Reimport von Titelmetadaten einzelner Vorgänge #5790
• Make behaviour of repeated import configurable #5613
• Protokoll: 2023‐10‐17 Community Board (Kitodo.Production)

Handlungsfelder

Anpassungen Metadateneditor

Anpassung Frame “Strukturdaten”

• Implementierung einer Funktionsleiste in dem Frame “Metadaten”
  • Die Implementierung soll sich an der vorhandenen Funktionsleiste in dem Frame “Strukturdaten” orientieren

Erstellung/Anpassung von Schaltflächen

• Gestaltung und Implementierung einer neuen Schaltfläche für den Import von Metadaten
  • Die Funktionalität der Schaltfläche ist nur verfügbar, wenn ein Reimport möglich ist, ansonsten ist die Funktionalität nicht verfügbar und die Schaltfläche wird entsprechend angepasst, zum Beispiel “ausgegraut”.
  • Die Schaltfläche enthält keinen Text, sondern ein Symbol, das sich in das allgemeine Konzept der Schaltflächen in Kitodo.Production einfügt.
  • Das Beispiel-Symbol in der Diskussion darf nicht genutzt werden, weil die Nachnutzung/Weiterverwendung nicht abgestimmt wurde.
• Anpassung der Schaltfläche zum Hinzufügen von Metadaten
  • Die bestehende Schaltfläche zum Hinzufügen von Metadaten wird in die Funktionsleiste übertragen
• Erstellung eines Kontextmenüs durch Mouseover für
  • Schaltfläche zum Reimport
    • Textvorschlag: “Reimport der Metadaten”
  • Schaltfläche zum Hinzufügen von Metadaten
    • Vorhandener Text wird beibehalten: “Neue Metadaten hinzufügen”

Erstellung Import-Dialog

• Gestaltung und Implementierung eines Import-Dialogs, dessen Form weitgehend aus folgendem Vorschlag übernommen wird:
  • Reimport von Titelmetadaten einzelner Vorgänge #5790 (comment)
• Erstellung einer Seite mit Dokumentation im Kitodo-Wiki, die ausführliche Informationen über die angebotenen Funktionen enthält. Dies kann ebenfalls weitgehend aus dem folgenden Vorschlag übernommen und entsprechend erweitert werden
  • Reimport von Titelmetadaten einzelner Vorgänge #5790 (comment)
• Folgende Funktionen werden berücksichtigt
  • Anzeige der geänderten Metadaten und der im Regelsatz definierten Regel
    • Metadaten werden nicht angezeigt, wenn alle Werte des Metadatums unverändert sind - wird jedoch ein Wert des Metadatums geändert, wie zum Beispiel ein Wert für die Sprache entfernt, werden alle Werte des Metadatums angezeigt um die mögliche Auswirkung zu zeigen
    • Siehe Beispiele
  • Kontextmenü durch Mouseover für
    • Hilfe-Symbol: Knappe Informationen zu den Funktionen der Pfeile
  • Benennung der Tabellenkopfzeile für Spalte mit Pfeilen
    • “Art der Änderung”
    • Die vorgeschlagene Funktionalität (Anpassung aller Zeilen) in der Tabellen-Kopfzeile wird nicht benötigt
      • Reimport von Titelmetadaten einzelner Vorgänge #5790 (comment)
  • Metadatengruppen: Es werden nur die Unterelemente angezeigt und ausgewertet, die geändert wurden
    • Import-Funktion:
      • Nur komplette Übernahme der neuen Versionen oder Beibehaltung der alten Versionen aller Metadatengruppen eines im Regelsatz definierten Key (Person, Körperschafts)
      • Die Daten einer Metadatengruppe dürfen nicht gemischt werden, weil dies die Funktionalität stark verkompliziert und wenige Anwendungsfälle erwartet werden
    • Anzeige des Wertes eines definierten Feldes je Metadatengruppe, zum Beispiel “DisplayLabel” für Personen
      • Dies muss im Regelsatz durch ein zu erstellendes Attribut definiert werden können, wie zum Beispiel: “groupDisplayLabel”
    • Siehe Beispiele für spezifische Anwendungsfälle
       

Anpassungen des Regelsatzes, der Metadaten, der Import-Konfiguration

• Implementierung einer Funktion, um die Quelle der Metadaten zu identifizieren und um die Metadaten des korrekten Vorgangs zu reimportieren.
  • Die folgenden Optionen müssen mit den Entwicklern und vermutlich mit dem Release-Management abgestimmt werden, weil das Community Board die technischen Bewertung nicht durchführen kann
    • Regelsatz-Konfiguration
      • Option 1: Dies erfolgt durch ein neu zu definierendes Attribut, wie zum Beispiel: 'use="catalogIdentifier"'.
        “use=’recordIdentifier’” kann nicht in allen Fällen angewendet werden
    • Import-Konfiguration
      • Option 1: Dies erfolgt durch die Import-Konfiguration, die in den jeweiligen meta.xml-Dateien enthalten sind - durch ein neu zu definiertendes Metadatum mit der ID der Importkonfiguration
      • Option 2: Dies erfolgt durch den Eintrag der ID der Import-Konfiguration, im Datenbank-Eintrag des jeweiligen Vorgangs (Vorgangs-Eigenschaften)
• Die in dem Import-Dialog angezeigten Änderungen werden mit den bestehenden Funktionen “Add”, “Replace”, “Keep” im Regelsatz realisiert.
  • Make behaviour of repeated import configurable #5613
• Eine Funktion “Löschen” von Metadaten in Kitodo.Production wird ausdrücklich nicht erwünscht. Auch dann nicht, wenn die Metadaten nicht (mehr) im Quellsystem vorhanden sind.

Anpassungen vorhandener Vorgänge

• Für den Fall, dass die notwendigen Informationen (Import-Konfiguration, …) nicht in den alten Vorgängen enthalten sind, muss eine Möglichkeit geschaffen werden, dies nachträglich hinzuzufügen
• In Vorgängen, die in Kitodo.Production ohne Katalog-Import angelegt wurde, wird das Symbol ausgegraut und ist nicht aktivierbar

Grundsätzliche Anforderungen

• Die Änderungen dürfen erst nach “Speichern” des Vorgangs im Metadateneditor in die XML-Datei eingetragen werden
  • Die Änderungen müssen beim Speichern eine neue XML-Datei erzeugen und die alte XML-Datei gesichert werden.

Beispiele

Beispiel: Metadatum ist nicht in Kitodo.Production vorhanden

Vorschlag Anzeige Import-Dialog

Erläuterung

• Ein Metadatum ist nicht in Kitodo.Production vorhanden: es werden die Werte angezeigt und es ist eine Aktion, wie zum Beispiel “Ersetzen” (→) verfügbar

Beispiel: Metadatum ist in Kitodo.Production vorhanden

Vorschlag Anzeige Import-Dialog

Erläuterung

• Ein Metadatum ist in Kitodo.Production vorhanden und es werden die Werte angezeigt und es ist eine Aktion, wie zum Beispiel “Ergänzen” (↔) verfügbar
   

Beispiel: Metadatum ist nicht (mehr) im Quellsystem vorhanden

Vorschlag Anzeige Import-Dialog

Erläuterung

• Ein Metadatum ist nicht (mehr) im Quellsystem vorhanden: es werden die Werte angezeigt, jedoch ist keine Aktion, wie zum ## ## Beispiel “Löschen” verfügbar
• Es kann geprüft werden, ob manuelle Anpassungen in Kitodo.Production notwendig sind

Beispiel: Import Metadatengruppe (Person)

Änderung der Metadaten zweier Personen-Datensätzen von insgesamt zwei Datensätzen

Vorschlag Anzeige Import-Dialog

Erläuterung

• Es wird für jede Gruppe ein Metadatum angezeigt, das die Gruppe beschreibt. Zusätzlich werden die Werte der geänderten Metadatenfelder angezeigt
• Es werden entweder alle Gruppen übernommen oder gar keine
• Grund: Eine eindeutige Zuweisung der Datensätze ist nicht möglich, weil alle den gleichen Key für die jeweiligen Unterfelder benutzen

Änderung der Metadaten zweier Personen-Datensätzen von insgesamt drei Datensätzen

Vorschlag Anzeige Import-Dialog

Erläuterung

• Es wird für jede Gruppe ein Metadatum angezeigt, das die Gruppe beschreibt. Zusätzlich werden die Werte der geänderten Metadatenfelder angezeigt
• Prüfen, ob bei Metadatengruppen auch unveränderte Datensätze angezeigt werden, weil keine eindeutige Zuweisung der jeweiligen Datensätze möglich ist.
   

Beispiel: Import Metadatengruppe (Link)

Änderung der Metadaten zweier Link-Datensätzen von insgesamt zwei Datensätzen

Konfiguration Regelsatz

<key id="slub_link_group">
    <label>link (group)</label>
    <label lang="de">Link (Gruppe)</label>
    <key id="slub_linkGroup">
        <label>link</label>
        <label lang="de">Link</label>
    </key>
    <key id="slub_linktextGroup">
        <label>linktext</label>
        <label lang="de">Linktext</label>
    </key>
</key>

Vorschlag Anzeige Import-Dialog

Erläuterung

• In beiden Fällen wird aus dem Unterelement Linktext der Wert zur Kennzeichnung der Metadatengruppe angewendet.
• In Link (Gruppe) [1] wurde nur der Wert des Unterelements Linktext geändert und wird entsprechend angezeigt. Der Wert des Unterelements Link wurde nicht geändert und wird nicht angezeigt.
• In Link (Gruppe) [2] wurde nur der Wert des Unterelements Link geändert und wird entsprechend angezeigt. Der Wert des Unterelements Linktext wurde nicht geändert und wird nicht angezeigt.