TOOLKIT

Funktionstest Java-Einstellungen und Toolkit

Ab Advoware 6.1.4 und .NET-Tools 4.0.4.0 kann über den Dialog “bea-Konten verwalten“ ein Funktionstest durchgeführt werden (grünes Häkchen). Dieser Test sollte immer als erstes gemacht werden, wenn es Probleme beim Login gibt. Dies sind die möglichen Resultate des Tests:

ToolkitWrapper Funktionstest erfolgreich!

Die Java Einstellungen sind korrekt. Weiterhin auftretende Fehler haben eine andere Ursache.

Die Java VM konnte nicht genug Arbeitsspeicher reservieren!

Der initiale (xms) und maximale (xmx) Java Heap Speicher kann über folgende Windows Registry Einträge gesteuert werden:

Computer\HKEY_CURRENT_USER\SOFTWARE\Advo-ware\beA_toolkitwrapper_xms

Computer\HKEY_CURRENT_USER\SOFTWARE\Advo-ware\beA_toolkitwrapper_xmx

Standardwerte sind:

32 Bit Java:
beA_toolkitwrapper_xms = 128M
beA_toolkitwrapper_xmx= 512M

64 Bit Java:
beA_toolkitwrapper_xms = 256M
beA_toolkitwrapper_xmx= 1G

Das Toolkit ist beschädigt und kann nicht gestartet werden!

Die Datei ToolkitWrapper.jar oder Dateien aus dem Unterordner ToolkitWrapper_lib sind beschädigt oder nicht vorhanden. Dies tritt häufig auf weil Antivirus Programme die Dateien löschen / blockieren / in Quarantäne verschieben oder beim Update etwas schief gegangen ist. Es muss der Originalzustand der Dateien entsprechend dem jeweiligen Update Stand wiederhergestellt werden. In seltenen Fällen sind auch Ausnahmen im Antivirus Programm erforderlich.

Die maximal zulässige Zeit von 120 Sekunden wurde beim Funktionstest überschritten!

• Ursache 1: Der Java Prozess braucht zu lange um zu starten. Dies liegt meistens an sehr langsamen Netzlaufwerken / VPN Verbindungen.

• Lösung zu 1: Den ToolkitWrapper (java Unterordner im Advoware Programverzeichnis) auf ein schnelleres (z.B. lokales) Laufwerk kopieren und die Java-Einstellungen anpassen.

• Ursache 2: Eine Firewall / Antivirus Software verhindert die Kommunikation zwischen Advoware.exe und dem Java Prozess auf einem lokalen TCP Port von 9997 bis 20000.

• Lösung zu 2: Firewall / Antivirus Software entsprechend konfigurieren.

Der Funktionstest ist aus einem unbekannten Grund fehlgeschlagen!

In diesem Fall bitte die Protokolldatei für den Support erstellen (F12) und an die Entwicklung schicken.

Amtsgericht Tempelhof-Kreuzberg

Details: Das Amtsgericht Tempelhof-Kreuzberg wurde zu Amtsgericht Kreuzberg umbenannt. Seit der Umbenennung wird die XJustiz-ID nicht mehr automatisch gefunden

• Lösung: Man muss in dem Feld <XJustiz-ID> “Kreuzberg” manuell eingeben und auf die Suche klicken, dann wird das Gericht gefunden. Die ID lautet “F1108”.

FEHLERMELDUNGEN

0109 - The given message isn't a draft message and therefore can't been saved or send!

• Diese Fehlermeldung kommt, wenn Entwürfe per Webanwendung in einen Unterordner des Ordners "Entwürfe" verschoben werden. Das kann Advoware nicht mehr korrekt handhaben. Arbeiten Sie am besten ohne Unterordner im Ordner "Entwürfe".

0123 - The message couldn´t be sent, because there are missing attachment signatures

• Lösung: Alle Anhänge vom Typ "Schriftsatz" vor dem Versand signieren und sicher stellen, dass die Signaturen in der Liste der Anhänge enthalten sind.

• Erklärung: Dieser Fehler tritt nur auf wenn als Mitarbeiter versendet wird und es Anhänge vom Typ Schriftsatz gibt, die nicht signiert sind. Anwälte können Schriftsätze auch unsigniert versenden.

0151 - request contains invalid non-Latin characters

Lösung:
Sonderzeichen (Komma) im Feld Aktenzeichen (im Versand-Fenster)
Sonderzeichen in der Aktengeschichte im Feld Dateiname oder Art des Vorgangs (Unterstriche sind okay, alles andere nicht)
Lange Bindestriche statt normale:
Falsch: Anhang: Bremshey–Versorgungsausgleich–2024.03.11.pdf

