agorum core docform split – Troubleshooting

In dieser Dokumentation finden Sie Probleme, Lösungen und Tipps im Umgang mit agorum core docform split.

Probleme und Lösungen zu weiteren docform-Modulen und zu docform allgemein finden Sie in folgenden Dokumentationen:

Dokumente werden in der Oberfläche nicht mehr angezeigt

Wenn in der Trenn-Oberfläche keine Dateien mehr angezeigt werden, ist der work-Ordner beschädigt.

work-Ordner

Die Ursache ist dabei in 90 % der Fälle ein Fehler aufseiten der Benutzer. Innerhalb dieses automatisch angelegten Ordners darf nichts manuell verändert werden. Sobald Sie manuell Dokumente hinzufügen oder löschen, hört der Ordner auf zu funktionieren.

Lösung

Setzen Sie die Struktur zurück.

Sichern Sie die Dateien des Ordners work lokal.
Löschen Sie den Ordner.
Lassen Sie die Dokumente erneut durch docform laufen.

Ergebnis: Der work-Ordner funktioniert wieder.

Unbekannter Fehler / Seite konnte nicht aktualisiert werden

Der Benutzer versucht Dokumenten in Docform-Trennen zusammenzuführen. Es erscheint die Fehlermeldung Seite konnte nicht aktualisiert werden. In docform speichern ohne Training erscheint die Meldung Es ist ein unbekannter Fehler aufgetreten.

Lösung

Überprüfen Sie die Rechte des Benutzers.

In dem vorangegangenen Supportfall hatte der betroffene Benutzer nur lesende Rechte. Im Log erscheint No Access.

Dokument kann nicht erstellt werden

Dieser Fehler kann viele Ursachen haben. Häufig handelt es sich um eine fehlende Berechtigung (agorum core docform Berechtigungen). Es kann ebenfalls vorkommen, dass eine Relation des Objektes beschädigt ist. Darauf weist die API Fehlermeldung agorum.api.common.exceptions.server.ApiInternalServerErrorException: Could not create document starting with page <ID> hin.

Die folgenden Zeilen sagen, dass der Startseite die Eltern-Beziehung fehlt:

Caused by: java.lang.NullPointerException
at agorum.docform.worker.split.Splitter.apply(Splitter.java:453)
at agorum.docform.api.impl.DocFormImpl.splitApply(DocFormImpl.java:767)

Dokument landet im invalid-Ordner

Landet ein Dokument im docform-Ordner invalid, kann dies an der pushback size liegen. Sie stellt sicher, dass ein begrenzter Speicher (65536 Bytes) zum Laden eines PDFs zur Verfügung gestellt wird.

Wird dieser Speicher überschritten, gibt das System folgende Fehlermeldung im agorum core support tool aus:

date: 2023-10-20 13:14:00
severity: ERROR
logged at: agorum.docform.worker.split.Splitter.error(Splitter.java:1049)
id: 6533541

object-id: 7090073
object-id: 6533541
Push back buffer is full
....

Weitere Gründe, weshalb ein Dokument im invalid-Ordner landen kann:

PDF leer oder abgeschnitten.
PDF aus anderen Gründen nicht mit PDFBox kompatibel.
kein PDF und nicht nach PDF konvertierbar

Lösung

Setzen Sie das Property-Entry org.apache.pdfbox.baseParser.pushBackSize auf einen höheren Wert als 65536.
Fügen Sie den Parameter in das Startskript roi_jboss hinzufügen, etwa unter Linux:
```
JAVA_OPTS="${JAVA_OPTS} -Dorg.apache.pdfbox.baseParser.pushBackSize=1048576"
```