[Kitodo] REST-API
Christian Haenger
christian.haenger at bib.uni-mannheim.de
Do Okt 10 11:26:25 CEST 2019
Hallo Herr Freitag,
das scheint mir sehr zielführend zu sein. Liegen die Skripte irgendwo
zur Nachnutzung auf Git?
Viele Grüße
Christian Hänger
Am 10.10.2019 um 10:02 schrieb Stefan Freitag:
>
> Hallo Herr Hänger,
>
> hier ein eher etwas unkonventioneller Ansatz für eine Lösung. Wir
> hatten das Problem HIDA-Dateien (aus Manuscripta Mediaevalia) in
> Kitodo Production zu importieren. Bekanntlicherweise existiert hierfür
> keine Schnittstelle. Wir haben das Problem derart gelöst: Wir
> manipulieren direkt die meta.xml-Datei, die von Kitodo für jeden
> Vorgang angelegt wird und editieren die Daten dort. Dies passiert
> zwischen zwei Schritten im Workflow über einen externen Script-Aufruf,
> der wiederum den Importer anstößt. Wir haben diese Lösung nun bereits
> seit 2 Jahren im Einsatz. Die Uni Halle will diese Lösung im Übrigen
> nun von uns nachnutzen.
>
> Viele Grüße
> Stefan Freitag
>
> Am 10.10.2019 um 08:17 schrieb Weber, Frank-Ulrich:
>>
>> Hallo Herr Hänger,
>>
>>
>>
>> es geht Ihnen im Grundsatz also darum, die Meta- und Strukturdaten
>> eines bereits erstellten Vorgangs
>>
>> im Nachhinein automatisch (durch Import) zu aktualisieren und zu
>> ergänzen?
>>
>>
>>
>> Diese Erweiterung wurde für Kitodo.Production 2.x schon mehrmals
>> diskutiert
>>
>> und müsste jetzt in Kitodo.Production 3.x umgesetzt werden.
>>
>> Da wir bereits in anderen Projekten (Kitodo.Production 2.x /
>> Kitodo.Presentation) und jetzt im Rahmen des DFG-Projekts zu
>> Kitodo.Production 3.x
>>
>> aktiv an der Entwicklung von Kitodo teilnehmen, sind wir natürlich
>> auch gerne bereit weitere Entwicklungen (z.B. API) durchzuführen.
>>
>>
>>
>> Unabhängig davon werde ich Ihren Wunsch, sofern korrekt von mir
>> interpretiert, in die Projektinterne Liste möglicher
>> Weiterentwicklungen aufnehmen.
>>
>>
>>
>> Beste Grüße
>>
>>
>>
>> Frank Ulrich Weber
>>
>>
>>
>> ------------------------------------------------------------------------
>>
>> Frank-Ulrich Weber
>> Product Manager Software Solutions
>>
>> <http://www.zeutschel.de>
>>
>> <https://twitter.com/zeutschelgmbh>
>>
>>
>>
>> <http://www.youtube.com/user/zeutschelbookscanner>
>>
>>
>>
>> <https://www.facebook.com/pages/Zeutschel-GmbH/193873073980288?fref=ts>
>>
>> *Zeutschel GmbH* | Heerweg 2 | 72070 Tübingen | Deutschland
>> p: +49 (7071) 9706-56 | m: | f: +49 (7071) 9706-44
>> e: Frank-Ulrich.Weber at zeutschel.de
>> <mailto:Frank-Ulrich.Weber at zeutschel.de> | w: http://www.zeutschel.de
>> Geschäftsführer/President: Joerg Vogler | Registergericht Stuttgart:
>> HRB 380917
>>
>> <https://www.zeutschel.de/>
>>
>> *Von:*kitodo-community-bounces at kitodo.org
>> <kitodo-community-bounces at kitodo.org> *Im Auftrag von *Christian Haenger
>> *Gesendet:* Mittwoch, 9. Oktober 2019 15:50
>> *An:* kitodo-community at kitodo.org
>> *Betreff:* Re: [Kitodo] REST-API
>>
>>
>>
>> Hallo Herr Ronge,
>>
>>
>>
>> haben Sie erst einmal vielen Dank für die genaue Auflistung.
>>
>>
>>
>> Ich habe die vier APIs für die Mannheimer Installation abgefragt und
>> habe die folgenden Ergebnisse erzeilt:
>>
>>
>>
>> http://server.domain.example/kitodo-production*/rest/catalogueConfiguration*
>>
>> » Gibt die konfigurierten Katalogschnittstellen und Dokumenttypen
>> aus. Diese Informationen sind analog zu den in opac.xml
>> konfigurierten Informationen.
>>
>> Das ist nicht relevant für die Fragestellung, Metadaten aus dem
>> System zu exportieren (oder gar zu importieren)
>>
>>
>>
>> http://server.domain.example/kitodo-production*/rest/projects*
>>
>> » Gibt die konfigurierten Projekte mit entsprechenden
>> Produktionsvorlagen mit verfügbaren Sammlungen, und
>> Metadatenschlüsseln aus. Die Projekte und Produktionsvorlagen
>> sind diejenigen, die auf dem System vorhanden sind. Die
>> Sammlungen entsprechen der Konfiguration in der
>> collections.xml-Datei, die Metadatenschlüssel entsprechen der
>> Konfiguration in der projects.xml-Datei (wie für das betreffende
>> Projekt konfiguriert).
>>
>> Das ist nicht relevant für die Fragestellung, Metadaten aus dem
>> System zu exportieren (oder gar zu importieren)
>>
>>
>>
>> http://server.domain.example/kitodo-production*/rest/processes*
>>
>> » Listet alle Vorgänge auf dem System auf. Die Vorgänge sind
>> diejenigen, die auf dem System vorhanden sind.
>>
>> Das beantwortet meine Frage am ehesten. Es werden aber keine
>> METS-Daten ausgegeben.
>> Beispiel:
>>
>> <goobiProcess>
>>
>> <identifier>52015858X</identifier>
>>
>> <title>
>>
>> Arnoldi Clapmari[i] Juris-Consulti, Nobile Triennium
>>
>> </title>
>>
>> </goobiProcess>
>>
>> <goobiProcess>
>>
>> <identifier>52015875X</identifier>
>>
>> <title>Salomonis Codomanni ... Vindiciae</title>
>>
>> </goobiProcess>
>>
>>
>>
>> http://server.domain.example/kitodo-production*/rest/processes/*/PPN/*/steps*
>>
>> Das ist nicht relevant für die Fragestellung, Metadaten aus dem
>> System zu exportieren (oder gar zu importieren)
>>
>> » Zeigt alle Schritte des Vorgangs mit der angegebenen PPN an.
>> Beachten Sie, dass die PPN der Wert im Feld PPN digital a-Satz
>> bzw. PPN digital f-Satz sein muss, nicht der Vorgangstitel.
>>
>>
>>
>> Würde Zeutschel denn den Kitodo-APIs weiternetwickeln? Gedacht ist
>> daran, über die API zu einem bestehenden Projekt und mit bestehenden
>> Titeldaten aus dem Verbund ergänzend METS-Dateien (z.B.
>> https://digi.bib.uni-mannheim.de/fileadmin/digi/490029922/490029922.xml)
>> nach Kitodo Production zu importieren? Das ist aus meiner Sicht ein
>> echter Mehrwert für Kitodo.
>>
>>
>>
>> Viele Grüße
>>
>>
>>
>> Christian Hänger
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>> ------------------------------------------------------------------------
>>
>> Matthias Ronge
>> Software Entwicklung/Software Development
>>
>> <http://www.zeutschel.de>
>>
>>
>>
>> <https://twitter.com/zeutschelgmbh>
>>
>>
>>
>> <http://www.youtube.com/user/zeutschelbookscanner>
>>
>>
>>
>> <https://www.facebook.com/pages/Zeutschel-GmbH/193873073980288?fref=ts>
>>
>>
>>
>> *Zeutschel GmbH*| Heerweg 2 | 72070 Tübingen | Deutschland
>> p: +49 (7071) 9706-62 | m: | f: +49 (7071) 9706-44
>> e: Matthias.Ronge at zeutschel.de
>> <mailto:Matthias.Ronge at zeutschel.de> | w: http://www.zeutschel.de
>>
>>
>>
>>
>>
>>
>> Geschäftsführer/President: Joerg Vogler | Registergericht
>> Stuttgart: HRB 380917
>>
>>
>>
>> <https://www.zeutschel.de/>
>>
>> -----Ursprüngliche Nachricht-----
>> Von: kitodo-community-bounces at kitodo.org
>> <mailto:kitodo-community-bounces at kitodo.org>
>> <kitodo-community-bounces at kitodo.org>
>> <mailto:kitodo-community-bounces at kitodo.org> Im Auftrag von
>> Christian Haenger
>> Gesendet: Freitag, 20. September 2019 14:01
>> An: kitodo-community at kitodo.org <mailto:kitodo-community at kitodo.org>
>> Betreff: Re: [Kitodo] REST-API
>>
>>
>>
>> Hallo Herr Hartwig,
>>
>>
>>
>> ich habe mir fast gedacht, dass die REST-API nur Lesezugriffe
>> erlaubt.
>>
>> Wir haben ja eine ähnliche Kitodo-Geschichte wie die ULB Halle
>> und sind
>>
>> 2015 von Visual Library auf Kitodo (damals noch Goobi) umgestiegen.
>>
>> Allerdings haben wir wegen der damals auch noch nicht vorhandenen
>> Exportmöglichkeiten die Alt-VL-Metadaten nicht nach Production
>> importiert, sondern greifen nur mit Presentation darauf zu. Bei
>> einer erneuten Bearbeitung des "Altdatensatzen" muss dann eine
>> erneute Aufnahme in Production erfolgen.
>>
>>
>>
>> Letztlich ist es suboptimal, nicht mit einem System, also
>> Production, zu arbeiten, sondern Workarounds zu schaffen. Aber
>> manchmal geht es nicht anders.
>>
>>
>>
>> Viele Grüße
>>
>>
>>
>> Christian Hänger
>>
>>
>>
>>
>>
>>
>>
>> Am 20.09.2019 um 13:39 schrieb Uwe Hartwig:
>>
>> > Hallo Herr Hänger,
>>
>> >
>>
>> > das klingt spannend. Bei uns geht es darum, unsere
>> Strukturierung bei
>>
>> > der Arbeit so weit es geht zu unterstützen, was ggf. heißt,
>>
>> > Arbeitsschritte nicht über die Kitodo.Production2 Oberfläche
>>
>> > durchzuführen, sondern auf anderen Wegen.
>>
>> >
>>
>> > Aktuell erlaubt die REST-API allerdings durchgehend nur
>> Lesezugriffe,
>>
>> > wobei mir leider das dahinterliegende Modell noch nicht klar ist
>>
>> > (process vs. prozesse vs. prozesseeigenschaften vs. vorlagen vs.
>>
>> > vorlageneigenschaften vs. werkstuecke vs.
>> werkstueckeeigenschaften).
>>
>> >
>>
>> >
>>
>> > Grüße
>>
>> >
>>
>> >
>>
>> > On 20.09.19 13:16, Christian Haenger wrote:
>>
>> >> Hallo Herr Hartwig,
>>
>> >>
>>
>> >> eine vergleichbare Frage wollte ich auch gerade stellen.
>>
>> >>
>>
>> >> Mein Problem ist, dass die Scanabteilung mehr digitalisierte
>> Werke
>>
>> >> liefert als die Metadatenabteilung beschreiben kann. Daher
>> denke ich
>>
>> >> bei Werken aus dem 19. und 20. Jahrhundert über eine
>> Automatisierung nach.
>>
>> >> Wir digitalisieren in Mannheim Fortsetzungswerke, deren Aufbau
>> über
>>
>> >> mehrere Ausgaben hinweg immer gleich bleibt. Das sind z.B.
>>
>> >> Hoppenstedt Handbuch der Aktiengesellschaften. Daher denke ich
>>
>> >> darüber nach, die Inhaltsverzeichnisse zu scannen und die Inhalte
>>
>> >> automatisiert nach XML-DC oder XML-MODS zu überführen. Denkbar
>> wäre
>>
>> >> dann ein Import über die REST-API nach Production. Anschließend
>>
>> >> erfolgt dann die manuelle weitere Bearbeitung in Kitodo.
>>
>> >>
>>
>> >> Hat das jemand mal gemacht oder einen anderen Lösungsvorschlag?
>>
>> >>
>>
>> >> In Mannheim haben wir bereits Metadaten und Imgaes automatisiert
>>
>> >> übernommen, aber nur für Presentation zur Verfügung gestellt.
>> Zuletzt:
>>
>> >>
>>
>> >> Viele Grüße
>>
>> >>
>>
>> >> Christian Hänger
>>
>> >>
>>
>> >>
>>
>> >> Am 20.09.2019 um 11:20 schrieb Uwe Hartwig:
>>
>> >>> Liebe Community,
>>
>> >>>
>>
>> >>> für Kitodo.Production existiert eine REST-API, die in
>> unveränderter
>>
>> >>> Form auch in Version3 übernommen wurde.
>>
>> >>> Nutzt jemand aktuell diese Schnittstelle?
>>
>> >>> Wird diese gepflegt bzw. gibt es Ideen für deren
>> Weiterentwicklung?
>>
>> >>>
>>
>> >>>
>>
>> >>> Viele Grüße
>>
>> >>>
>>
>>
>>
>> --
>>
>> Dr. Christian Hänger
>>
>> Abteilungsleiter Digitale Bibliotheksdienste UB Mannheim
>>
>> 68131 Mannheim
>>
>> 0049 621 181 2954
>>
>>
>>
>>
>>
>>
>>
>> _______________________________________________
>>
>> Kitodo-Community mailing list
>>
>> Kitodo-Community at kitodo.org <mailto:Kitodo-Community at kitodo.org>
>>
>> https://maillist.slub-dresden.de/cgi-bin/mailman/listinfo/kitodo-community
>>
>>
>>
>> _______________________________________________
>>
>> Kitodo-Community mailing list
>>
>> Kitodo-Community at kitodo.org <mailto:Kitodo-Community at kitodo.org>
>>
>> https://maillist.slub-dresden.de/cgi-bin/mailman/listinfo/kitodo-community
>>
>>
>>
>> --
>> Dr. Christian Hänger
>> Abteilungsleiter Digitale Bibliotheksdienste
>> UB Mannheim
>> 68131 Mannheim
>> 0049 621 181 2954
>>
>> _______________________________________________
>> Kitodo-Community mailing list
>> Kitodo-Community at kitodo.org
>> https://maillist.slub-dresden.de/cgi-bin/mailman/listinfo/kitodo-community
> --
> Dipl.-Inf. Stefan Freitag
>
> Leiter AG Anwendungsentwicklung
> Bereich Digitale Dienste
>
> Universitätsbibliothek Leipzig
> Bibliotheca Albertina
> Beethovenstr. 6
> 04107 Leipzig
>
> fon: +49 (0) 341 97 30841
> mail: freitag at uni-leipzig.de
>
> _______________________________________________
> Kitodo-Community mailing list
> Kitodo-Community at kitodo.org
> https://maillist.slub-dresden.de/cgi-bin/mailman/listinfo/kitodo-community
--
Dr. Christian Hänger
Abteilungsleiter Digitale Bibliotheksdienste
UB Mannheim
68131 Mannheim
0049 621 181 2954
-------------- nächster Teil --------------
Ein Dateianhang mit HTML-Daten wurde abgetrennt...
URL: <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/4c328346/attachment-0001.html>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname : Z_Logo_RGB_180px_2b974e26-85b9-4005-92dd-9bb8df881ab3.png
Dateityp : image/png
Dateigröße : 4047 bytes
Beschreibung: nicht verfügbar
URL : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/4c328346/attachment-0010.png>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname : Twitter-34x34_f9819937-1c34-4eab-b2fc-944fcf2e8938.png
Dateityp : image/png
Dateigröße : 4594 bytes
Beschreibung: nicht verfügbar
URL : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/4c328346/attachment-0011.png>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname : YouTube-34x34_8cf03759-cc15-472e-a763-e628ea59d43b.png
Dateityp : image/png
Dateigröße : 4355 bytes
Beschreibung: nicht verfügbar
URL : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/4c328346/attachment-0012.png>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname : Facebook-34x34_ab94d89a-875f-49f2-81f3-e136c66e4bb5.png
Dateityp : image/png
Dateigröße : 4533 bytes
Beschreibung: nicht verfügbar
URL : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/4c328346/attachment-0013.png>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname : Banner-OS-Q_63e91370-8268-4a12-aec9-f048b5a97237.png
Dateityp : image/png
Dateigröße : 38938 bytes
Beschreibung: nicht verfügbar
URL : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/4c328346/attachment-0014.png>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname : image001.png
Dateityp : image/png
Dateigröße : 4047 bytes
Beschreibung: nicht verfügbar
URL : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/4c328346/attachment-0015.png>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname : image002.png
Dateityp : image/png
Dateigröße : 4594 bytes
Beschreibung: nicht verfügbar
URL : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/4c328346/attachment-0016.png>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname : image003.png
Dateityp : image/png
Dateigröße : 4355 bytes
Beschreibung: nicht verfügbar
URL : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/4c328346/attachment-0017.png>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname : image004.png
Dateityp : image/png
Dateigröße : 4533 bytes
Beschreibung: nicht verfügbar
URL : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/4c328346/attachment-0018.png>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname : image005.png
Dateityp : image/png
Dateigröße : 38938 bytes
Beschreibung: nicht verfügbar
URL : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/4c328346/attachment-0019.png>
-------------- nächster Teil --------------
_______________________________________________
Kitodo-Community mailing list
Kitodo-Community at kitodo.org
https://maillist.slub-dresden.de/cgi-bin/mailman/listinfo/kitodo-community
Mehr Informationen über die Mailingliste Kitodo