Richtig: Anhang: Bremshey-Versorgungsausgleich-2024.03.11.pdf

0601 - Fehler beim Aufrufen des beA Webservices saveMessage! Details: 0601 - Identity couldn't be found!"

Die Fehlermeldung deutet darauf hin, dass die in Advoware hinterlegte beA-Adresse des Empfänger sich verändert hat. Bitte überprüfen Sie die in der Advoware-Adresse hinterlegte beA-Adresse und aktualisieren Sie diese.

0703 - Fehler beim Aufruf des beA Webservice getFolderOverview: 0703 - Subject couldn’t be transcoded! Die Nachrichtenübersicht konnte nicht abgerufen werden.

• Erklärung: Tritt beim Nachrichtenabruf auf. Die Meldung erscheint, wenn eine beA Nachricht eine leere Betreffzeile oder in der Betreffzeile Sonderzeichen vorhanden sind.

• Lösung: Die Nachricht muss in diesem Falle über das Web abgerufen werden. Damit die Nachricht im Advoware erscheint, muss diese dort exportiert und dann in die Aktengeschichte gezogen werden. Danach verschieben Sie die Nachricht in einen nicht von Advoware abonnierten Ordner. Sie können hierfür z.B. in der Webanwendung einen Unterordner erstellen.

0902 - User hasn't the needed rights

• Erklärung: Die Rechte des angemeldeten beA Benutzers reichen für die gewünschte Aktion nicht aus.

• Lösung: Die Rechte müssen vom Postfachinhaber mit Hilfe der beA Webanwendung korrekt vergeben. Welche Rechte für welche Aktionen benötigt werden kann in dieser Tabelle nachgesehen werden. Die Dokumentation / Hilfe der be Webanwendung hilft hier weiter. Folgende Schritte sind Notwendig: Benutzer hinzufügen, Benutzer berechtigen, Sicherheitstoken des Benutzers freischalten

0904 - Beim Login ist ein Fehler aufgetreten. Nochmals versuchen? Details: 0904 - The given SAML Response was invalid!

• Erklärung: Die Karte wurde in der Webanwendung noch nicht registriert. Dort erscheint beim Anmeldeversuch mit der betroffenen Karte folgende Hinweis:

Open

• Lösung: Die Registrierung muss über beA abgeschlossen werden.

0908: The user doesn’t have the required rights! beim Versand von eEBs z. B. durch Mitarbeiterkarten

Open

• Antwort vom beA KSW-Support: Dies ist ein bekannter Fehler der Version 6 der KSW-Schnittstelle, welcher mit der kommenden Version behoben wird. Der Fehler tritt nur bei Version 6 auf, falls Sie einen früheren Fix implementieren wollen, können Sie die Version 7 oder 8 einsetzen, hier tritt dieser nicht auf.

1003 - Die Nachricht [1/1] konnte nicht versendet werden! Details: de.brak.bea.application.dto.soap.types8.BeaFault: 1003 - A message of MessageStructureType 'EEB_ABGABE' must have a signed 'Strukturdatensatz' or you have to be logged in as postbox-owner (owner of this message).

• Erklärung: Die Meldung sagt, dass das eEB nicht vom Anwalt signiert wurde und über eine Mitarbeiterkarte versandt. 

• Lösung: Das eEB muss entweder vom Anwalt signiert oder direkt über das Anwaltspostfach versandt werden.   

1009 - de.brak.bea.application.dto.soap.types8.BeaFault: 0109 - The given message isn't a draft message and therefore can't be saved or sent!

• Erklärung: Beim Versand von mindestens einer Nachricht sind folgende Fehler aufgetreten: Die Nachricht [1/1] konnte nicht versendet werden!

• Lösung: Prüfen der Windows-Berechtigungseinstellungen der Windows-User für die Ordner aus denen versendet werden soll.

9999 - Fehler beim Aufruf des beA Webservice getFolderOverview: 9999 - General error processing request

• Erklärung: In mindestens einem Ordner des beA Postfachs liegt eine Fehlerhafte Nachricht. Solche fehlerhaften Nachrichten erzeigen üblicherweise auch in der beA Webanwendung beim Öffnen eine Fehlermeldung.

• Lösung: Alle fehlerhaften Nachrichten müssen per Webanwendung identifiziert und endgültig gelöscht oder in einen nicht von Advoware abonnierten Ordner verschoben werden.

9999 - de.brak.bea.application.dto.soap.types6 BeaFault 9999 - General error processing request

• Erklärung: In mindestens einem Ordner des beA Postfachs liegt eine Fehlerhafte Nachricht. Solche fehlerhaften Nachrichten erzeigen üblicherweise auch in der beA Webanwendung beim Öffnen eine Fehlermeldung.

• Lösung: Alle fehlerhaften Nachrichten müssen per Webanwendung identifiziert und endgültig gelöscht oder in einen nicht von Advoware abonnierten Ordner verschoben werden.

9999 - General Error Processing Request 999 beim Speichern eines Entwurfs

• Eine mögliche Erklärung: Die Safe-Id des Empfängers wurde mit einem führenden oder angehängten Leerzeichen angegeben.

• Lösung: Leerzeichen entfernen

5.0.1.0 - Fehler beim Aufruf des beA Web Webservices getMassage - Fehler beim Belegen eines verwalteten Speicherpuffers

• die Fehlermeldung beim Speicherpuffer hat zwei Lösungsmöglichkeiten.

• Starten Sie den betroffenen Arbeitsplatz neu.

• Sollte das nicht funktionieren, müssten Sie sich lokal ins beA-Web einloggen. Dort wird im Posteingang eine Nachricht liegen, die für die Schnittstelle zu groß ist und daher den Abruf blockiert. Legen Sie, soweit dieser nicht bereits vorhanden ist, die beA Nachrichten in einen Unterordner vom Posteingang, der nicht von advoware aboniert. Wenn dann in advoware die Nachrichten abgerufen werden können, verschieben Sie ein paar Nachrichten zurück und wiederholen den Abruf. Dies wiederholen Sie, bis Sie die Fehlermeldung wieder erhalten. Dann befindet sich die fehlerhafte Nachricht in den zuletzt verschobenen Nachrichten. Diese müssen Sie wieder in den Unterordner verschieben und die Nachricht exportieren, um die Nachricht mit Anhängen manuell in der Akte zu speichern. Diese muss in dem Unterordner verweilen, damit dies die Schnittstelle nicht blockiert.

•  

Login fehlgeschlagen!

Details: Es ist ein Fehler innerhalb der Login-Methode des Toolkits aufgetreten - Fehler bei der Authentisierung

• Erklärung 1: Dieser Fehler kann auftreten, wenn das Laufwerk, auf dem das Toolkit liegt, sehr langsam ist z.B. wenn sich ein Arbeitsplatz per VPN in die Kanzlei verbindet.

• Lösung 1: Den java Ordner aus der Advoware Installation auf ein lokales / schnelleres Laufwerk kopieren und die "Toolkit" Einstellung in Advoware entsprechend anpassen. 

V8 - Beim Login ist ein Fehler aufgetreten. Details: Der HTTP-Dienst auf https://ksw.bea-brak.de/bea/BeAPortTyp/BeAServiceV8 ist nicht verfügbar. Möglicherweise ist der Dienst ausgelastet, oder es wurde kein Endpunkt gefunden, der an der angegebenen Adresse lauscht. Stellen Sie sicher, dass die richtige Adresse angegeben ist, und versuchen Sie später erneut, auf den Dienst zuzugreifen.

• Erklärung 1: Die von beA bereitgestellte Schnittstelle wurde abgeändert. Diese wurde bei uns mit der Advoware Version 6.3.8 ebenfalls angepasst.

• Lösung 1: Bitte installieren Sie das aktuelle Update (6.3.8. und aufwärts) aus unserem Downloadbereich.

V5/6 - Es war kein an https://ksw.bea-brak.de/bea/BeAPortType/BeAServiceV5 oder /BeAServiceV6 lauschender Endpunkt vorhanden

Hierbei handelt es sich entweder um eine beA Störung. Wir können hier nichts machen und müssen warten, bis die BRAK die Störung behoben hat.

Alternativ kam es auch vor, dass die beA-Client-Security nicht auf dem aktuellen Stand war.

Der HTTP-Dienst auf https://ksw.bea-brak.de/bea... ist nicht verfügbar.

Hierbei handelt es sich eine beA Störung. Wir können hier nichts machen und müssen warten, bis die BRAK die Störung behoben hat.

Konten werden in der elektr. Kommunikation nicht angezeigt

• Erklärung: Es handelt sich um einen ungelösten Gupta Bug. Wenn das Problem vorliegt ist der gesamte Tree in elektr. Kommunikation leer, es fehlen also sowohl beA- als auch E-Mail-Konten.

• Lösung: Über die Regedit "Computer - HKEY_CURRENT_USER - Software - Gupta - SQL Windows 6.0 Application - ProfUIS - Software - Advo-ware - TreeV4 den Schlüssel "TreeV4" löschen. (Erst Advoware schließen und dann löschen!)

Schaltflächen zur eEB Abgabe / Ablehnung fehlen

• Erklärung 1: Dieses Problem tritt meistens auf Terminal Servern auf. Um die eEB Anforderung beantworten zu können muss die Datei “xjustiz_nachricht.xml“ im Nachrichtenordner vom entsprechenden Windows Benutzer gelesen werden können.

• Lösung 1: Dateiberechtigungen entsprechend anpassen.

• Erklärung 2: Ab dem 31.10.2021 gab es Änderungen bei eEB.

• Lösung 2: Update auf Advoware 6 installieren. Bereits mit Version 5 empfangene Nachrichten werden dadurch NICHT rückwirkend repariert.

Fehler beim Aufruf des beA Webservice saveMessage! Details: [com.ctc.wstx.exc.WstxLazyException] Illegal character entity: expansion character

• Erklärung: Tritt beim Versand oder Speichern eines Entwurfs auf wenn im Dateinamen oder der Beschreibung eines Anhangs ein unsichtbares, ungültiges Zeichen vorhanden ist.

• Lösung: Datei(en) vor dem Versand manuell umbenennen und / oder Beschreibungen von Hand neu eingeben.

Fehler beim Deserialisieren des Textkörpers der Antwortnachricht für Vorgang "getFolderOverview"

• Erklärung: In mindestens einem Ordner liegt eine fehlerhafte Nachricht. Zu erkennen sind diese Nachrichten innerhalb der Webanwendung an unüblichen Sonderzeichen wie z.B. □ im Betreff.

• Lösung: Nachricht(en) per Webanwendung löschen oder in einen nicht abonnierten Ordner verschieben.

Error executing createAnforderung Der Wert darf nicht NULL sein. Parametername: types

• Erklärung: In irgendeinem Textfeld (z.B. Betreff, AZ Empfänger 1, …) befindet sich ein unsichtbares Unicode Steuerzeichen. In der AdvoDotNetTools.log Logdatei zu erkennen an z.B. "Test GmbH \u001E& Co. KG  ./.  Gegner"

• Lösung: Entsprechendes Feld in Advoware vor dem Versand neu setzen und das Steuerzeichen weg lassen.

Die beA-Nachricht konnte nicht vom Server geladen werden! Details: … mac check in GCM failed

• Erklärung: In einem Ordner befindet sich eine beschädigte Nachricht.

• Lösung: In der Logdatei advodotnettools.log nach der Fehlermeldung “mac check in GCM failed” suchen und darüber die Nachrichten-Id ermitteln. Anschließend mit Hilfe der beA-Webanwendung die Nachricht an Hand der Id finden und entweder endgültig löschen oder in einen von Advoware nicht abonnierten Ordner verschieben.

• Beispiel:
  2022-08-01 09:43:42,657 DEBUG getMessage2(lMessageId=157821067)

  2022-08-01 09:44:20,701 ERROR mac check in GCM failed

Die Nachricht [1/1] konnte nicht versendet werden! Details: com.sun.xml.ws.fault.ServerSOAPFaultException: Client received SOAP Fault from server: Unmarshalling Error: Illegal character

• Erklärung: Es gibt in irgendeinem Datenfeld welches automatisch mit Daten aus der Datenbank befüllt wird ein ungültiges, unsichtbares Zeichen. Tritt meistens im Betreff oder bei der Bezeichnung eines Anhangs auf.

• Lösung: Das entsprechende Datenfeld sofern es identifiziert werden kann löschen und neu eingeben (ohne copy&paste!), ansonsten alle Datenfelder manuell neu eingeben.

