[Kitodo] REST-API

Stefan Freitag freitag at uni-leipzig.de
Do Okt 10 14:13:24 CEST 2019


Lieber Herr Meyer,

das ist ein guter Vorschlag. Ich werde das prüfen. Unseren Importer (ein 
ziemlicher Spezialfall) kann man bereits hier beziehen: 
https://github.com/ubleipzig/ManuMedImporter

Viele Grüße
Stefan Freitag

Am 10.10.2019 um 13:54 schrieb Meyer, Sebastian:
>
> Liebe Kolleginnen und Kollegen,
>
> ich möchte in diesem Zusammenhang kurz darauf aufmerksam machen, dass 
> es auf GitHub ein „Contrib“-Repository gibt: 
> https://github.com/kitodo/kitodo-contrib
>
> Dieses Repository ist explizit dazu gedacht, Skripte, hilfreiche 
> Tools, Beispielkonfigurationen, etc. aus den verschiedenen 
> Kitodo-Einrichtungen zu sammeln, damit diese von anderen Anwendern 
> ggf. nachgenutzt oder zumindest zur Inspiration herangezogen werden 
> können.
>
> Wenn Sie, lieber Herr Freitag, also Ihre Skripte zur Verfügung stellen 
> möchten, würde ich vorschlagen, dass Sie sie als Pull-Request in das 
> genannte GitHub-Repository einspielen.
>
> Viele Grüße
>
> Sebastian Meyer
>
> --
> Sebastian Meyer
> Stabsstelle Digitale Bibliothek
>
> Sächsische Landesbibliothek –
> Staats- und Universitätsbibliothek Dresden (SLUB)
> Abteilung IT, Referat 2.1 Digitale Bibliothek
> 01054 Dresden
> Besucheradresse: Zellescher Weg 18, 01069 Dresden
> Telefon: +49 351 4677-206
> Mobilfunk: +49 173 9615528
>
> *From:*kitodo-community-bounces at kitodo.org 
> <kitodo-community-bounces at kitodo.org> *On Behalf Of *Christian Haenger
> *Sent:* Thursday, October 10, 2019 11:26 AM
> *To:* kitodo-community at kitodo.org
> *Subject:* Re: [Kitodo] REST-API
>
> 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
>         <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:* Mittwoch, 9. Oktober 2019 15:50
>         *An:* kitodo-community at kitodo.org
>         <mailto: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  <mailto: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  <mailto:freitag at uni-leipzig.de>
>
>
>
>     _______________________________________________
>
>     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

-------------- nächster Teil --------------
Ein Dateianhang mit HTML-Daten wurde abgetrennt...
URL: <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/390278ff/attachment-0001.html>
-------------- 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/390278ff/attachment-0005.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/390278ff/attachment-0006.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/390278ff/attachment-0007.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/390278ff/attachment-0008.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/390278ff/attachment-0009.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