Massenimport
Kitodo.Production 3 bietet einen Massenimport für Metadaten an. Dieser erlaubt es, Importkonfigurationen vom Typ "Katalogsuche" automatisch mit einer Liste von IDs aufzurufen. Für jede ID wird die Katalogschnittstelle einmal abgefragt und bei erfolgreicher Abfrage ein Digitalisierungsvorgang in Kitodo angelegt.
Die Eingabemaske für den Massenimport erreicht man über das entsprechende Symbol 
in der "Aktionen"-Spalte der Projektliste:
Die Eingabemaske des Massenimports enthält die folgenden Elemente:
- Katalog-Auswahl
- Tabelle für Datensatz-IDs und zusätzliche Metadaten
- Bedienelemente zum Upload von CSV-Dateien
- CSV-Spaltentrennzeichen
- Knöpfe zum Auslösen oder Abbrechen des Massenimports
Die Katalogauswahl enthält alle Importkonfigurationen vom Typ "Katalogsuche", auf die der aktuelle Benutzer über die ihm zugewiesenen Mandanten Zugriff hat. Alle in der Liste der Datensatz-IDs enthaltenen Identifier werden beim Auslösen des Massenimports an die ausgewählte Katalogsuche geschickt und die zurückerhaltenen Metadaten anhand der zur Importkonfiguration gehörenden Abbildungsdateien in einen Kitodo-Vorgang umgewandelt.
Jede Zeile in der Tabelle entspricht einem vom Katalog zu importierenden Datensatz. In jeder Zeile muss mindestens eine Zelle mit der ID des Datensatzes enthalten sein.
Zusätzliche Zeilen können über das "+"-Symbol unter der Tabelle hinzugefügt werden:
Optional können weitere Spalten ausgefüllt werden, um die importierten Datensätze um zusätzliche Metadaten anzureichern (wenn Spalten für zusätzliche Metadaten existieren, müssen die IDs der Datensätze immer in der ersten Spalte der Tabelle stehen).
Um weitere Spalten für zusätzliche Metadaten hinzuzufügen, muss auf das "+"-Symbol in der Titelleiste der Tabelle geklickt werden:
Dies öffnet einen Dialog, in dem alle Metadaten aus dem aktuell verwendeten Regelsatz zur Auswahl stehen, die allen im Regelsatz definierten Dokumenttypen hinzugefügt werden können (diese Einschränkung auf Metadaten besteht, da der Dokumenttyp eines Datensatzes vor dessen Import noch unbekannt ist und damit nur solche Metadatenspalten garantiert gültig sind, die mit allen Dokumenttypen kompatibel sind):
Die Werte sowohl der IDs als auch der Metadaten in den einzelnen Zellen der Tabelle können per Mausklick direkt "in place", d.h. ohne zusätzlichen Bearbeitungsdialog bearbeitet bzw. angepasst werden:
Sowohl einzelne Datensätze in den Tabellenzeilen als auch Metadaten für alle Datensätze in den Tabellenspalten können über die jeweiligen Mülleimer-Symbole in der letzten Spalte sowie in der Tabellenkopfleiste vor dem Auslösen des Massenimports entfernt werden.
Die Identifier für den Massenimport können entweder manuell eingetragen oder über eine entsprechend vorbereitete CSV-Datei übertragen werden. Eine solche Datei kann zunächst über den Knopf "Auswählen" im lokalen Dateisystem ausgewählt und dann über den "Hochladen"-Knopf an Kitodo übertragen werden. (Hinweis: die Knöpfe für den CSV-Datei-Upload erscheinen erst nach der Auswahl eines Katalogs in der Katalogauswahl.)
Um für den Massenimport in Kitodo verwendbar zu sein, müssen Spalten, die zusätzliche, optionale Metadaten enthalten, mit den die importierten Datensätze angereichert werden sollen, in der ersten Zeile die Namen der jeweiligen Metadaten enthalten. Diese entsprechen den "keys" im aktuell verwendeten Regelsatz.
Die für dieses Beispiel verwendete CSV-Datei sieht wie folgt aus:
ID, title, place
123, Band 1, Hamburg
456, Band 2, Dresden
789, Band 3, Berlin
Da die erste Spalte immer die IDs der zu importierenden Datensätze enthalten muss, ist der Eintrag in der ersten Spalte der ersten Zeile beliebig. Die hier eingetragenen Werte werden immer an das Suchfeld übergeben, das in der verwendenten Importkonfiguration als ID-Suchfeld konfiguriert wurde.
Über dieses Menü kann das Trennzeichen ausgwählt werden, welches die einzelnen Spalten in der hochgeladenen CSV-Datei voneinander trennt. (Datensätze in einer CSV-Datei werden über einen Zeilenumbruch voneinander getrennt). Dabei stehen die beiden CSV-Standard-Trennzeichen , und ; zur Auswahl:
Das CSV-Trennzeichen kann auch nach dem Upload der CSV-Datei umgeschaltet werden, um eine korrekte Verarbeitung der Datei je nach verwendetem Trennzeichen zu ermöglichen. Dadurch kann der Nutzer schnell erkennen, wenn ein zu der aktuellen CSV-Datei nicht passendes Trennzeichen gewählt wurde, da dann alle Spalten eines CSV-Eintrags inkorrekt und nicht voneinander getrennt in der ersten Spalte der Tabelle landen:
Wird das Trennzeichen auf die korrekte Option umgeschaltet, aktualisiert sich die Tabellenansicht und enthält anschließend die einzelnen Identifier und zusätzlichen Metadaten aus der CSV-Datei korrekt voneinenader getrennt in einzelnen Spalten der Tabelle:
Über den Knopf "Massenimport" wird der Massenimport für die ausgewählte Katalogsuche und aktuelle Datensatztabelle ausgelöst. Der Knopf "Abbrechen" führt zurück zur Projektliste.
Nachdem der Massenimport ausgelöst wurde, zeigt ein Fortschrittsbalken den Fortschritt des Massenimports an. Anschließend wird ein Dialog mit dem Ergebnis des Massenimports angezeigt, der den Nutzer darüber informiert, welche Datensätze erfolgreich importiert wurden und bei welchen Datenssätzen es ein Problem gab, das dessen Import verhinderte:
