[Kitodo] REST-API

Do Okt 10 13:54:31 CEST 2019

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

[cid:image001.png at 01D57F72.3CDFD900]<http://www.zeutschel.de>

[cid:image002.png at 01D57F72.3CDFD900]<https://twitter.com/zeutschelgmbh>

[cid:image003.png at 01D57F72.3CDFD900]<http://www.youtube.com/user/zeutschelbookscanner>

[cid:image004.png at 01D57F72.3CDFD900]<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

[cid:image005.png at 01D57F72.3CDFD900]<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

[cid:image001.png at 01D57F72.3CDFD900]<http://www.zeutschel.de>

[cid:image002.png at 01D57F72.3CDFD900]<https://twitter.com/zeutschelgmbh>

[cid:image003.png at 01D57F72.3CDFD900]<http://www.youtube.com/user/zeutschelbookscanner>

[cid:image004.png at 01D57F72.3CDFD900]<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

[cid:image005.png at 01D57F72.3CDFD900]<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
-------------- nächster Teil --------------
Ein Dateianhang mit HTML-Daten wurde abgetrennt...
URL: <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/69e5ad58/attachment-0001.html>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname   : image001.png
Dateityp    : image/png
Dateigröße  : 4047 bytes
Beschreibung: image001.png
URL         : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/69e5ad58/attachment-0005.png>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname   : image002.png
Dateityp    : image/png
Dateigröße  : 4594 bytes
Beschreibung: image002.png
URL         : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/69e5ad58/attachment-0006.png>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname   : image003.png
Dateityp    : image/png
Dateigröße  : 4355 bytes
Beschreibung: image003.png
URL         : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/69e5ad58/attachment-0007.png>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname   : image004.png
Dateityp    : image/png
Dateigröße  : 4533 bytes
Beschreibung: image004.png
URL         : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/69e5ad58/attachment-0008.png>
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname   : image005.png
Dateityp    : image/png
Dateigröße  : 38938 bytes
Beschreibung: image005.png
URL         : <http://bibservices.biblio.etc.tu-bs.de/pipermail/kitodo/attachments/20191010/69e5ad58/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