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 kann weder nicht erstellt noch gelöscht werden

Ein Dokument kann in docform nicht verarbeitet (weder gelöscht noch erstellt) werden. Im Supporttool wird diese Fehlermeldung angezeigt:

Could not update page 550904199

date: 2025-01-28 10:18:42
severity: ERROR
logged at: agorum.docform.api.impl.DocFormImpl.splitUpdate(DocFormImpl.java:702)

java.lang.NullPointerException
  at agorum.docform.worker.split.Splitter.update(Splitter.java:418)
  at agorum.docform.api.impl.DocFormImpl.splitUpdate(DocFormImpl.java:699)
  at sun.reflect.GeneratedMethodAccessor1117.invoke(Unknown Source)
  at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
  at java.lang.reflect.Method.invoke(Method.java:498)
  at org.apache.cxf.service.invoker.AbstractInvoker.performInvocation(AbstractInvoker.java:180)
  at org.apache.cxf.service.invoker.AbstractInvoker.invoke(AbstractInvoker.java:96)
  at org.apache.cxf.jaxrs.JAXRSInvoker.invoke(JAXRSInvoker.java:205)
  at agorum.api.common.invokers.ApiJAXRSInvoker.invoke(ApiJAXRSInvoker.java:38)
  at org.apache.cxf.interceptor.ServiceInvokerInterceptor$1.run(ServiceInvokerInterceptor.java:58)
  ...

Lösung

Diese Fehlermeldung sagt aus, dass der entsprechende docform-Trennen Ordner kaputt ist. Dies geschieht durch manuelles verschieben / einfügen in einen der Unterordner: work, queue.
Anweisung 1: Verschieben Sie niemals Dokumente über den Explorer diekt in oder aus dem work-Ordner. Dies führt zu einem Fehler der docform-Trennen Konfiguration.
Anweisung 2: Um den Ordner zu reparieren, benennen Sie den work-Ordner der docform-Konfiguration um, in z.B. work-zu löschen. Sobald Sie ein neues Dokument in den docform-trennen Ordner gelegt haben, wird der nun fehlende work-Ordner automatisch neu angelegt und Ihre Konfiguration ist wieder funktional.

Tipp: Sie können nun die noch vorliegenden Dokumentseiten des kaputten work-Ordners in den übergeordneten docform-Trennen Ordner schieben, um die bereits vorhandenen Dokumente weiterzuverarbeiten.
Löschen Sie anschließend den umbenannten, kaputten work-Ordner.

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 die Java-property org.apache.pdfbox.baseParser.pushBackSize in dem Startskript roi_jboss auf einen höheren Wert als 65536, etwa unter Linux:
```
JAVA_OPTS="${JAVA_OPTS} -Dorg.apache.pdfbox.baseParser.pushBackSize=1048576"
```