Wiki-Quellcode von Troubleshooting

Zeige letzte Bearbeiter
1 {{content/}}
2
3 == Formularaufruf und Absenden ==
4
5 |= |=Fehlerbeschreibung|=Problemlösung
6 | 1|Formular lässt sich nicht aufrufen|Dieses Problem kann mehrere Ursachen haben. Siehe je nach Fehlermeldung die folgenden Unterpunkte:
7 |1.1|(((
8 * Fehlermeldung: Formular derzeit nicht verfügbar
9 )))|Das Formular wurde im Zugriffsmenü noch nicht online geschaltet bzw. wieder offline geschaltet. Dies kann zum Beispiel zu Wartungszwecken erfolgt sein. Sie können das Formular im Bereich //Verfügbarkeit// des [[Zugriffsmenüs>>doc:Formcycle.UserInterface.MyForms.Access]] wieder online schalten.
10 |1.2|(((
11 * Fehlermeldung: Ressource nicht gefunden / Formular nicht gefunden
12 )))|Das Formular existiert nicht mehr. Dies tritt auf, wenn entweder das gesamte Formular oder die aufgerufene Formularversion gelöscht wurde. Überprüfen Sie, ob das Formular bzw. die Formularversion existiert. Im Bereich [[Veröffentlichen>>doc:Formcycle.UserInterface.MyForms.Publish.WebHome]] finden Sie einen aktuellen Link auf das Formular bzw. die Formularversion.
13 |1.3|(((
14 * Fehlermeldung: Ungültiger Request
15 )))|(((
16 Erfolgt bei einem ungültigen bzw. fehlerhaften Aufruf des Formulars. Überprüfen Sie den Link bzw. die Adresse, mit der Sie das Formular aufrufen. Im Bereich [[Veröffentlichen>>doc:Formcycle.UserInterface.MyForms.Publish.WebHome]] finden einen gültigen Link auf das Formular.
17
18 Im Detail sind möglich Fehlerursachen:
19
20 * Anhang innerhalb eines Formulars
21 * Formular mit inaktiver oder nicht gesetzter Formularversion wird aufgerufen
22 * Ungültiger Aufruf eines beschränkten Servlets
23 * Falsche oder fehlende Angaben beim Aufruf eines Formularservlets
24 )))
25 |1.4|(((
26 * Fehlermeldung: HTTP Status 404
27 )))|Die URL ist falsch. Um eine gültige URL zu erhalten, kann das Formular [[geöffnet>>doc:Formcycle.UserInterface.MyForms.WebHome]] werden oder im Bereich [[Veröffentlichen>>doc:Formcycle.UserInterface.MyForms.Publish.WebHome]] nachgeschaut werden.
28 |2| Formular lässt sich nicht absenden|Dieses Problem kann mehrere Ursachen haben. Siehe die Punkte 2.1 bis 2.3
29 |2.1|(((
30 * Fehlermeldung: Es ist ein unerwarteter Fehler aufgetreten / Allgemeiner Fehler
31 )))|Wird bei unspezifischen oder nicht behandelten Fehlerszenarien ausgegeben. Siehe hierzu auch Punkt 2.2 unten.
32 |2.2|(((
33 * Fehlermeldung: Bei der Verarbeitung Ihrer Formulardaten ist ein unerwarteter Fehler aufgetreten. / Senden fehlgeschlagen
34 )))|Die abgesendeten Daten konnten nicht verarbeitet werden. Meistens tritt dies auf, wenn im [[Workflow>>doc:Formcycle.Designer.Workflow.WebHome]] ein Fehler aufgetreten ist und dieser nicht behandelt werden konnte, etwa wenn eine E-Mail nicht versendet werden konnte, ein Dokument nicht erzeugt werden konnte oder ein externes Plugin eine //Exception// geworfen hat. Dieser Fehler erfordert meist eine genauere Prüfung des [[Protokolls>>doc:Formcycle.UserInterface.Protocol]] und ggf. der LOG-Dateien von {{formcycle/}}.
35 |2.3|(((
36 * Fehlermeldung: Dieses Formular wurde bereits abgesendet. / Ungültiger Doppel-POST
37 )))|Wenn Sie ein neues Formular absenden wollen, laden Sie die Seite neu bzw. klicken Sie erneut auf den Link, durch den Sie auf das Formular gelangt sind. Die Seite können Sie in den meisten Browser neu laden, indem Sie auf das Neu-Laden-Icon neben der Adresszeile (nicht geschlossener Kreis mit Pfeil) klicken oder Strg+R drücken.
38 \\Weiterhin ist es auch möglich, dass die Formularsitzung auf dem Server nicht zugeordnet werden konnte, wenn im Browser Cookies deaktiviert sind.
39 |2.4|(((
40 * Fehlermeldung: Ungültige Formulardaten
41 )))|(((
42 Nach dem Absenden der Daten wurde festgestellt, dass die abgesendeten Daten nicht gültig sind, z.B. in einem E-Mail-Feld eine ungültige Mailadresse eingegeben wurden. Im Formular kann eingestellt werden, ob die abgesendeten Daten auf dem Server separat überprüft werden soll. Normalerweise kann ein Formular nicht abgesendet werden, wenn die eingegebenen Daten ungültig sind. Es ist technisch allerdings möglich, z.B. mittels Manipulation per Javascript ungültige Formulare abzusenden. Daher ist eine serverseitige Prüfung empfehlenswert.
43
44 Wenn Sie einen [[Validator im JavaScript-Bereich überschrieben haben>>doc:Formcycle.Designer.Form.CodingPanel.Validators]], dürfen Sie nicht die Option //Prüfe serverseitig// aktivieren, da es sonst immer zu diesem Fehler kommen wird.
45
46 Falls Sie die serverseitige Überprüfung deaktivieren möchten, können Sie dies im {{designer/}} an dem entsprechenden Formularelement im [[Bereich Bedingungen>>doc:Formcycle.Designer.Form.ElementProperties.Constraints]] vornehmen.
47 )))
48 |3|Beim Aufruf des Formulars kommt nur ein drehendes Rad (Spinner)|Das Formular hat einen Fehler im Javascript. Bitte überprüfen Sie das Javascript im [[JavaScript-Bereich>>doc:Formcycle.Designer.Form.CodingPanel.ScriptTab.WebHome]] des {{designer case="gen"/}}. Zur Analyse des Fehlers ist es auch hilfreich, die Konsole des Webbrowsers zu öffnen, hier werden Fehlermeldungen angezeigt. Öffnen der Konsole in [[Chrome>>url:https://developers.google.com/web/tools/chrome-devtools/debug/console/console-ui?hl=en#opening-the-console]], [[Firefox>>url:https://developer.mozilla.org/de/docs/Tools/Web_Konsole]], [[Internet Explorer / Edge>>url:https://msdn.microsoft.com/de-de/library/gg589530%28v=vs.85%29.aspx]], [[Opera>>url:http://help.opera.com/Mac/9.62/de/devtools.html]], [[Safari>>url:https://developer.apple.com/library/mac/documentation/AppleApplications/Conceptual/Safari_Developer_Guide/GettingStarted/GettingStarted.html]].
49 |4|Es werden keine E-Mails versendet|Siehe Punkt 1 im Abschnitt zu [[E-Mail-Problemen>>doc:Main.WebHome||anchor="HE-Mail"]].
50 |5|E-Mails landen in Spam |Siehe Punkt 2 im Abschnitt zu [[E-Mail-Problemen>>doc:Main.WebHome||anchor="HE-Mail"]].
51 |6|Mit Umlauten eingegebe Daten werden bei Wiederanzeige und Statusverarbeitung fehlerhaft dargestellt.|Dies liegt meistens an der fehlenden Encoding-Einstellung des Anwendungsservers, z.B. Apache Tomcat. Siehe dazu den Abschnitt //UTF-8// der [[Tomcat Einstellungen >>doc:Formcycle.SystemSettings.TomcatSettings.WebHome]].
52
53 == Inbox ==
54
55 |= |=Problem|=Lösung
56 |1|Vorgänge können in der [[Inbox>>Formcycle.Inbox]] nicht gelöscht werden.|Vorgänge sind löschbar, wenn diese selektiert sind und ein Löschen-Icon {{ficon name="trash-alt2"/}} in der Vorgangsliste erscheint. Ist dies nicht der Fall, so ist eine Löschen in dem aktuellen Status nicht möglich. Prüfen Sie bzw. der Administrator, ob in der Statusverwaltung des Formulars die Option [[Vorgänge sind in diesem Status löschbar>>doc:Formcycle.Designer.Workflow.States.WebHome]] aktiviert ist.
57
58 == Frontend-Server ==
59
60 |= |= Fehlerbeschreibung|=Problemlösung
61 |1|Beim Aufruf des Formular kommt der Fehler //Formular nicht gefunden //oder die Seite ist einfach nur weiß.|Falls Sie einen separaten {{fserver/}} eingerichtet haben, überprüfen Sie im Bereich [[Frontendserver>>doc:Formcycle.SystemSettings.UserInterface.FrontendServer]] die Einstellungen und testen Sie die Verbindung. Zudem muss der enstprechende {{fserver/}} am Formular ausgewählt sein, diese Einstellungen finden Sie im Bereich [[Veröffentlichen>>doc:Formcycle.UserInterface.MyForms.Publish.WebHome||anchor="HBereichBereitstellung"]] des Formularübersichtsmenü.
62 |2| Es besteht keine Verbindung zum {{fserver case="dat"/}}.| Siehe den Abschnitt [[Verbindungsprobleme {{fserver/}}>>doc:Formcycle.Troubleshooting.ConnectionIssuesFrontendServer]].
63
64 == Master-Server ==
65
66 |= |= Fehlerbeschreibung|=Problemlösung
67 |1|Im Login-Bereich wird angezeigt, dass keine Datenbankverbindung besteht.|(((
68 Kontaktieren Sie Ihren Systemadminstrator des Systems. Eine Konfiguration der Datenbankanbindung durch einen Administrator mit den entsprechenden Berechtigungen ist erforderlich.
69
70 * Prüfen Sie, ob eine Netzwerkverbindungen besteht und die Datenbank verfügbar ist.
71 * Überprüfen Sie die Konfiguration der Datenbank im Bereich [[Datenbank>>doc:Formcycle.SystemSettings.UserInterface.Database]]
72 * Ist die Konfiguration bereits korrekt, reicht es manchmal aus, die Verbindung mit der Datenbank erneut herzustellen, indem Sie einfach auf //Weiter// klicken.
73 * In Einzelfällen kann es passieren, dass Formcycle neu gestartet werden muss. Überprüfen Sie hierzu auch das Logdateien von {{formcycle/}}.
74 )))
75 |2|Es wurde ein Update der Datenbank gefunden. Eine Aktualisierung der Datenbank durch einen Administrator ist zu empfehlen.|Dies tritt insbesonders auf, nachdem ein Update für {{formcycle/}} eingespielt wurde. Sie können zwar {{formcycle/}} noch verwenden, es ist aber zu empfehlen, vorher zuerst das Datenbankupdate durchzuführen, da es sonst zu Problemen kommen kann. Kontaktieren Sie hierzu Ihren Systemadministrator. Das Datenbankupdate ist im [[dazugehörigen Abschnitt>>doc:Formcycle.Installation.Update]] näher erläutert.
76
77 == Formulardesigner ==
78
79 |= |= Fehlerbeschreibung|=Problemlösung
80 |1|Das Formular kann nicht gespeichert werden. Es erscheint eine Fehlermeldung der Art {{code language="none"}}Formular konnte nicht gespeichert werden.{{/code}}|Dieses Problem tritt meist auf, wenn Sie nicht mehr am System angemeldet sind. Öffnen Sie die Startseite der Verwaltungsoberfläche von {{formcycle/}} in einem neuen Fenster oder Tab und melden Sie sich erneut mit Ihren Zugangsdaten an. Danach können Sie auch das Formular wieder speichern. Um Datenverluste zu vermeiden, empfehlen wir dennoch, das Formular regelmäßig zwischenzuspeichern.
81
82 == E-Mail ==
83
84 |= |= Fehlerbeschreibung|=Problemlösung
85 |1|Es werden keine E-Mails versendet|Überprüfen Sie, ob der Mailserver eingerichtet und aktiviert ist. Es gibt einen Systemmailserver und für jeden Mandanten kann zudem ein eigener Mailserver eingerichtet werden. Ist der Systemmailserver konfiguriert, so dient dieser als Rückfallsystem für das Versenden von E-Mails. Das Einrichten des Mailservers ist beschrieben im Abschnitt [[System-E-Mail-Server>>doc:Formcycle.SystemSettings.UserInterface.EmailServer]] und [[Mandant-E-Mail-Server>>doc:Formcycle.UserInterface.Client.Settings]]. Versuchen Sie zudem, eine Testmail zu senden, um sicherzustellen, dass der Mailserver auch korrekt eingerichtet wurde.
86 |2|E-Mails landen in Spam.|(((
87 Wenn die Mail an Sie selber versendet wird, überprüfen Sie die Spameinstellungen ihres Mailproviders. Wenn Sie eine eine automatisch generierte Mail an die Formularnutzer senden wollen, beachten Sie einige wichtige Richtlinien, um die Wahrscheinlichkeit zu verringern, dass diese im Spamordner landen.
88
89 * Vermeiden typischer Schlüsselwörter, die Spamfilter auslösen: Free, Kostenlos, Gratis, 100 %, Bestellen Sie jetzt, Kredit, Angebot
90 * Vermeiden Sie Großschreibung MEHRERER WORTE HINTEREINANDER
91 * Vermeiden von zu vielen Bildern
92 * Überprüfen Sie die Zieladressen: Einige Provider blockieren Absender, die zu häufig an nicht existierende Mailadressen gesendet haben
93 * Überprüfen Sie das HTML der E-Mail, wenn die eigenes HTML im Body der Mail eingegeben haben
94 )))
95
96 == Offline App ==
97
98 |= |= Fehlerbeschreibung|=Problemlösung
99 |1|Es kann keine Verbindung zum Server aufgebaut werden.|Überprüfen Sie, ob eine Internetverbindung besteht. Schauen Sie weiterhin in den Einstellungen, ob die Serverinformationen und Zugangsdaten korrekt eingegeben wurden.
100 |2|Vorgänge werden nicht synchronisiert.|Vorgänge können nur synchronisiert werden, wenn eine Verbindung zum Internet besteht. Stellen Sie eine Internetverbindung her und starten Sie die Offline-App erneut. Überprüfen Sie auch Ihre Anmeldedaten.
101
102 == System ==
103
104 |= |= Fehlerbeschreibung|=Problemlösung
105 |1|Anwendungsserver (Tomcat) stürzt mit der Fehlermeldung //OutOfMemory// ab.|Sie müssen den vorhandenen Arbeitsspeicher für die Java-VM erhöhen. Die notwendigen Einstellungen sind im Abschnitt Speicher des [[Bereichs Tomcat-Einstellungen>>doc:Formcycle.SystemSettings.TomcatSettings.LimitUploadSize]] beschrieben.
106 |2|Es ist nicht möglich, sich direkt nach der Erstinstallation auf einem Linux-basierten System als sadmin mit dem Standardpasswort anzumelden.|{{formcycle/}} muss bestimmte Einstellungen im Dateisystem speichern. Einige Linux-basierte Systeme legen standardmäßig kein Home-Verzeichnis für den Tomcat-Benutzer fest. Dieses kann normalerweise in der Datei {{code language="none"}}/etc/passwd{{/code}} konfiguriert werden. Nach einer Anpassung ist ein Neustart des Tomcats erforderlich.
107 |3|Hohe CPU-Last bereits beim Start der Anwendung ohne weitere Zugriffe|Ältere Java 11 Releases [[enthalten einen Fehler in der SSLEngine>>https://bugs.openjdk.org/browse/JDK-8241054]], welcher unter bestimmten Umständen beim Aufruf von URLs über SSL zu Dead Loops führen kann, welche sich in einer hohen CPU-Auslastung äußern. Dieser Fehler wurde im Java 11 Release 11.0.8 offiziell behoben. Fall Sie eine ältere Java 11 Version bis einschließlich 11.0.7 einsetzen, aktualisieren Sie bitte auf eine neuere Version.
108 |4|Auf Datenbank kann nach Update des MS SQL JDBC-Treibers nicht zugegriffen werden|Neuere Versionen des MS SQL JDBC-Treibers überprüfen, ob das vom Datenbankserver verwendete Zertifikate valide ist. Nach einem Update des Treibers kann es daher zu Fehlern beim Verbinden mit der Datenbank kommt, die im Log als {{code language="none"}}sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target{{/code}} sichtbar werden. Es muss entweder das Root-Zertifikat (und eventuell verwendete Intermediate-Zertifikate), mit dem das Zertifikat des Datenbankservers erzeugt wurde, in den Java-TrustStore importiert werden oder über Parameter an der JDBC-URL ({{code language="none"}}encrypt=true;trustServerCertificate=true{{/code}}) die Prüfung der Zertifikate ausgeschaltet werden. Weitere Informationen und Beispiele liefert die [[Microsoft Dokumentation>>https://learn.microsoft.com/en-us/sql/connect/jdbc/connecting-with-ssl-encryption?view=sql-server-ver16]]. Beim Import in den TrustStore ist zu beachten, dass die Java-Umgebung neugestartet werden muss, damit die Änderungen übernommen werden, was gegebenenfalls einen Neustart der Maschine benötigt.