• Die Logdatei advodotnettools.log kann helfen um das Datenfeld zu identifizieren. Hier nach einer Zeile mit

  DEBUG sendMessageAsync(sMySendMessagePayload=

  suchen. Ungültige, unsichtbare Zeichen werden in der darauf folgenden Zeichenkette mit

  \u****

  kodiert, Beispiel, hier “\u001F“:

  {"alias":"02_Anlage\u001F_J1","reference":"W:\\Texte2022\\2022000163\\Scan00004109_seite6-9.pdf","type":"ATTACHMENT"}

Die Nachricht [1/1] konnte nicht versendet werden! DATEINAME.pdf entspricht nicht den Anforderungen zur Teilnahme am ERV!

Erklärung: Das Problem wird durch den Namen eines Anhangs verursacht. Dies könnte ein Sonderzeichen, Leerzeichen, etc. oder sogar die Zeichenlänge sein.

Lösung: Datei umbenennen, so dass diese den Anforderungen entspricht.

Die Methode clsPostbox.__fDoGetSpecialFolder sollte niemals aufgerufen werden!

• Erklärung: Fehlerhafte Advoware Fehlermeldung. Die eigentlich Ursache ist, dass ein für den durchgeführten Vorgang (z.B. E-Mail oder beA Nachricht löschen) benötigter Ordner nicht abonniert ist.

• Lösung: Den für den Vorgang benötigten Ordner abonnieren: Papierkorb für Löschvorgänge, Entwürfe für das Speichern von Entwürfen usw.

Entwurf wurde in der Webanwendung geändert, die Änderungen fehlen aber in Advoware

• Erklärung: Die beA Schnittstelle ist nicht ausgelegt für einen Mischbetrieb KSW ↔︎ Webanwendung, vor allem im Bezug auf die Arbeit mit Entwürfen.

• Lösung: In Advoware im Kontextmenü des Postfachs auf “Alle Nachrichten erneut abrufen“ klicken, dann werden u.a. die Entwürfe neu geladen und die Änderungen welche in der Webanwendung gemach wurden sind in Advoware sichtbar.

SIGNIEREN

Fehler beim Signieren: exceptions.RemoteSignerKeysNotAvailableException: No remote signing keys found. Expected at least one.

• Erklärung: Es wurde bereits Advoware 6.3.0 oder höher installiert und die Fernsignatur ist lizensiert. Im Kartenlesegerät liegt aber eine neue beA Karte für die noch keine Fernsignatur hinterlegt wurde.

• Lösung: Der Kunde muss die Fernsignatur per BRAK / BNotK Support hinterlegen lassen.

Fehler beim Signieren: no valid licence for userid XYZ (m:online e:)

• Erklärung: Beim Versuch Signaturen mit der Advoware Fernsignaturkomponente zu erstellen wurde festgestellt, dass zwar die lizenz Fernsignatur erworben wurde, die Kundennummer wurde aber nicht an den Hersteller der Fernsignaturkomponente weiter gegeben.

• Lösung: Zur Advoware Kundennummer die entsprechende Signatur-ID generieren und an den Hersteller der Fernsignaturkomponente übermitteln.

Fehler beim Signieren: javax.net.ssl.SSLException: org.bouncycastle.tls.TlsFatalAlert: internal_error(80)

• Erklärung: Falsche PIN Eingabe bei Verwendung der Fernsignatur

• Lösung: Richtige PIN verwenden

Fehler beim Signieren Fehler secSigner: name ‘quit’ is not defined.

• Laut den Entwicklern der Fernsignaturkomponente (beA Expert) soll das Problem "name 'quit' is not defined" mit Version 1.4.4 gelöst sein. Hier wird es ein AW Update geben.

Fehler beim senden “request contains invalid”

• Falsches bzw. Sonderzeichen im Betreff.

• Falsches Sonderzeichen im Aktenzeichen des Empfängers

Es kann keine Verbindung zur Fernsignaturkomponente aufgebaut werden. (AW 6.31)

• SSL-Traffic muss freigegeben sein (Dies muss Ihr IT-Techniker vor Ort überprüfen)

• An allen Arbeitsplätzen sollte Advoware einmal geschlossen werden.

• unter %Appdata% (zurück auf local - AdvoWeb GmbH - Advoware) muss der Java Ordner löschen

• Java Ordner aus dem Update 6.31 herauskopieren und ins Advoware Verzeichnis neu einfügen

• AdvoDotnettolls kopieren und in das Programmverzeichnis (z. B. W:\Advoware) kopieren

• AW Neu starten und Signieren-Funktion probieren, es dauert manchmal ein paar Versuche, bis es klappt

Wartezeit für langsam startende Fernsignaturkomponente in der Registry vorgeben (Standard ist 5 Sekunden)(AW 6.33)

Entweder für alle Benutzer des Terminalserver auf einmal:

• Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Advo-ware\beASuiteSignerApiStartupTime

Oder gezielt für einzelne Benutzer:

• Computer\HKEY_CURRENT_USER\SOFTWARE\Advo-ware\beASuiteSignerApiStartupTime

Typ Zeichenfolge mit Wert 30000 für 30 Sekunden Wartezeit

Error in Verifying Security in the Inbound Message

• Es liegt an einer beA-Störung. Die Suche nach EGVP-Empfängern (=Gerichten) ist gestört.

Dokumentationsdateien

KSW-Rechte

Open